Der Datentyp „datetime“

  • Artikel

Der datetime Datentyp stellt einen Zeitpunkt dar, der in der Regel als Datum und Uhrzeit des Tages ausgedrückt wird. Werte reichen von 00:00:00 (Mitternacht), 1. Januar 0001 Anno Domini (Common Era) bis 23:59:59 Uhr, 31. Dezember 9999 n. Chr. (C.E.) im gregorianischen Kalender.

Zeitwerte werden in 100-Nanosekunden-Einheiten gemessen, die als Ticks bezeichnet werden, und ein bestimmtes Datum ist die Anzahl der Ticks seit 12:00 Uhr Mitternacht, 1. Januar 0001 n. Chr. (C.E.) im gregorianischen Kalender (ausgenommen Ticks, die durch Schaltsekunden hinzugefügt würden). Der Tickwert „31241376000000000“ entspricht beispielsweise dem Datum Freitag, 01. Januar 0100, 00:00:00 (Mitternacht). Dies wird manchmal als „ein Moment in linearer Zeit“ bezeichnet.

Die datetime Datentypen und date sind gleichwertig.

Hinweis

Ein datetime-Wert in Kusto gilt immer für die UTC-Zeitzone. Wenn die Anzeige von datetime Werten in anderen Zeitzonen erforderlich ist, verwenden Sie datetime_utc_to_local() oder datetime_local_to_utc()..

datetime-Literale

Verwenden Sie eine der folgenden Syntaxoptionen, um ein datetime Literal anzugeben:

Syntax BESCHREIBUNG Beispiel
datetime(Jahr.Monat.TagStunde:Minute:Sekunde.Millisekunden) Ein Datum und eine Uhrzeit im UTC-Format. datetime(2015-12-31 23:59:59.9)
datetime(Jahr.Monat.Tag) Ein Datum im UTC-Format. datetime(2015-12-31)
datetime() Gibt die aktuelle Uhrzeit zurück.
datetime(null) Stellt den NULL-Wert dar.

Erfahren Sie mehr über Syntaxkonventionen.

Die now() Sonderfunktionen und ago()

Kusto stellt zwei spezielle Funktionen bereit, now() und ago(), damit Abfragen auf den Zeitpunkt verweisen können, zu dem die Ausführung der Abfrage gestartet wird.

Unterstützte Formate

Es gibt mehrere Formate für datetime, die als datetime()-Literale und die todatetime()-Funktion unterstützt werden.

Warnung

Es wird dringend empfohlen, nur die ISO 8601-Formate zu verwenden.

ISO 8601

Format Beispiel
%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

Format Beispiel
%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

Format Beispiel
%w, %e-%b-%r %H:%M:%s %Z Samstag, 08-Nov-14 15:05:02 GMT
%w, %e-%b-%r %H:%M:%s Samstag, 08-Nov-14 15:05:02
%w, %e-%b-%r %H:%M %Z Samstag, 08-Nov-14 15:05 GMT
%w, %e-%b-%r %H:%M Samstag, 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

Sortierbar

Format Beispiel
%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

Verwandte Inhalte