Type de données timespan

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

Le timespan type de données représente un intervalle de temps.

Les timespan types de données et time les types de données sont équivalents.

timespan littéraux

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

Syntaxe Description Exemple Durée
nd Intervalle de temps représenté par un ou plusieurs chiffres suivis de d jours. 2d 2 jours
nh Intervalle de temps représenté par un ou plusieurs chiffres suivis pendant h des heures. 1.5h 1,5 heures
nm Intervalle de temps représenté par un ou plusieurs chiffres suivis de m minutes. 30m 30 minutes
ns Intervalle de temps représenté par un ou plusieurs chiffres suivis de s secondes. 10s 10 secondes
nms Intervalle de temps représenté par un ou plusieurs chiffres suivis de ms millisecondes. 100ms 100 millisecondes
nmicrosecond Intervalle de temps représenté par un ou plusieurs chiffres suivis par microsecond. 10microsecond 10 microsecondes
ntick Intervalle de temps représenté par un ou plusieurs chiffres suivis de tick nanosecondes. 1tick 100 ns
timespan(n seconds) Intervalle de temps en secondes. timespan(15 seconds) 15 secondes
timespan(n) Intervalle de temps en jours. timespan(2) 2 jours
timespan(jours.heures:minutes:secondes millisecondes.) Intervalle de temps en jours, heures, minutes et secondes passés. timespan(0.12:34:56.7) 0d+12h+34m+56.7s
timespan(null) Représente la valeur Null.

En savoir plus sur les conventions de syntaxe.

timespan, opérateurs

Deux valeurs de type timespan peuvent être ajoutées, soustractées et divisées. La dernière opération retourne une valeur de type real représentant le nombre fractionnel de fois qu’une valeur peut correspondre à l’autre.

Exemples

L’exemple suivant calcule le nombre de secondes d’une journée de plusieurs façons :

print
    result1 = 1d / 1s,
    result2 = time(1d) / time(1s),
    result3 = 24 * 60 * time(00:01:00) / time(1s)

Cet exemple convertit le nombre de secondes dans un jour (représenté par une valeur entière) en unité d’intervalle de temps :

print 
    seconds = 86400
| extend t = seconds * 1s