DateTimeZone.From

La función DateTimeZone.From devuelve un valor de tipo datetimezone a partir del valor que se especifique.

Sintaxis

DateTimeZone.From(
    value as any,
    optional culture as nullable text
) as nullable datetimezone

Parámetros
  • value: valor a convertir a tipo datetimezone.
  • culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar.
Información adicional

Si el parámetro value toma el valor null, la función devuelve null también. Si value es un valor de tipo datetimezone, la función devuelve el mismo valor value.

Los tipos convertibles a date son los siguientes:

  • text
  • date, devolviéndose las 00:00:00 de la fecha indicada en el huso horario local
  • datetime, en cuyo caso se devuelve la fecha y hora indicada en el huso horario local
  • time, valores para los que se devuelve la hora indicada para la fecha del 30 de diciembre de 1899 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, en el huso horario local

Si se intenta convertir un valor de otro tipo, la función devuelve un error.

Ejemplos

Podemos convertir un texto conteniendo la representación de una fecha y hora a formato datetimezone con la siguiente expresión:

DateTimeZone.From("2020/07/06 08:55:30")

06/07/2020 8:55:30 +02:00

Función M DateTimeZone.From

Vemos que se ha asignado el huso horario indicado por el reloj del sistema.

En el ejemplo anterior, la fecha representada en el texto no contenía información sobre la zona horaria. Si la tuviese, se interpretaría correctamente:

DateTimeZone.From("2020/07/06 08:55:30 +3:30")

06/07/2020 8:55:30 +03:30

Función M DateTimeZone.From

Si la fecha representada en el texto no incluye ni parte correspondiente a la hora ni la correspondiente a la zona horaria, se asigna la hora 00:00:00 y el huso horario local.

DateTimeZone.From("2020/07/06")

06/07/2020 0:00:00 +02:00

Función M DateTimeZone.From

En este ejemplo, el texto contiene información sobre el día y la zona horaria, pero no sobre la hora, asignándose las 00:00:00:

DateTimeZone.From("2020/07/06 +5:00")

06/07/2020 0:00:00 +05:00

Función M DateTimeZone.From

Si el argumento es de tipo date, se asigna la hora 00:00:00 y el huso horario local:

DateTimeZone.From(#date(2020,7,6))

06/07/2020 0:00:00 +02:00

Función M DateTimeZone.From

Si el argumento es un valor numérico, se asigna el día adecuado -sabiendo que al 0 le corresponde el 30 de diciembre de 1899- y el huso horario local:

DateTimeZone.From(0)

30/12/1899 0:00:00 +01:00

Función M DateTimeZone.From

Obsérvese que este valor puede incluir parte decimal, en cuyo caso la parte entera se interpreta como número de días desde el 31 de diciembre de 1899 y la parte decimal como fracción de un día:

DateTimeZone.From(1.5)

31/12/1899 12:00:00 +01:00

Función M DateTimeZone.From
Categoría
Funciones DateTimeZone
Submitted by admin on Mon, 07/06/2020 - 08:49