O tipo de dados timespan

O timespan tipo de dados representa um intervalo de tempo.

Os timespan tipos de dados e time são equivalentes.

Literais timespan

Para especificar um timespan literal, use uma das seguintes opções de sintaxe:

Sintaxe	Descrição	Exemplo	Período de tempo
nd	Um intervalo de tempo representado por um ou mais dígitos seguido por d dias.	2d	2 dias
nh	Um intervalo de tempo representado por um ou mais dígitos seguido por h horas.	1.5h	1,5 horas
nm	Um intervalo de tempo representado por um ou mais dígitos seguido por m por minutos.	30m	30 minutos
ns	Um intervalo de tempo representado por um ou mais dígitos seguido por s segundos.	10s	10 segundos
nms	Um intervalo de tempo representado por um ou mais dígitos seguido por ms para milissegundos.	100ms	100 milissegundos
nmicrosecond	Um intervalo de tempo representado por um ou mais dígitos seguido por microsecond.	10microsecond	10 microssegundos
ntick	Um intervalo de tempo representado por um ou mais dígitos seguido por tick para indicar nanossegundos.	1tick	100 ns
timespan(nseconds)	Um intervalo de tempo em segundos.	timespan(15 seconds)	15 s
timespan(n)	Um intervalo de tempo em dias.	timespan(2)	2 dias
timespan(Dias.Horas:Minutos:Segundos.Milissegundos)	Um intervalo de tempo em dias, horas, minutos e segundos passados.	timespan(0.12:34:56.7)	0d+12h+34m+56.7s
timespan(null)	Representa o valor nulo.

Saiba mais sobre as convenções de sintaxe.

Operadores timespan

Dois valores do tipo timespan podem ser adicionados, subtraídos e divididos. A última operação retorna um valor do tipo real que representa o número fracionário de vezes que um valor pode se ajustar ao outro.

Exemplos

O exemplo a seguir calcula quantos segundos são em um dia de várias maneiras:

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

Este exemplo converte o número de segundos em um dia (representado por um valor inteiro) em uma unidade de intervalo de tempo:

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

Conteúdo relacionado

• totimespan()