語法
DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone
關於
從給定值建立datetimezone。
-
value：用於創建datetimezone的值。 -
culture： （選擇性） 轉換值時要使用的文化特性 （例如，“en-US”）。
下列類型的值可以轉換為 datetimezone 值：
-
text：從文字表示中傳回值datetimezone。 如需詳細資訊，請參閱 DateTimeZone.FromText。 -
date：傳回含有以datetimezone作為日期元件的value，以12:00:00 AM作為時間元件，以及符合當地時區的偏移。 -
datetime：傳回一個包含datetimezonevalue作為日期時間的物件，並具有符合當地時區的偏移量。 -
datetimezone：傳回value。 -
time：傳回一個datetimezone，其日期元件對應於 OLE Automation Date 的日期，0作為時間元件，以及與當地時區相符的位移。 OLE 自動化日期由浮點數組成，其整數分量是 1899 年 12 月 30 日午夜之前或之後的天數，其小數分量代表當天的時間除以 24。 例如，1899 年 12 月 31 日午夜以 1.0 表示;1900 年 1 月 1 日上午 6 點由 2.25 表示;1899 年 12 月 29 日午夜用 -1.0 表示;1899 年 12 月 29 日早上 6 點以 -1.25 表示。 基本值為 1899 年 12 月 30 日午夜。 最小值為午夜，1 年 1 月 0100 日。 最大值是 9999 年 12 月 31 日的最後一刻。 -
number：傳回一個datetimezone，其日期時間相當於value表示的 OLE 自動化日期，以及對應當地時區的偏移。 -
null：傳回null。
若 value 是任何其他類型，則會傳回錯誤。
在本機執行此函式時，對應本機時區的偏移量會不同於在線上執行此函式時。 在本端執行時，會傳回當地時區。 在線上執行時，會傳回 UTC 時區 （+00：00）。
範例 1
將日期、時間和時區的文字表示法轉換為值 datetimezone 。
使用方式
DateTimeZone.From("2020-10-30T01:30:00-08:00")
輸出
#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)
範例 2
將巴西葡萄牙語日期、時間和時區的文字表示法轉換為值 datetimezone 。
使用方式
DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")
輸出
#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)
範例 3
將代表 2025 年 1 月 1 日中午 12 點的數字轉換為一個 datetimezone 值。 結果中的時區取決於範例是在本端執行還是線上執行。
使用方式
DateTimeZone.From(45658.5)
輸出
#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)