Partager via

DateTimeZone.From

Syntaxe

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

À propos

Crée un datetimezone à partir de la valeur donnée.

  • value: valeur utilisée pour créer un datetimezone.
  • culture: (Facultatif) Culture à utiliser lors de la transformation de la valeur (par exemple, «en-US»).

Les valeurs des types suivants peuvent être converties en une datetimezone valeur :

  • text: retourne une datetimezone valeur de la représentation textuelle. Pour plus d’informations, reportez-vous à DateTimeZone.FromText.
  • date: retourne un datetimezone avec value comme composant de date, 12:00:00 AM comme composant d’heure et décalage correspondant au fuseau horaire local.
  • datetime: retourne une datetimezone valeur avec value comme datetime et le décalage correspondant au fuseau horaire local.
  • datetimezone: renvoie value.
  • time: retourne une datetimezone comprenant la date équivalente à la date OLE Automation de 0 comme composant de date, value comme composant d’heure, et le décalage correspondant au fuseau horaire local. La date OLE Automation se compose d’un nombre à virgule flottante dont le composant intégral est le nombre de jours avant ou après minuit, le 30 décembre 1899 et dont le composant fractionnaire représente l’heure de ce jour divisé par 24. Par exemple, minuit, 31 décembre 1899 est représenté par 1,0 ; 6 A.M., 1er janvier 1900 est représenté par 2,25 ; minuit, 29 décembre 1899 est représenté par -1,0 ; et 6 A.M., 29 décembre 1899 est représenté par -1,25. La valeur de base est minuit, 30 décembre 1899. La valeur minimale est minuit, 1er janvier 0100. La valeur maximale est le dernier moment du 31 décembre 9999.
  • number: retourne une datetimezone valeur avec l’heure de date équivalente à la date OLE Automation exprimée par value et le décalage correspondant au fuseau horaire local.
  • null: renvoie null.

Si value elle est d’un autre type, une erreur est retournée.

La valeur du décalage correspondant au fuseau horaire local est différente lors de l’exécution de cette fonction localement, plutôt que de l’exécuter en ligne. Lors de l'exécution sur une machine locale, le fuseau horaire local est renvoyé. Lors de l'exécution en ligne, le fuseau horaire UTC (+00:00) est renvoyé.

Exemple 1

Convertissez la représentation textuelle d’une date, d’une heure et d’un fuseau horaire en valeur datetimezone .

Utilisation

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

Output

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

Exemple 2

Convertissez la représentation textuelle de la date, de l’heure et du fuseau horaire portugais brésiliens en valeur datetimezone .

Utilisation

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

Output

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

Exemple 3

Convertissez un nombre représentant le 1er janvier 2025 à 12 h en valeur datetimezone . Le fuseau horaire dans le résultat varie selon que l’exemple est exécuté localement ou en ligne.

Utilisation

DateTimeZone.From(45658.5)

Output

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

Contenu connexe

  • Last updated on