Partager via


Type de données datetime

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Le datetime type de données représente un instant dans l’heure, généralement exprimé sous la forme d’une date et d’une heure de jour. Les valeurs sont comprises entre 00:00:00 (minuit), le 1er janvier 0001 Anno Domini (Ère commune) à 11:59:59:59, 31 décembre 9999 A.D. (C.E.) dans le calendrier grégorien.

Les valeurs de temps sont mesurées en 100 nanosecondes appelées graduations, et une date particulière est le nombre de graduations depuis 12:00 minuit, janvier 1er janvier 0001 A.D. (C.E.) dans le calendrier GregorianCalendar (à l’exception des cycles qui seraient ajoutés par secondes de saut). Par exemple, la valeur de graduations 31241376000000000 représente la date du vendredi 1er janvier 0100 à minuit (12:00:00). On parle parfois de « moment dans le temps linéaire ».

Les datetime types de données et date les types de données sont équivalents.

Remarque

Une valeur de datetime dans Kusto est toujours dans le fuseau horaire UTC. Si vous affichez des datetime valeurs dans d’autres fuseaux horaires, utilisez datetime_utc_to_local() ou datetime_local_to_utc().

datetime littéraux

Pour spécifier un datetime littéral, utilisez l’une des options de syntaxe suivantes :

Syntaxe Description Exemple
datetime(année.mois.jour heure: heure minute:seconde.millisecondes) Date et heure au format UTC. datetime(2015-12-31 23:59:59.9)
datetime(jour du mois d’année..) Date au format UTC. datetime(2015-12-31)
datetime() Retourne l'heure actuelle.
datetime(null) Représente la valeur Null.

En savoir plus sur les conventions de syntaxe.

ago() Fonctions now() spéciales

Kusto fournit deux fonctions spéciales, now() et ago() pour permettre aux requêtes de référencer le moment auquel la requête démarre l’exécution.

Formats pris en charge

Plusieurs formats de datetime sont pris en charge en tant que littéraux datetime() et fonction todatetime() .

Avertissement

Il est fortement recommandé d’utiliser uniquement les formats ISO 8601.

ISO 8601

Format Exemple
%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 Exemple
%w, %e %b %r %H:%M:%s %Z Sam 8 nov 14 15:05:02 GMT
%w, %e %b %r %H:%M:%s Sam 8 nov 14 15:05:02
%w, %e %b %r %H:%M Sam 8 nov 14 15:05
%w, %e %b %r %H:%M %Z Sam 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 Exemple
%w, %e-%b-%r %H:%M:%s %Z Samedi 08-Nov-14 15:05:02 GMT
%w, %e-%b-%r %H:%M:%s Samedi 08-Nov-14 15:05:02
%w, %e-%b-%r %H:%M %Z Samedi 08-Nov-14 15:05 GMT
%w, %e-%b-%r %H:%M Samedi 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

Triable

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