now()

Retourne l’heure UTC actuelle, éventuellement décalée par un intervalle de temps donné.

L’heure UTC actuelle reste la même pour toutes les utilisations de now() dans une instruction de requête unique, même s’il existe techniquement une petite différence de temps entre chaque now() exécution.

Syntax

now([ décalage ])

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
offset	timespan		Intervalle de temps à ajouter à l’heure d’horloge UTC actuelle. La valeur par défaut est 0.

Retours

Heure d’horloge UTC actuelle, plus l’heure de décalage si elle est fournie, en tant que datetime.

Exemples

Afficher l’heure actuelle

Exécuter la requête

print now()

Afficher l’heure il y a 2 jours

Exécuter la requête

print now(-2d)

Rechercher le temps écoulé à partir d’un événement donné

L’exemple suivant montre le temps écoulé depuis le début des événements de tempête.

Exécuter la requête

StormEvents
| extend Elapsed=now() - StartTime
| take 10

Obtenir la date relative à un intervalle de temps spécifique

Exécuter la requête

let T = datatable(label: string, timespanValue: timespan) [
    "minute", 60s, 
    "hour", 1h, 
    "day", 1d, 
    "year", 365d
];
T 
| extend timeAgo = now() - timespanValue

Sortie

label	timespanValue	timeAgo
year	365.00:00:00	2022-06-19T08 :22 :54.6623324Z
day	1.00:00:00	2023-06-18T08 :22 :54.6623324Z
hour	01:00:00	2023-06-19T07 :22 :54.6623324Z
minute	00:01:00	2023-06-19T08 :21 :54.6623324Z

Notes

Cette opération peut être effectuée avec la fonction ago().