Contribute in GitHub: オンラインでの編集 日時データ・タイプ
datetime (date) データ・タイプは、通常は日時で表されるインスタント・イン・タイムを表します。 値の範囲は 00:00:00 (午前 0 時)、1 月 1 日、0001 Anno Domini (Common Era) から 11:59:59 P.M。 9999 A.D (C.E。) グレゴリオ暦では
時間値は目盛りと呼ばれる 100 ナノ秒単位で測定され、特定の日付は 0001 年 1 月 1 日の午前 0 時からの目盛りの数です。 A.D (C.E。) GregorianCalendar カレンダー内 (うるう秒によって追加されるティックを除く)。 例えば、31241376000000000 という目盛り値は、0100 12:00:00 (午前 0 時) の金曜日の日付を表します。 これは「線形時の瞬間」と呼ばれることもある。
KQL の datetime 値は、常に UTC タイム・ゾーンです。 他の時間帯で datetime 値を表示することは、データ自体のプロパティーではなく、データを表示するユーザー・アプリケーションの責任です。 タイム・ゾーン値をデータの一部として保持する必要がある場合は、別の列を使用する必要があります (UTC に関連するオフセット情報を提供します)。
日時リテラル
datetime 型のリテラルの構文は datetime(value)です。以下の表に示すように、 valueにはいくつかの形式がサポートされています。
| 例 | 値 |
|---|---|
datetime(2015-12-31 23:59:59.9)datetime(2015-12-31) |
時刻は常に UTC です。 日付を省略すると、今日の時刻になります。 |
datetime(null) |
ヌル値 (null values)を参照してください。 |
now() |
現在時刻。 |
now(-timespan) |
now()-タイム・スパン |
ago(タイム・スパン) |
now()-タイム・スパン |
now() および ago() は、 datetime 値を、クサリが照会の実行を開始した時点と比較した値を示します。 これらは同じ照会内に複数回出現することがあり、それらすべてに対して単一の値が使用されます。 (言い換えれば、 now(-x) - ago(x) などの式は常にゼロの timespan 値に評価されます。)
サポート形式
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 | 11 月 8 日 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 |