datetime數據類型代表時間的瞬間,通常以日期和時間表示。
值範圍從 00:00:00(午夜)、0001 年 1 月 1 日 Anno Domini(共同時代)到 9999 年 12 月 31 日下午 11:59:59 上午 999 上午 (C.E.) 不等。
時間值是以稱為刻度的 100 奈秒單位來測量,而特定日期則是自 10001 年 1 月 1 日午夜 12:00 A.D. (C.E.) 以來的刻度數(不包括以閏秒新增的刻度)。 例如,31241376000000000刻度值代表日期,星期五,0100 年 1 月 12:00:00 午夜。 這有時稱為「線性時間中的時刻」。
datetime和date數據類型相等。
注意
datetime Kusto 中的值一律位於UTC時區。 如果需要在其他時區中顯示 datetime 值,請使用 datetime_utc_to_local() 或 datetime_local_to_utc() 。
datetime 文字
若要指定 datetime 常值,請使用下列其中一個語法選項:
| 語法 | 描述 | 範例 |
|---|---|---|
datetime(
year.month.dayhour: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 | 星期六, 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 | 8 11 月 14 日 15:05:02 |
| %e %b %r %H:%M | 8 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 |