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(
年.月.dayhour:minute:second.毫秒) |
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 | 星期六, 11 月 14 日 15:05:02 GMT |
| %w,%e %b %r %H:%M:%s | 星期六, 11 月 14 日 15:05:02 |
| %w,%e %b %r %H:%M | 星期六, 11 月 14 日 15:05 |
| %w,%e %b %r %H:%M %Z | 星期六, 11 月 14 日 15:05 GMT |
| %e %b %r %H:%M:%s %Z | 11月14日 15:05:02 GMT |
| %e %b %r %H:%M:%s | 11 月 14 日 15:05:02 |
| %e %b %r %H:%M | 11 月 14 日 15:05 |
| %e %b %r %H:%M %Z | 11月14日 15:05 GMT |
RFC 850
| 格式 | 示例 |
|---|---|
| %w, %e-%b-%r %H:%M:%s %Z | 星期六,08-Nov-14 15:05:02 GMT |
| %w, %e-%b-%r %H:%M:%s | 星期六, 08- Nov-14 15:05:02 |
| %w, %e-%b-%r %H:%M %Z | 星期六,08-Nov-14 15:05 GMT |
| %w, %e-%b-%r %H:%M | 星期六, 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 |