DateTimeZone.FromText

根據本地、國際和自訂 datetimezone 格式建立 datetimezone。

Syntax

DateTimeZone.FromText(
    text as text,
    optional options as any
) as datetimezone

以文字表示 (text) 建立 datetimezone 值。可能會提供選用的 record 參數 (options) 來指定其他屬性。record 可能包含下列欄位:

Format: text 值，指出要使用的格式。如需詳細資料，請前往 https://go.microsoft.com/fwlink/?linkid=2180104 與 https://go.microsoft.com/fwlink/?linkid=2180105。省略此欄位或提供 null 將導致盡量剖析日期。
Culture: 當 Format 不是 null 時，Culture 會控制一些格式規範。例如，"en-US" 的 "MMM" 為 "Jan", "Feb", "Mar", ...，而 "ru-RU" 的 "MMM" 為 "янв", "фев", "мар", ...。當 Format 為 null，Culture 會控制要使用的預設格式。當 Culture 是 null 或已省略時，會使用 Culture.Current。

若要支援舊版工作流程，options 也可以是文字值。這與 options = [Format = null, Culture = options] 具有相同的行爲。

將 "2010-12-31T01:30:00-08:00" 轉換成 datetimezone 值。

DateTimeZone.FromText("2010-12-31T01:30:00-08:00")

Result:

#datetimezone(2010, 12, 31, 1, 30, 0, -8, 0)

使用自訂格式和德文文化特性進行轉換。

DateTimeZone.FromText("30 Dez 2010 02:04:50.369730 +02:00", [Format="dd MMM yyyy HH:mm:ss.ffffff zzz", Culture="de-DE"])

Result:

#datetimezone(2010, 12, 30, 2, 4, 50.36973, 2, 0)

使用 ISO 8601 進行轉換。

DateTimeZone.FromText("2009-06-15T13:45:30.0000000-07:00", [Format="O", Culture="en-US"])

Result:

#datetimezone(2009, 6, 15, 13, 45, 30, -7, 0)