Contribute in GitHub: Online bearbeiten Datentyp 'datetime'
Der Datentyp datetime (date) stellt einen Zeitpunkt dar, der normalerweise als Datum und Uhrzeit ausgedrückt wird. Gültige Werte liegen im Bereich von 00:00:00 (Mitternacht), 1. Januar 0001 Anno Domini (Allgemeine Ära) bis 11:59:59 P.M. 31. Dezember 9999 A.D. (C.E.) im gregorianischen Kalender.
Zeitwerte werden in Einheiten von 100 Nanosekunden gemessen, die als Teilstriche bezeichnet werden, und ein bestimmtes Datum ist die Anzahl der Teilstriche seit Mitternacht, 1. Januar 0001 A.D. (C.E.) im Kalender GregorianCalendar (ausgenommen Teilstriche, die in Schaltsekunden hinzugefügt werden). Beispiel: Der Wert 31241376000000000 steht für das Datum, Freitag, 01. Januar, 0100 12:00:00 Mitternacht. Dies wird manchmal als "Moment in linearer Zeit" bezeichnet.
Ein datetime -Wert in KQL liegt immer in der UTC-Zeitzone. Die Anzeige von datetime -Werten in anderen Zeitzonen liegt in der Verantwortung der Benutzeranwendung, die die Daten anzeigt, und nicht in einer Eigenschaft der Daten selbst. Wenn Zeitzonenwerte als Teil der Daten beibehalten werden müssen, sollte eine separate Spalte verwendet werden (mit Informationen zur relativen Abweichung in Bezug auf UTC).
Datums-/Zeitliterale
Literale des Typs datetime haben die Syntax datetime(Wert), wobei eine Reihe von Formaten für Wertunterstützt werden, wie in der folgenden Tabelle angegeben:
| Beispiel | Wert |
|---|---|
datetime(2015-12-31 23:59:59.9)datetime(2015-12-31) |
Zeiten werden immer in UTC angegeben. Wenn Sie das Datum weglassen, wird eine Uhrzeit angezeigt. |
datetime(null) |
Siehe Nullwerte. |
now() |
Die aktuelle Uhrzeit. |
now(-Zeitraum) |
now()-Zeitraum |
ago(Zeitraum) |
now()-Zeitraum |
now() und ago() geben einen datetime -Wert im Vergleich zu dem Zeitpunkt an, zu dem Kusto mit der Ausführung der Abfrage begonnen hat. Diese können in derselben Abfrage mehrfach vorkommen und es wird ein einzelner Wert für alle verwendet. (Mit anderen Worten, Ausdrücke wie now(-x) - ago(x) werden immer mit dem timespan -Wert null ausgewertet.)
Unterstützte Formate
Es gibt mehrere Formate für datetime , die als datetime () literale und die Funktion todatetime () unterstützt werden.
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 | 08.11.2014 15:55:55.123456Z |
| %Y-%m-%d %H: %M:%s | 08.11.2014 15:55:55 |
| %Y-%m-%d %H: %M | 08.11.2014 15:55 |
| %Y-%m-%d | 08.11.2014 |
RFC 822
| Format | Beispiel |
|---|---|
| %w, %e %b %r %H: %m:%s %Z | Sa, 8 Nov 14 15:05:02 GMT |
| %w, %e %b %r %H:%s | Sa, 8 Nov 14 15:05:02 |
| %w, %e %b %r %H: %M | Sa, 8 Nov 14 15:05 |
| %w, %e %b %r %H: %M %Z | Sa, 8 Nov 14 15:05 GMT |
| %e %b %r %H: %M:%s %Z | 8. November 14 15:05:02 GMT |
| %e %b %r %H: %M%s | 8. November 14 15:05:02 |
| %e %b %r %H: %M | 8. November 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 | 08.11.2014 15:05:25 |
| %Y-%n-%e %H: %M%s %Z | 08.11.2014 15:05:25 GMT |
| %Y-%n-%e %H: %M | 08.11.2014 15:05 |
| %Y-%n-%e %H: %M %Z | 08.11.2014 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 |