Dela via


Datatypen datetime

Gäller för: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

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

Tidsvärden mäts i 100 nanosekunder som kallas fästingar, och ett visst datum är antalet fästingar sedan 12:00 midnatt, 1 januari 0001 e.D. (C.E.) i GregorianCalendar-kalendern (exklusive fästingar som skulle läggas till med skottsekunder). Till exempel representerar ett tickvärde på 31241376000000000 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.

Not

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

datetime literaler

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 värdet null.

Läs mer om syntaxkonventioner.

Specialfunktionerna now() och ago()

Kusto innehåller två specialfunktioner, now() och ago(), för att tillåta att frågor refererar 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

Det rekommenderas starkt att endast använda 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