format_timespan()

Artigo
11/23/2024

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer ✅Azure Monitor✅Microsoft Sentinel

Formata um período de tempo de acordo com o formato fornecido.

Sintaxe

format_timespan(Formato de intervalo de tempo , )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
timespan	`timespan`	✔️	O valor a ser formatado.
format	`string`	✔️	O formato de saída composto por um ou mais dos elementos de formato suportados.

Elementos de formato compatíveis

Especificador de formato	Descrição	Exemplos
`d`-`dddddddd`	O número de dias inteiros no intervalo de tempo. Acolchoado com zeros, se necessário.	15.13:45:30: D -> 15, DD -> 15, DDD -> 015
`f`	Os décimos de segundo no intervalo de tempo.	15.13:45:30.6170000 -> 6, 15.13:45:30.05 -> 0
`ff`	Os centésimos de segundo no intervalo de tempo.	15.13:45:30.6170000 -> 61, 15.13:45:30.0050000 -> 00
`fff`	Os milissegundos no intervalo de tempo.	15/06/2009 13:45:30.617 -> 617, 15/06/2009 13:45:30.0005 -> 000
`ffff`	Os dez milésimos de segundo no intervalo de tempo.	15.13:45:30.6175000 -> 6175, 15.13:45:30.0000500 -> 0000
`fffff`	Os centésimos de milésimos de segundo no intervalo de tempo.	15.13:45:30.6175400 -> 61754, 15.13:45:30.000005 -> 00000
`ffffff`	Os milionésimos de segundo no intervalo de tempo.	15.13:45:30.6175420 -> 617542, 15.13:45:30.0000005 -> 000000
`fffffff`	Os dez milionésimos de segundo no intervalo de tempo.	15.13:45:30.6175425 -> 6175425, 15.13:45:30.0001150 -> 0001150
`F`	Se for diferente de zero, os décimos de segundo no intervalo de tempo.	15.13:45:30.6170000 -> 6, 15.13:45:30.0500000 -> (sem saída)
`FF`	Se for diferente de zero, os centésimos de segundo no intervalo de tempo.	15.13:45:30.6170000 -> 61, 15.13:45:30.0050000 -> (sem saída)
`FFF`	Se for diferente de zero, os milissegundos no intervalo de tempo.	15.13:45:30.6170000 -> 617, 15.13:45:30.0005000 -> (sem saída)
`FFFF`	Se for diferente de zero, os dez milésimos de segundo no intervalo de tempo.	15.13:45:30.5275000 -> 5275, 15.13:45:30.0000500 -> (sem saída)
`FFFFF`	Se diferente de zero, os centésimos de milésimos de segundo no intervalo de tempo.	15.13:45:30.6175400 -> 61754, 15.13:45:30.0000050 -> (sem saída)
`FFFFFF`	Se for diferente de zero, os milionésimos de segundo no intervalo de tempo.	15.13:45:30.6175420 -> 617542, 15.13:45:30.0000005 -> (sem saída)
`FFFFFFF`	Se diferente de zero, os dez milionésimos de segundo no intervalo de tempo.	15.13:45:30.6175425 -> 6175425, 15.13:45:30.0001150 -> 000115
`H`	A hora, usando um relógio de 24 horas de 0 a 23.	15.01:45:30 -> 1, 15.13:45:30 -> 13
`HH`	A hora, usando um relógio de 24 horas de 00 a 23.	15.01:45:30 -> 01, 15.13:45:30 -> 13
`m`	O número de minutos inteiros no intervalo de tempo que não são incluídos como parte das horas ou dias. Minutos de dígito único não têm um zero à esquerda.	15.01:09:30 -> 9, 15.13:29:30 -> 29
`mm`	O número de minutos inteiros no intervalo de tempo que não são incluídos como parte das horas ou dias. Minutos de dígito único têm um zero à esquerda.	15.01:09:30 -> 09, 15.01:45:30 -> 45
`s`	O número de segundos inteiros no intervalo de tempo que não são incluídos como parte das horas, dias ou minutos. Segundos de dígito único não têm um zero à esquerda.	15.13:45:09 -> 9
`ss`	O número de segundos inteiros no intervalo de tempo que não são incluídos como parte das horas, dias ou minutos. Segundos de dígito único têm um zero à esquerda.	15.13:45:09 -> 09

Delimitadores compatíveis

O especificador de formato pode incluir os seguintes delimitadores:

Delimitador	Comentário
`' '`	Space
`'/'`
`'-'`	Traço
`':'`
`','`
`'.'`
`'_'`
`'['`
`']'`

Devoluções

Uma cadeia de caracteres com timespan formatado conforme especificado pelo formato.

Exemplos

Executar a consulta

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]')

Saída

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

Partilhar via