La función Time.From devuelve un valor de tipo time a partir del valor especificado.
Time.From(
value as any,
optional culture as nullable text
) as nullable time
- value: valor a convertir a tipo time.
- culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar.
Si el parámetro value toma el valor null, la función devuelve null también. Si value es un valor de tipo time, la función devuelve el mismo valor value.
Los tipos convertibles a date son los siguientes:
- text
- datetime, en cuyo caso se devuelve el componente correspondiente a la hora
- datetimezone, devolviéndose el equivalente de la hora indicada en el huso horario local
- number, cuya parte entera se interpreta como el número de días a partir del 30 de diciembre de 1899 y cuya parte decimal se interpreta como fracción de un día. Este valor deberá ser mayor o igual a 0 y menor que 1, implicando que el día referido será el representado por el valor 0 (30 de diciembre de 1899).
Si se intenta convertir un valor de otro tipo, la función devuelve un error.
Si partimos de la cadena de texto "23:59:30", podemos convertirla a formato time con la siguiente expresión:
Time.From("23:59:30")
23:59:30
También podemos convertir un número real en un valor temporal de tipo time, por ejemplo:
Time.From(0.75)
18:00:00
Si partimos del valor de tipo datetimezone correspondiente a las 14:30:00 UTC+3 del 19 de julio de 2020, obtenemos el componente de la hora (14:30:00) transformado al huso horario local (UTC+2):
Time.From(
#datetimezone(2020,7,19,14,30,0,3,0)
)
13:30:00
