Condividi tramite


DateTimeZone.From

Sintassi

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

Informazioni su

Crea un oggetto datetimezone dal valore specificato.

  • value: valore utilizzato per creare un oggetto datetimezone.
  • culture: (Facoltativo) La cultura da utilizzare per trasformare il valore (ad esempio, "en-US").

I valori dei tipi seguenti possono essere convertiti in un valore datetimezone:

  • text: restituisce un datetimezone valore dalla rappresentazione testuale. Per informazioni dettagliate, vedere DateTimeZone.FromText.
  • date: restituisce un datetimezone oggetto con value come componente di data, 12:00:00 AM come componente dell'ora e l'offset corrispondente al fuso orario locale.
  • datetime: restituisce un datetimezone oggetto con value come datetime e l'offset corrispondente al fuso orario locale.
  • datetimezone: restituisce value.
  • time: restituisce un datetimezone oggetto con l'equivalente della data di automazione OLE di 0 come componente data, value come componente ora e l'offset corrispondente al fuso orario locale. La data di automazione OLE è costituita da un numero a virgola mobile il cui componente integrale è il numero di giorni precedenti o successivi alla mezzanotte del 30 dicembre 1899 e il cui componente frazionaria rappresenta l'ora del giorno diviso per 24. Ad esempio, mezzanotte, 31 dicembre 1899 è rappresentato da 1,0; Il 1° gennaio 1900 è rappresentato dal 2,25; mezzanotte, 29 dicembre 1899 è rappresentato da -1,0; e 6 A.M., 29 dicembre 1899 è rappresentato da -1,25. Il valore di base è mezzanotte, 30 dicembre 1899. Il valore minimo è mezzanotte, 1 gennaio 0100. Il valore massimo è l'ultimo momento del 31 dicembre 9999.
  • number: Restituisce un datetimezone con un valore datetime equivalente alla data di automazione OLE espressa da value e l'offset corrispondente al fuso orario locale.
  • null: restituisce null.

Se value è di un altro tipo, viene restituito un errore.

Il valore dell'offset corrispondente al fuso orario locale è diverso quando si esegue questa funzione localmente anziché eseguirla online. Quando viene eseguito in locale, viene restituito il fuso orario locale. Quando viene eseguito online, viene restituito il fuso orario UTC (+00:00).

Esempio 1

Convertire la rappresentazione testuale di una data, un'ora e un fuso orario in un datetimezone valore.

Utilizzo

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

Output

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

Esempio 2

Convertire la rappresentazione testuale della data, dell'ora e del fuso orario in portoghese brasiliano in un valore datetimezone.

Utilizzo

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

Output

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

Esempio 3

Convertire un numero che rappresenta il 1° gennaio 2025 alle 12.00 in un datetimezone valore. Il fuso orario nel risultato dipende dal fatto che l'esempio venga eseguito in locale o online.

Utilizzo

DateTimeZone.From(45658.5)

Output

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