你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

datetime 数据类型

适用于:✅Microsoft Fabric✅Azure 数据资源管理器Azure MonitorMicrosoft✅ Sentinel

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。 这有时称为“线性时间点”。

datetimedate 数据类型是等效的。

注意

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