Freigeben über

DateTimeZone.From

Syntax

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

About

Erstellt einen datetimezone aus dem angegebenen Wert.

  • value: Der Wert, der zum Erstellen eines datetimezone.
  • culture: (Optional) Die Kultur, die beim Transformieren des Werts verwendet werden soll (z. B. "en-US").

Werte der folgenden Typen können in einen datetimezone Wert konvertiert werden:

  • text: Gibt einen datetimezone Wert aus der Textdarstellung zurück. Einzelheiten finden Sie unter DateTimeZone.FromText.
  • date: Gibt eine datetimezone mit value als Datumskomponente, 12:00:00 AM als Zeitkomponente und dem Offset zurück, der der lokalen Zeitzone entspricht.
  • datetime: Gibt einen datetimezone mit value als Datum und Offset entsprechend der lokalen Zeitzone zurück.
  • datetimezone: Gibt zurück value.
  • time: Gibt ein datetimezone Datum mit dem Datumsäquivalent des OLE-Automatisierungsdatums 0 als Datumskomponente, value als Zeitkomponente und den Offset entsprechend der lokalen Zeitzone zurück. Das OLE-Automatisierungsdatum besteht aus einer Gleitkommazahl, deren integrale Komponente die Anzahl von Tagen vor oder nach Mitternacht, dem 30. Dezember 1899, und deren Bruchkomponente die Uhrzeit an diesem Tag dividiert durch 24 darstellt. Mitternacht, 31. Dezember 1899 wird beispielsweise durch 1,0 dargestellt; 6 A.M., 1. Januar 1900 wird durch 2.25 vertreten; Mitternacht, 29. Dezember 1899 wird durch -1,0 dargestellt; und 6 A.M., 29. Dezember 1899 wird durch -1.25 dargestellt. Der Basiswert ist Mitternacht, den 30. Dezember 1899. Der Mindestwert ist Mitternacht, den 1. Januar 0100. Der Maximalwert ist der letzte Moment vom 31. Dezember 9999.
  • number: Gibt ein datetimezone Datum zurück, das dem OLE-Automatisierungsdatum entspricht, das durch value und den Offset entsprechend der lokalen Zeitzone ausgedrückt wird.
  • null: Gibt zurück null.

Wenn value von einem anderen Typ ist, wird ein Fehler zurückgegeben.

Der Wert des Offsets, der der lokalen Zeitzone entspricht, unterscheidet sich beim lokalen Ausführen dieser Funktion im Gegensatz zur Onlineausführung. Wenn sie lokal ausgeführt wird, wird die lokale Zeitzone zurückgegeben. Wenn sie online ausgeführt wird, wird die UTC-Zeitzone (+00:00) zurückgegeben.

Beispiel 1

Konvertieren Sie die textbezogene Darstellung eines Datums, einer Uhrzeit und einer Zeitzone in einen datetimezone Wert.

Verwendung

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

Ausgabe

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

Beispiel 2

Wandeln Sie die textuelle Darstellung von Datum, Uhrzeit und Zeitzone im brasilianischen Portugiesisch in einen datetimezone Wert um.

Verwendung

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

Ausgabe

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

Beispiel 3

Wandeln Sie eine Zahl, die den 1. Januar 2025 um 12 Uhr darstellt, in einen datetimezone Wert um. Die Zeitzone im Ergebnis hängt davon ab, ob das Beispiel lokal oder online ausgeführt wird.

Verwendung

DateTimeZone.From(45658.5)

Ausgabe

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

Verwandte Inhalte

  • Last updated on