datetime 数据类型
datetime
数据类型表示某个时刻,通常以日期和当天的时间表示。
数值范围为从公历的公元 0001 年 1 月 1 日 00:00:00(午夜)到公历的公元 9999 年 12 月 31 日晚上 11:59:59。
时间值以 100 纳秒为单位(称为时钟周期)进行度量。某个特定日期是指自公历的公元 0001 年 1 月 1 日午夜 12:00 以来的时钟周期数(不包括应按闰秒添加的时钟周期)。 例如,时钟周期值 31241376000000000 表示 0100 年 1 月 1 日(星期五)午夜 12:00:00。 这有时称为“线性时间点”。
datetime
和date
数据类型是等效的。
注意
Kusto 中的 datetime
值始终在 UTC 时区中。 如果需要在其他时区中显示 datetime
值,请使用 datetime_utc_to_local() 或 datetime_local_to_utc()。
datetime
文本
若要指定 datetime
文本,请使用以下语法选项之一:
语法 | 说明 | 示例 |
---|---|---|
datetime( year. month. day hour: minute: second. milliseconds) |
UTC 格式的日期和时间。 | datetime(2015-12-31 23:59:59.9) |
datetime( 年. 月. 日) |
UTC 格式的日期。 | datetime(2015-12-31) |
datetime() |
返回当前 时间。 | |
datetime(null) |
表示 null 值。 |
详细了解语法约定。
now()
和 ago()
特殊函数
Kusto 提供两个特殊函数(now() 和 ago()),以允许查询引用查询开始执行的时间。
支持的格式
datetime
有多种格式,这些格式可以用作 datetime() 文本和 todatetime() 函数。
警告
强烈建议只使用 ISO 8601 格式。
ISO 8601
格式 | 示例 |
---|---|
%Y-%m-%dT%H:%M:%s%z | 2014-05-25T08:20:03.123456Z |
%Y-%m-%dT%H:%M:%s | 2014-05-25T08:20:03.123456 |
%Y-%m-%dT%H:%M | 2014-05-25T08:20 |
%Y-%m-%d %H:%M:%s%z | 2014-11-08 15:55:55.123456Z |
%Y-%m-%d %H:%M:%s | 2014-11-08 15:55:55 |
%Y-%m-%d %H:%M | 2014-11-08 15:55 |
%Y-%m-%d | 2014-11-08 |
RFC 822
格式 | 示例 |
---|---|
%w, %e %b %r %H:%M:%s %Z | Sat, 8 Nov 14 15:05:02 GMT |
%w, %e %b %r %H:%M:%s | Sat, 8 Nov 14 15:05:02 |
%w, %e %b %r %H:%M | Sat, 8 Nov 14 15:05 |
%w, %e %b %r %H:%M %Z | Sat, 8 Nov 14 15:05 GMT |
%e %b %r %H:%M:%s %Z | 8 Nov 14 15:05:02 GMT |
%e %b %r %H:%M:%s | 8 Nov 14 15:05:02 |
%e %b %r %H:%M | 8 Nov 14 15:05 |
%e %b %r %H:%M %Z | 8 Nov 14 15:05 GMT |
RFC 850
格式 | 示例 |
---|---|
%w, %e-%b-%r %H:%M:%s %Z | Saturday, 08-Nov-14 15:05:02 GMT |
%w, %e-%b-%r %H:%M:%s | Saturday, 08-Nov-14 15:05:02 |
%w, %e-%b-%r %H:%M %Z | Saturday, 08-Nov-14 15:05 GMT |
%w, %e-%b-%r %H:%M | Saturday, 08-Nov-14 15:05 |
%e-%b-%r %H:%M:%s %Z | 08-Nov-14 15:05:02 GMT |
%e-%b-%r %H:%M:%s | 08-Nov-14 15:05:02 |
%e-%b-%r %H:%M %Z | 08-Nov-14 15:05 GMT |
%e-%b-%r %H:%M | 08-Nov-14 15:05 |
可排序
格式 | 示例 |
---|---|
%Y-%n-%e %H:%M:%s | 2014-11-08 15:05:25 |
%Y-%n-%e %H:%M:%s %Z | 2014-11-08 15:05:25 GMT |
%Y-%n-%e %H:%M | 2014-11-08 15:05 |
%Y-%n-%e %H:%M %Z | 2014-11-08 15:05 GMT |
%Y-%n-%eT%H:%M:%s | 2014-11-08T15:05:25 |
%Y-%n-%eT%H:%M:%s %Z | 2014-11-08T15:05:25 GMT |
%Y-%n-%eT%H:%M | 2014-11-08T15:05 |
%Y-%n-%eT%H:%M %Z | 2014-11-08T15:05 GMT |