DateTimeZone.From

Syntax

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

O

Vytvorí a datetimezone z danej hodnoty.

  • value: Hodnota použitá na vytvorenie súboru datetimezone.
  • culture: (Voliteľné) Jazyková verzia, ktorá sa má použiť pri transformácii hodnoty (napríklad "en-US").

Hodnoty nasledujúcich typov možno skonvertovať na hodnotu datetimezone:

  • text: Vráti hodnotu z textovej reprezentácie datetimezone . Podrobnosti nájdete v DateTimeZone.FromText.
  • date: Vráti a datetimezone s value ako komponent dátumu, 12:00:00 AM ako zložku času a posun zodpovedajúci miestnemu časovému pásmu.
  • datetime: Vráti a datetimezone s dátumom value a časom a posunom zodpovedajúcim miestnemu časovému pásmu.
  • datetimezone: Vráti value.
  • time: Vráti a datetimezone s dátumovým ekvivalentom dátumu 0 automatizácie OLE ako súčasti dátumu, value ako časovej zložky a posunom zodpovedajúcim miestnemu časovému pásmu. Dátum automatizácie OLE pozostáva z čísla s pohyblivou rádovou čiarkou, ktorého integrálnou zložkou je počet dní pred alebo po polnoci 30. decembra 1899 a ktorého zlomková zložka predstavuje čas v daný deň vydelený 24. Napríklad polnoc 31. decembra 1899 je reprezentovaná 1,0; 6 ráno, 1. január 1900 je reprezentovaný 2.25; polnoc 29. decembra 1899 je reprezentovaná -1,0; a 6 ráno, 29. december 1899 je reprezentovaný -1.25. Základná hodnota je polnoc 30. decembra 1899. Minimálna hodnota je polnoc 1. januára 0100. Maximálna hodnota je posledný okamih 31. decembra 9999.
  • number: Vráti hodnotu datetimezone s ekvivalentom dátumu a času dátumu automatizácie OLE vyjadreným parametrom a posunom value zodpovedajúcim miestnemu časovému pásmu.
  • null: Vráti null.

Ak value je akéhokoľvek iného typu, vráti sa chyba.

Hodnota posunu zodpovedajúca miestnemu časovému pásmu sa líši pri lokálnom spustení tejto funkcie na rozdiel od spustenia online. Pri lokálnom spustení sa vráti miestne časové pásmo. Pri spustení online sa vráti časové pásmo UTC (+00:00).

Príklad č. 1

Konvertujte textovú reprezentáciu dátumu, času a časového pásma na hodnotu datetimezone .

používania

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

výstupu

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

Príklad č. 2

Konvertujte textovú reprezentáciu dátumu, času a časového pásma brazílskej portugalčiny na hodnotu datetimezone .

používania

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

výstupu

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

Príklad č. 3

Skonvertujte číslo predstavujúce 1. január 2025 o 12. hodine na hodnotu datetimezone . Časové pásmo vo výsledku závisí od toho, či je príklad spustený lokálne alebo online.

používania

DateTimeZone.From(45658.5)

výstupu

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