Dela via

DateTimeZone.From

Syntax

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

Om

Skapar en datetimezone från det angivna värdet.

  • value: Värdet som används för att skapa en datetimezone.
  • culture: (Valfritt) Kulturen som ska användas när värdet transformeras (till exempel "en-US").

Värden för följande typer kan konverteras till ett datetimezone värde:

  • text: Returnerar ett datetimezone värde från textrepresentationen. Mer information finns i DateTimeZone.FromText.
  • date: Returnerar en datetimezone med value som datumkomponent, 12:00:00 AM som tidskomponenten och förskjutningen som motsvarar den lokala tidszonen.
  • datetime: Returnerar ett datetimezone med value som datumtid och offset som motsvarar den lokala tidszonen.
  • datetimezone: Returnerar value.
  • time: Returnerar ett datetimezone med datummotsvarigheten för OLE Automation-datumet 0 som datumkomponent, value som tidskomponent och förskjutningen som motsvarar den lokala tidszonen. OLE Automation-datumet består av ett flyttalsnummer vars integralkomponent är antalet dagar före eller efter midnatt, den 30 december 1899, och vars delkomponent representerar tiden den dagen dividerat med 24. Till exempel representeras midnatt, den 31 december 1899 av 1.0; kl. 6.00, den 1 januari 1900 representeras av 2.25; midnatt, den 29 december 1899 representeras av -1.0; kl. 6.00 den 29 december 1899 representeras av -1.25. Basvärdet är midnatt den 30 december 1899. Det minsta värdet är midnatt den 1 januari 0100. Det maximala värdet är det sista ögonblicket den 31 december 9999.
  • number: Returnerar ett datetimezone med datum och tid som motsvarar OLE Automation-datumet uttryckt av value och förskjutningen som motsvarar den lokala tidszonen.
  • null: Returnerar null.

Om value är av någon annan typ returneras ett fel.

Värdet för förskjutningen som motsvarar den lokala tidszonen skiljer sig när du kör den här funktionen lokalt i stället för att köra den online. När den körs lokalt returneras den lokala tidszonen. När man kör online returneras UTC-tidszonen (+00:00).

Exempel 1

Konvertera textrepresentationen av ett datum, tid och tidszon till ett datetimezone värde.

Användning

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

Utdata

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

Exempel 2

Konvertera textrepresentationen av brasiliens portugisiska datum, tid och tidszon till ett datetimezone värde.

Användning

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

Utdata

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

Exempel 3

Konvertera ett tal som representerar 1 januari 2025 kl. 12.00 till ett datetimezone värde. Tidszonen i resultatet beror på om exemplet körs lokalt eller online.

Användning

DateTimeZone.From(45658.5)

Utdata

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

Relaterat innehåll

  • Last updated on