Freigeben über


Der Datentyp „datetime“

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Der datetime Datentyp stellt eine sofortige Zeit dar, die in der Regel als Datum und Uhrzeit des Tages ausgedrückt wird. Die Werte reichen von 00:00:00 (Mitternacht), 1. Januar 0001 Anno Domini (Gemeinsame Ära) bis 11:59:59 Uhr, 31. Dezember 9999 A.D. (C.E.) im gregorianischen Kalender.

Zeitwerte werden in 100-Nanosekundeneinheiten gemessen, die als Teilstriche bezeichnet werden, und ein bestimmtes Datum ist die Anzahl der Teilstriche seit 12:00 Mitternacht, dem 1. Januar 0001 A.D. (C.E.) im GregorianCalendar-Kalender (mit Ausnahme von Teilstrichen, 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 Datentypen 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 zum Angeben eines datetime Literals eine der folgenden Syntaxoptionen:

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

Erfahren Sie mehr über Syntaxkonventionen.

Die now() und ago() spezielle Funktionen

Kusto stellt zwei spezielle Funktionen bereit, jetzt() und ago(), um Abfragen den Verweis auf den Zeitpunkt zu ermöglichen, zu dem die Abfrage die Ausführung startet.

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