Datatypen datetime

Datatypen datetime representerar ett ögonblick i tiden, vanligtvis uttryckt som datum och tid på dagen. Värdena sträcker sig från 00:00:00 (midnatt), 1 januari 0001 Anno Domini (Common Era) till 23:59,59, 31 december 9999 e.Kr. (C.E.) i den gregorianska kalendern.

Tidsvärden mäts i enheter med 100 nanosekunder som kallas tick, och ett visst datum är antalet tick sedan 12:00 midnatt, 1 januari 0001 e.Kr. (C.E.) i GregorianCalendar-kalendern (exklusive fästingar som skulle läggas till med skottsekunder). Ett tickvärde för 31241376000000000 representerar till exempel datumet, fredagen den 1 januari 0100 12:00:00 midnatt. Detta kallas ibland "ett ögonblick i linjär tid".

Datatyperna datetime och date är likvärdiga.

Anteckning

Ett datetime värde i Kusto finns alltid i UTC-tidszonen. Om du datetime behöver visa värden i andra tidszoner använder du datetime_utc_to_local() eller datetime_local_to_utc().

datetime Litteraler

Om du vill ange en datetime literal använder du något av följande syntaxalternativ:

Syntax Beskrivning Exempel
datetime(År.Månad.dagtimme:minut:andra.millisekunder) Ett datum och en tid i UTC-format. datetime(2015-12-31 23:59:59.9)
datetime(År.Månad.Dag) Ett datum i UTC-format. datetime(2015-12-31)
datetime() Returnerar aktuell tid.
datetime(null) Representerar null-värdet.

Läs mer om syntaxkonventioner.

Funktionerna och ago() specialfunktionerna now()

Kusto tillhandahåller två specialfunktioner, now() och ago(), för att tillåta frågor att referera till tidpunkten då frågan startar körningen.

Format som stöds

Det finns flera format för datetime som stöds som datetime() literaler och funktionen todatetime().

Varning

Vi rekommenderar starkt att du endast använder ISO 8601-format.

ISO 8601

Format Exempel
%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 Exempel
%w, %e %b %r %H:%M:%s %Z lör, 8 nov 14 15:05:02 GMT
%w, %e %b %r %H:%M:%s lör, 8 nov 14 15:05:02
%w, %e %b %r %H:%M lör, 8 nov 14 15:05
%w, %e %b %r %H:%M %Z lör, 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 Exempel
%w, %e-%b-%r %H:%M:%s %Z Lördag, 08-Nov-14 15:05:02 GMT
%w, %e-%b-%r %H:%M:%s Lördag, 08-Nov-14 15:05:02
%w, %e-%b-%r %H:%M %Z Lördag, 08-Nov-14 15:05 GMT
%w, %e-%b-%r %H:%M Lördag, 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

Sorterbar

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