DateTimeZone.From

Syntaktika

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

Asi

Vytvoří datetimezone z dané hodnoty.

  • value: Hodnota použitá k vytvoření datetimezone.
  • culture: (Volitelné) Jazyková verze, která se má použít při transformaci hodnoty (například "en-US").

Hodnoty následujících typů lze převést na hodnotu datetimezone:

  • text: Vrátí datetimezone hodnotu z textové reprezentace. Podrobnosti najdete v DateTimeZone.FromText.
  • date: Vrátí datetimezone, kde value je komponentou datumu, 12:00:00 AM komponentou času, a kompenzací odpovídající místnímu časovému pásmu.
  • datetime: Vrátí datetimezone s value jako datetime a posunem odpovídajícím místnímu časovému pásmu.
  • datetimezone: Vrátí value.
  • time: Vrátí datetimezone s datem, které je ekvivalentem data automatizace OLE z 0 jako součásti data, value jako časovou součástí a posunem odpovídajícím místnímu časovému pásmu. Datum automatizace OLE se skládá z čísla s plovoucí desetinnou čárkou, jehož nedílnou součástí je počet dní před nebo po půlnoci, 30. prosince 1899 a jehož desetinná součást představuje čas v daném dni dělený číslem 24. Například půlnoc, 31. prosince 1899 je reprezentována 1.0; 6:00, 1. ledna 1900 je reprezentována 2.25; půlnoc, 29. prosince 1899 je reprezentována -1.0; a 6:00, 29. prosince 1899 je reprezentována -1.25. Základní hodnota je půlnoc 30. prosince 1899. Minimální hodnota je půlnoc, 1. ledna 0100. Maximální hodnota je poslední okamžik 31. prosince 9999.
  • number: Vrátí datetimezone hodnotu s ekvivalentním datem a časem datem automatizace OLE vyjádřeným value a posunem odpovídajícím místnímu časovému pásmu.
  • null: Vrátí null.

Pokud je value jiného typu, vrátí se chyba.

Hodnota posunu odpovídající místnímu časovému pásmu se liší při místním spuštění této funkce oproti spuštění online. Při místním spuštění se vrátí místní časové pásmo. Při spuštění online se vrátí časové pásmo UTC (+00:00).

Příklad 1

Převede textové vyjádření data, času a časového pásma na datetimezone hodnotu.

Použití

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

Výstup

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

Příklad 2

Převede textovou reprezentaci brazilského portugalského data, času a časového pásma na datetimezone hodnotu.

Použití

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

Výstup

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

Příklad 3

Převede číslo představující 1. ledna 2025 v 12:00 na datetimezone hodnotu. Časové pásmo ve výsledku závisí na tom, jestli je příklad spuštěn místně nebo online.

Použití

DateTimeZone.From(45658.5)

Výstup

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

Související obsah

  • Last updated on