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

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

以下所有示例基于 TDengine 3.1.0.3

TDengine函数大全

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

时间和日期函数

- TDengine函数大全
- - - NOW
    - TIMEDIFF
    - TIMETRUNCATE
    - TIMEZONE
    - TODAY

NOW

sql 复制代码

NOW()

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

返回结果数据类型：TIMESTAMP。

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

适用于：表和超级表。

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

使用说明：

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

示例:

sql 复制代码

> 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

sql 复制代码

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。

示例:

sql 复制代码

> 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

sql 复制代码

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 。

示例:

sql 复制代码

> 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

sql 复制代码

TIMEZONE()

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

返回结果数据类型：VARCHAR。

应用字段：无

适用于：表和超级表。

示例:

sql 复制代码

> 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

sql 复制代码

TODAY()

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

返回结果数据类型：TIMESTAMP。

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

适用于：表和超级表。

使用说明：

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

示例:

sql 复制代码

> 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 |