O tipo de dados de intervalo de tempo

O timespan tipo de dados representa um intervalo de tempo.

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

timespan literais

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

Syntax	Descrição	Exemplo	Duração do 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 de h durante horas.	1.5h	1,5 horas
nm	Um intervalo de tempo representado por um ou mais dígitos seguido de m durante 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 de ms milissegundos.	100ms	100 milissegundos
nmicrosecond	Um intervalo de tempo representado por um ou mais dígitos seguido de 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 segundos
timespan(n)	Um intervalo de tempo em dias.	timespan(2)	2 dias
timespan(dias.horas:minutos:segundos.milissegundos)	Passou um intervalo de tempo em dias, horas, minutos e segundos.	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.

timespan operadores

Podem ser adicionados dois valores do tipo timespan , subtraídos e divididos. A última operação devolve um valor do tipo real que representa o número fracionário de vezes que um valor pode caber no outro.

Exemplos

O exemplo seguinte calcula quantos segundos existem num dia de várias formas:

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 num dia (representado por um valor inteiro) numa unidade de intervalo de tempo:

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

Conteúdo relacionado

• totimespan()