Compartir vía

DateTimeZone.From

Syntax

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

Acerca de

Crea un datetimezone a partir del valor especificado.

  • value: valor utilizado para crear un datetimezone.
  • culture: (Opcional) Referencia cultural que se va a usar al transformar el valor (por ejemplo, "en-US").

Los valores de los siguientes tipos se pueden convertir en un datetimezone valor:

  • text: devuelve un valor desde una representación datetimezone textual. Consulte DateTimeZone.FromText para obtener más información.
  • date: devuelve un datetimezone con value como componente de fecha, 12:00:00 AM como componente de hora y el desplazamiento correspondiente a la zona horaria local.
  • datetime: devuelve un datetimezone con value como fecha y hora y el desplazamiento correspondiente a la zona horaria local.
  • datetimezone: devuelve value.
  • time: devuelve un datetimezone objeto con la fecha equivalente de la fecha de automatización OLE de 0 como componente de fecha, value como componente de hora y el desplazamiento correspondiente a la zona horaria local. La fecha de automatización OLE consta de un número de punto flotante cuyo componente entero es el número de días antes o después de la medianoche, 30 de diciembre de 1899, y cuyo componente fraccionario representa la hora en ese día dividida por 24. Por ejemplo, la medianoche del 31 de diciembre de 1899 está representada por 1.0; las 6 a.m., 1 de enero de 1900, está representado por 2.25; la medianoche del 29 de diciembre de 1899 está representada por -1.0; y las 6 a.m., 29 de diciembre de 1899, está representado por -1.25. El valor base es medianoche, 30 de diciembre de 1899. El valor mínimo es medianoche, 1 de enero de 0100. El valor máximo es el último momento del 31 de diciembre de 9999.
  • number: Devuelve un datetimezone con un valor datetime equivalente a la fecha de automatización OLE expresada por value y el desplazamiento correspondiente a la zona horaria local.
  • null: devuelve null.

Si value es de cualquier otro tipo, se devuelve un error.

El valor del desplazamiento correspondiente a la zona horaria local es diferente al ejecutar esta función localmente en lugar de ejecutarla en línea. Cuando se ejecuta localmente, se devuelve la zona horaria local. Cuando se ejecuta en línea, se devuelve la zona horaria UTC (+00:00).

Ejemplo 1

Convierta la representación textual de una fecha, hora y zona horaria en un datetimezone valor.

Usage

DateTimeZone.From("2020-10-30T01:30:00-08:00")

Salida

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)

Ejemplo 2

Convierta la representación textual de la fecha, hora y zona horaria en portugués brasileño a un valor datetimezone.

Usage

DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")

Salida

#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)

Ejemplo 3

Convierta un número que represente el 1 de enero de 2025 a las 12 p. m. en un datetimezone valor. La zona horaria del resultado depende de si el ejemplo se ejecuta localmente o en línea.

Usage

DateTimeZone.From(45658.5)

Salida

#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)

Contenido relacionado

  • Last updated on