Type de données de date et d'heure
Le type de données datetime (date) représente un instant dans le temps, généralement exprimé sous la forme d'une date et d'une heure du jour. Les valeurs sont comprises entre 00:00:00 (minuit), le 1er janvier 0001 Anno Domini (ère commune) et 11:59:59 P.M., 31 décembre 9999 A.D. (C.E.) dans le calendrier grégorien.
Les valeurs temporelles sont mesurées en unités de 100 nanosecondes appelées graduations (ticks), et une date particulière correspond au nombre de graduations depuis minuit, le 1er janvier 0001 A.D. (C.E.) dans le calendrier GregorianCalendar (à l'exclusion des graduations qui seraient ajoutées par des secondes intercalaires). Par exemple, une valeur de graduations de 31241376000000000 représente la date, le vendredi, le 01 janvier, 0100 12:00:00 minuit. Cela est parfois appelé "un moment dans le temps linéaire".
Une valeur datetime dans KQL est toujours dans le fuseau horaire UTC. L'affichage des valeurs datetime dans d'autres fuseaux horaires relève de la responsabilité de l'application utilisateur qui affiche les données, et non d'une propriété des données elle-même. Si les valeurs de fuseau horaire doivent être conservées dans le cadre des données, il convient d'utiliser des colonnes distinctes (fournissant des informations de décalage par rapport au temps universel coordonné).
littéraux date-heure
Les littéraux de type datetime ont la syntaxe datetime(valeur), où un certain nombre de formats sont pris en charge pour valeur, comme indiqué dans le tableau suivant:
| Exemple | Valeur |
|---|---|
datetime(2015-12-31 23:59:59.9)datetime(2015-12-31) |
Les heures sont toujours en temps universel coordonné. L'omission de la date donne une heure aujourd'hui. |
datetime(null) |
Voir valeurs nulles. |
now() |
Heure actuelle. |
now(-intervalle de temps) |
now()-intervalle de temps |
ago(intervalle de temps) |
now()-intervalle de temps |
now() et ago() indiquent une valeur datetime comparée au moment où Kusto a commencé à exécuter la requête. Elles peuvent apparaître plusieurs fois dans la même requête et une seule valeur sera utilisée pour toutes les requêtes. (En d'autres termes, les expressions telles que now(-x) - ago(x) ont toujours pour résultat une valeur timespan de zéro.)
formats pris en charge
Il existe plusieurs formats pour datetime qui sont pris en charge en tant que littéraux datetime () et la fonction todatetime () .
Il est fortement recommandé de n'utiliser que 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 | 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 | 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 | 08-11-2014 15:05:25 |
| %Y-%n-%e %H: %M:%s %Z | 2014-11-08 15:05:25 GMT |
| %Y-%n-%e %H: %M | 08-11-2014 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 |