DateTimeZone.From

Szintaxis

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

Rólunk

Létrehoz egy értéket datetimezone a megadott értékből.

  • value: Az érték, amelyet egy datetimezone létrehozásához használnak.
  • culture: (Nem kötelező) Az érték átalakításakor használni kívánt kultúra (például "en-US").

Az alábbi típusok értékei datetimezone értékké alakíthatók:

  • text: Szöveges ábrázolásból származó értéket ad datetimezone vissza. Részletekért tekintse meg a DateTimeZone.FromText.
  • date: Visszaad egy datetimezone-t, ahol a dátum összetevő value, az idő összetevő 12:00:00 AM, és az eltolás a helyi időzónához igazodik.
  • datetime: Visszaad egy datetimezone-t a dátum/idő értékkel value-ként, a helyi időzónának megfelelő eltolással.
  • datetimezone: Visszaadja value.
  • time: Visszaad egy datetimezone-t, amely 0-nak/nak az OLE Automation dátumértékének megfelelő dátumot tartalmazza dátumösszetevőként, value-t mint időösszetevőt, és a helyi időzónának megfelelő időzóna-eltérést. Az OLE Automation Date egy lebegőpontos számból áll, amelynek egész része az 1899. december 30-i éjfél előtti vagy utáni napok számát jelenti, törtrésze pedig az adott napon belüli időt jelzi, 24-gyel osztva. Az 1899. december 31-i éjfélt például 1,0 jelöli; 1900. január 1-jén reggel 6 órát 2,25 jelöli; 1899. december 29-i éjfélt -1,0 jelöli; és 1899. december 29-én reggel 6 órát -1,25 jelöli. Az alapérték 1899. december 30., éjfél. A minimális érték 0100. január 1-je éjfélkor. A maximális érték a 9999. december 31-i utolsó pillanat.
  • number: Egy olyan értéket ad datetimezone vissza, amely az OLE Automation-dátum dátum/idő egyenértékével van kifejezve value és a helyi időzónának megfelelő eltolással.
  • null: Visszaadja null.

Ha value bármilyen más típusú, hibaüzenet jelenik meg.

A helyi időzónának megfelelő eltolás értéke eltérő, ha ezt a függvényt helyileg futtatja, és nem online futtatja. Helyi futtatás esetén a rendszer a helyi időzónát adja vissza. Online futtatás esetén az UTC időzóna (+00:00) lesz visszaadva.

1. példa

Dátum, idő és időzóna szöveges ábrázolásának konvertálása értékké datetimezone .

Használat

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

kimeneti

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

2. példa

A brazil portugál nyelvű dátum, idő és időzóna szöveges ábrázolását datetimezone értékké konvertálja.

Használat

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

kimeneti

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

3. példa

2025. január 1-jét 12:00 órakor ábrázoló számot konvertálja datetimezone formátumú értékké. Az eredmény időzónája attól függ, hogy a példa helyileg vagy online fut-e.

Használat

DateTimeZone.From(45658.5)

kimeneti

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