TDengine函数大全-时间和日期函数

以下内容来自 TDengine 官方文档 及
GitHub 内容 。

以下所有示例基于 TDengine 3.1.0.3

TDengine函数大全

1.数学函数
2.字符串函数
3.转换函数
4.时间和日期函数
5.聚合函数
6.选择函数
7.时序数据库特有函数
8.系统函数

NOW

NOW()

功能说明：返回客户端当前系统时间。

返回结果数据类型：TIMESTAMP。

应用字段：在 WHERE 或 INSERT 语句中使用时只能作用于 TIMESTAMP 类型的字段。

适用于：表和超级表。

嵌套子查询支持：适用于内层查询和外层查询。

使用说明：

• 支持时间加减操作，如 NOW() + 1s, 支持的时间单位如下：
  b(纳秒)、u(微秒)、a(毫秒)、s(秒)、m(分)、h(小时)、d(天)、w(周)。
• 返回的时间戳精度与当前 DATABASE 设置的时间精度一致。

示例:

> create table t4 (ts timestamp, v1 int);
> insert into t4 values(now,1);
> insert into t4 values(now,2);
> insert into t4 values(now,3);> select * from t4;ts            |     v1      |
========================================2023-08-31 09:27:36.033 |           1 |2023-08-31 09:27:38.275 |           2 |2023-08-31 09:27:40.270 |           3 |> select * from t4 where ts>now-60s;ts            |     v1      |
========================================2023-08-31 09:27:36.033 |           1 |2023-08-31 09:27:38.275 |           2 |2023-08-31 09:27:40.270 |           3 |

TIMEDIFF

TIMEDIFF(expr1, expr2 [, time_unit])

功能说明：计算两个时间戳之间的差值，并近似到时间单位 time_unit 指定的精度。

返回结果数据类型：BIGINT。

应用字段：表示 UNIX 时间戳的 BIGINT, TIMESTAMP 类型，或符合日期时间格式的 VARCHAR, NCHAR 类型。

适用于：表和超级表。

嵌套子查询支持：适用于内层查询和外层查询。

使用说明：

• 支持的时间单位 time_unit 如下(时间精度不能小于 DATABASE 时间精度)：
  1b(纳秒), 1u(微秒)，1a(毫秒)，1s(秒)，1m(分)，1h(小时)，1d(天), 1w(周)。
• 如果时间单位 time_unit 未指定， 返回的时间差值精度与当前 DATABASE 设置的时间精度一致。
• 输入包含不符合时间日期格式的字符串则返回 NULL。

示例:

> create table t5 (ts1 timestamp,ts2 timestamp);
> insert into t5 values(now,now-1s);
> insert into t5 values(now,now-2s);
> insert into t5 values(now,now-3s);taos> select * from t5;ts1           |           ts2           |
====================================================2023-08-31 09:32:54.649 | 2023-08-31 09:32:53.649 |2023-08-31 09:32:57.637 | 2023-08-31 09:32:55.637 |2023-08-31 09:32:59.935 | 2023-08-31 09:32:56.935 |> select timediff(ts1,ts2) from t5;timediff(ts1,ts2)   |
========================1000 |2000 |3000 |> select timediff(ts1,ts2,1s) from t5;timediff(ts1,ts2,1s)  |
========================1 |2 |3 |> select timediff(ts1,ts2,1m) from t5;timediff(ts1,ts2,1m)  |
========================0 |0 |0 |> select timediff(ts1,ts2,1u) from t5;DB error: TIMEDIFF function time unit parameter should be greater than db precision (0.000294s)

TIMETRUNCATE

TIMETRUNCATE(expr, time_unit [, ignore_timezone])ignore_timezone: {0| 1
}

功能说明：将时间戳按照指定时间单位 time_unit 进行截断。

返回结果数据类型：TIMESTAMP。

应用字段：表示 UNIX 时间戳的 BIGINT, TIMESTAMP 类型，或符合日期时间格式的 VARCHAR, NCHAR 类型。

适用于：表和超级表。

使用说明：

• 支持的时间单位 time_unit 如下：
  1b(纳秒), 1u(微秒)，1a(毫秒)，1s(秒)，1m(分)，1h(小时)，1d(天), 1w(周)。
• 返回的时间戳精度与当前 DATABASE 设置的时间精度一致。
• 输入包含不符合时间日期格式的字符串则返回 NULL。
• 当使用 1d 作为时间单位对时间戳进行截断时， 可通过设置 ignore_timezone 参数指定返回结果的显示是否忽略客户端时区的影响。
  例如客户端所配置时区为 UTC+0800, 则 TIMETRUNCATE(‘2020-01-01 23:00:00’, 1d, 0) 返回结果为 ‘2020-01-01 08:00:00’。
  而使用 TIMETRUNCATE(‘2020-01-01 23:00:00’, 1d, 1) 设置忽略时区时，返回结果为 ‘2020-01-01 00:00:00’
  ignore_timezone 如果忽略的话，则默认值为 1 。

示例:

> select ts1 from t5;ts1           |
==========================2023-08-31 09:32:54.649 |2023-08-31 09:32:57.637 |2023-08-31 09:32:59.935 |> select timetruncate(ts1,1s) from t5;timetruncate(ts1,1s)   |
==========================2023-08-31 09:32:54.000 |2023-08-31 09:32:57.000 |2023-08-31 09:32:59.000 |> select timetruncate(ts1,1m) from t5;timetruncate(ts1,1m)   |
==========================2023-08-31 09:32:00.000 |2023-08-31 09:32:00.000 |2023-08-31 09:32:00.000 |> select timetruncate(ts1,1h) from t5;timetruncate(ts1,1h)   |
==========================2023-08-31 09:00:00.000 |2023-08-31 09:00:00.000 |2023-08-31 09:00:00.000 |> select timetruncate(ts1,1d) from t5;timetruncate(ts1,1d)   |
==========================2023-08-31 00:00:00.000 |2023-08-31 00:00:00.000 |2023-08-31 00:00:00.000 |> select timetruncate(ts1,1d,0) from t5;timetruncate(ts1,1d,0)  |
==========================2023-08-31 08:00:00.000 |2023-08-31 08:00:00.000 |2023-08-31 08:00:00.000 |> select timetruncate(ts1,1d,1) from t5;timetruncate(ts1,1d,1)  |
==========================2023-08-31 00:00:00.000 |2023-08-31 00:00:00.000 |2023-08-31 00:00:00.000 |> select timetruncate('2023-01-01T12:01:00+09:00',1h,1) from t5;timetruncate('2023-01-01T12:01:00+09:00',1h,1) |
=================================================2023-01-01 11:00:00.000 |2023-01-01 11:00:00.000 |2023-01-01 11:00:00.000 |> select timetruncate('2023-01-01T12:01:00+09:00',1h,0) from t5;timetruncate('2023-01-01T12:01:00+09:00',1h,0) |
=================================================2023-01-01 11:00:00.000 |2023-01-01 11:00:00.000 |2023-01-01 11:00:00.000 |

TIMEZONE

TIMEZONE()

功能说明：返回客户端当前时区信息。

返回结果数据类型：VARCHAR。

应用字段：无

适用于：表和超级表。

示例:

> show variables;name               |                  value                   |  scope   |
=========================================================================================statusInterval                   | 1                                        | server   |timezone                         | Asia/Shanghai (CST, +0800)               | both     |locale                           | en_US.UTF-8                              | both     |charset                          | UTF-8                                    | both     |> select timezone() from t5 limit 1;timezone()                |
===========================================Asia/Shanghai (CST, +0800)               |

TODAY

TODAY()

功能说明：返回客户端当日零时的系统时间。

返回结果数据类型：TIMESTAMP。

应用字段：在 WHERE 或 INSERT 语句中使用时只能作用于 TIMESTAMP 类型的字段。

适用于：表和超级表。

使用说明：

• 支持时间加减操作，如 TODAY() + 1s, 支持的时间单位如下：
  b(纳秒)，u(微秒)，a(毫秒)，s(秒)，m(分)，h(小时)，d(天)，w(周)。
• 返回的时间戳精度与当前 DATABASE 设置的时间精度一致。

示例:

> select today() from t5 limit 1;today()         |
==========================2023-08-31 00:00:00.000 |> select today()+1h from t5 limit 1;today()+1h        |
==========================2023-08-31 01:00:00.000 |> select today(),now from t5 limit 1;today()         |           now           |
====================================================2023-08-31 00:00:00.000 | 2023-08-31 09:44:40.058 |