Partilhar via

O tipo de dados timespan

  • Artigo

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

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
nd Um intervalo de tempo representado por um ou mais dígitos seguidos por d por dias. 2d 2 dias
nh Um intervalo de tempo representado por um ou mais dígitos seguidos por h horas. 1.5h 1.5 horas
nm Um intervalo de tempo representado por um ou mais dígitos seguidos por m minutos. 30m 30 minutos
ns Um intervalo de tempo representado por um ou mais dígitos seguidos por s segundos. 10s 10 segundos
nms Um intervalo de tempo representado por um ou mais dígitos seguidos por ms milissegundos. 100ms 100 milissegundos
nmicrosecond Um intervalo de tempo representado por um ou mais dígitos seguidos por microsecond. 10microsecond 10 microssegundos
ntick Um intervalo de tempo representado por um ou mais dígitos seguidos por tick para indicar nanossegundos. 1tick 100 ns
timespan(n seconds) 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 se passou. 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 caber no outro.

Exemplos

O exemplo a seguir calcula quantos segundos há 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