format_timespan()

Article
11/23/2024

S’applique à : ✅Microsoft Fabric ✅Azure Data Explorer✅Azure Monitor ✅Microsoft Sentinel

Met en forme un intervalle de temps en fonction du format fourni.

Syntaxe

format_timespan(Format timespan , )

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
timespan	`timespan`	✔️	Valeur à mettre en forme.
format	`string`	✔️	Format de sortie composé d’un ou plusieurs des éléments de format pris en charge.

Éléments de format pris en charge

Spécificateur de format	Description	Exemples
`d`-`dddddddd`	Nombre de jours entiers dans l’intervalle de temps. Rembourré avec des zéros si nécessaire.	15.13:45:30 : d -> 15, dd -> 15, ddd -> 015
`f`	Dixièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6170000 -> 6, 15.13:45:30.05 -> 0
`ff`	Centièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6170000 -> 61, 15.13:45:30.0050000 -> 00
`fff`	Millisecondes dans l’intervalle de temps.	15/6/2009 13:45:30.617 -> 617, 6/15/2009 13:45:30.0005 -> 000
`ffff`	Les dix millièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175000 -> 6175, 15.13:45:30.0000500 -> 0000
`fffff`	Cent millièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175400 -> 61754, 15.13:45:30.000005 -> 000000
`ffffff`	Les millionièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175420 -> 617542, 15.13:45:30.0000005 -> 00000000
`fffffff`	Les dix millionièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175425 -> 6175425, 15.13:45:30.0001150 -> 0001150
`F`	Si ce n’est pas zéro, les dixièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6170000 -> 6, 15.13:45:30.0500000 -> (aucune sortie)
`FF`	Si ce n’est pas zéro, les centièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6170000 -> 61, 15.13:45:30.0050000 -> (aucune sortie)
`FFF`	Si ce n’est pas zéro, les millisecondes dans l’intervalle de temps.	15.13:45:30.6170000 -> 617, 15.13:45:30.0005000 -> (aucune sortie)
`FFFF`	Si ce n’est pas zéro, les dix millièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.5275000 -> 5275, 15.13:45:30.0000500 -> (aucune sortie)
`FFFFF`	Si ce n’est pas zéro, cent millièmes de seconde dans l’intervalle de temps.	15.13:45:30.6175400 -> 61754, 15.13:45:30.0000050 -> (aucune sortie)
`FFFFFF`	Si ce n’est pas zéro, les millionièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175420 -> 617542, 15.13:45:30.0000005 -> (aucune sortie)
`FFFFFFF`	Si ce n’est pas zéro, les dix millionièmes d’une seconde dans l’intervalle de temps.	15.13:45:30.6175425 -> 6175425, 15.13:45:30.0001150 -> 000115
`H`	Heure, au format de 24 heures, de 0 à 23.	15.01:45:30 -> 1, 15.13:45:30 -> 13
`HH`	Heure, au format de 24 heures, de 00 à 23.	15.01:45:30 -> 01, 15.13:45:30 -> 13
`m`	Nombre de minutes entières de l’intervalle de temps non comptabilisées dans des jours ou des heures. Les minutes à un chiffre n’ont pas de zéro non significatif.	15.01:09:30 -> 9, 15.13:29:30 -> 29
`mm`	Nombre de minutes entières de l’intervalle de temps non comptabilisées dans des jours ou des heures. Les minutes à un chiffre ont un zéro non significatif.	15.01:09:30 -> 09, 15.01:45:30 -> 45
`s`	Nombre de secondes entières de l’intervalle de temps non comptabilisées dans des jours, des heures ou des minutes. Les secondes à un chiffre n’ont pas de zéro non significatif.	15.13:45:09 -> 9
`ss`	Nombre de secondes entières de l’intervalle de temps non comptabilisées dans des jours, des heures ou des minutes. Les secondes à un chiffre ont un zéro non significatif.	15.13:45:09 -> 09

Délimiteurs pris en charge

Le spécificateur de format peut inclure les délimiteurs suivants :

Délimiteur	Commentaire
`' '`	Space
`'/'`
`'-'`	Tiret
`':'`
`','`
`'.'`
`'_'`
`'['`
`']'`

Retours

Chaîne avec intervalle de temps mis en forme comme spécifié par format.

Exemples

Exécuter la requête

let t = time(29.09:00:05.12345);
print 
v1=format_timespan(t, 'dd.hh:mm:ss:FF'),
v2=format_timespan(t, 'ddd.h:mm:ss [fffffff]')

Sortie

v1	v2
29.09:00:05:12	029.9:00:05 [1234500]

Partager via