Compartir a través de

Tipo de datos timespan

Applies to: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

El timespan tipo de datos representa un intervalo de tiempo.

Los tipos de timespan datos y time son equivalentes.

Literales timespan

Para especificar un timespan literal, use una de las siguientes opciones de sintaxis:

Syntax Description Example Período de tiempo
nd Intervalo de tiempo representado por uno o varios dígitos seguidos por d días. 2d 2 days
nh Intervalo de tiempo representado por uno o más dígitos seguidos por h horas. 1.5h 1.5 hours
nm Intervalo de tiempo representado por uno o varios dígitos seguidos de m minutos. 30m 30 minutes
ns Intervalo de tiempo representado por uno o varios dígitos seguidos por s segundos. 10s 10 seconds
nms Intervalo de tiempo representado por uno o varios dígitos seguidos de ms milisegundos. 100ms 100 milliseconds
nmicrosecond Intervalo de tiempo representado por uno o varios dígitos seguidos de microsecond. 10microsecond 10 microseconds
ntick Intervalo de tiempo representado por uno o varios dígitos seguidos de tick para indicar nanosegundos. 1tick 100 ns
timespan( nseconds) Intervalo de tiempo en segundos. timespan(15 seconds) 15 seconds
timespan( n) Intervalo de tiempo en días. timespan(2) 2 days
timespan( days.hours:minutes:seconds.milliseconds) Intervalo de tiempo en días, horas, minutos y segundos pasados. timespan(0.12:34:56.7) 0d+12h+34m+56.7s
timespan(null) Represents the null value.

Note

La semana no es un período de tiempo admitido. For example, using nw is not supported.

Learn more about syntax conventions.

timespan Operadores

Se pueden agregar, restar y dividir dos valores de tipo timespan . La última operación devuelve un valor de tipo real que representa el número fraccionario de veces que un valor puede ajustarse al otro.

Examples

En el ejemplo siguiente se calcula cuántos segundos hay en un día de varias maneras:

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

En este ejemplo se convierte el número de segundos de un día (representado por un valor entero) en una unidad de intervalo de tiempo:

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

Related content