La función Duration.From devuelve un valor de tipo duration a partir del valor especificado.
Duration.From(
value as any
) as nullable duration
- value: valor a convertir a tipo duration
Si el parámetro value toma el valor null, la función devuelve null también. Si value es un valor de tipo duration, la función devuelve el mismo valor value.
Los tipos convertibles a duration son los siguientes:
- texto, que deberá tener el formato d.h:m:s (siendo d el número de días, h el número de horas, m el número de minutos y s el número de segundos)
- número, en cuyo caso la parte entera se interpreta como el número de días y la parte decimal como fracción de un día
La función generará un error cuando no se cumplan estas condiciones:
- 0 ≤ hora ≤ 23
- 0 ≤ minuto ≤ 59
- 0 ≤ segundo ≤ 59
Obsérvese que el componente correspondiente al número de días puede tomar un valor negativo.
El componente correspondiente al número de segundos puede tener parte decimal.
Es posible convertir la cadena de texto "2.3:30:45" (representando 2 días, 23 horas, 30 minutos y 45 segundos) a formato duration con el siguiente código:
Duration.From(
"2.23:30:45"
)
2.23:30:45
Si convertimos el número 1.5 al tipo duration, el resultado es un período de 1 día y 12 horas:
Duration.From(1.5)
1.12:00:00
