語言

ZoneId.Of 方法

定義

多載

名稱 Description
Of(String)

從 ID 取得 ZoneId,確保該 ID 有效且可供使用。

Of(String, IDictionary<String,String>)

利用別名映射來補充標準區域識別碼,取得 ZoneID 的實例。

Of(String)

從 ID 取得 ZoneId,確保該 ID 有效且可供使用。

[Android.Runtime.Register("of", "(Ljava/lang/String;)Ljava/time/ZoneId;", "", ApiSince=26)]
public static Java.Time.ZoneId? Of(string? zoneId);
[<Android.Runtime.Register("of", "(Ljava/lang/String;)Ljava/time/ZoneId;", "", ApiSince=26)>]
static member Of : string -> Java.Time.ZoneId

參數

zoneId
String

時區 ID,而非空

傳回

區域 ID,不是 null

屬性

備註

從 ID 取得 ZoneId,確保該 ID 有效且可供使用。 此方法解析 ID 產生 ZoneId 或 ZoneOffset。 若 ID 為 'Z',或以 '+' 或 '-' 開頭,則會回傳 ZoneOffset。 結果永遠是有效的 ID,並可取得 ZoneRules。 解析過程逐步匹配區域 ID,如下所示。 若區域 ID 等於「Z」,結果為 ZoneOffset.UTC。 若區域 ID 僅包含一個字母,則區域 ID 無效,並拋出 DateTimeException。 若區域 ID 以 '+' 或 '-' 開頭,則使用 ZoneOffset.of(String) 解析該 ID 為 ZoneOffset。 若區域 ID 為 'GMT'、'UTC' 或 'UT',則結果為與 ZoneOffset.UTC 相同 ID 與規則相同的 ZoneId。 若區域 ID 以 'UTC+'、'UTC-'、'GMT+'、'GMT-'、'UT+' 或 'UT-' 開頭,則該 ID 為前綴偏移 ID。 ID 分為兩部分,前綴為兩或三個字母,後綴以標誌開頭。 該後綴被解析為 ZoneOffset。 結果會是一個 ZoneId,前綴為指定的 UTC/GMT/UT,且根據 ZoneOffset.getId() 標準化偏移 ID。 回傳的 ZoneId 規則將等同於解析後的 ZoneOffset。 其他所有 ID 則以區域為基礎的區域 ID 解析。 區域 ID 必須符合正則表達式 [A-Za-z][A-Za-z0-9~/._+-]+,否則會拋出 DateTimeException。 如果區域 ID 不在設定的 ID 集合中,則會拋出 ZoneRulesException。 區域ID的詳細格式取決於提供資料的團體。 預設的資料集由 IANA 時區資料庫(TZDB)提供。 此區域識別碼格式為「{area}/{city}」,例如「Europe/Paris」或「America/New_York」。 這與 TimeZone 的大多數 ID 相容。

Java 參考 java.time.ZoneId.of

適用於

Of(String, IDictionary<String,String>)

利用別名映射來補充標準區域識別碼,取得 ZoneID 的實例。

[Android.Runtime.Register("of", "(Ljava/lang/String;Ljava/util/Map;)Ljava/time/ZoneId;", "", ApiSince=26)]
public static Java.Time.ZoneId? Of(string? zoneId, System.Collections.Generic.IDictionary<string,string>? aliasMap);
[<Android.Runtime.Register("of", "(Ljava/lang/String;Ljava/util/Map;)Ljava/time/ZoneId;", "", ApiSince=26)>]
static member Of : string * System.Collections.Generic.IDictionary<string, string> -> Java.Time.ZoneId

參數

zoneId
String

時區 ID,而非空

aliasMap
IDictionary<String,String>

這是將別名區域 ID(通常是縮寫)映射到真實區域 ID,而非空

傳回

區域 ID,不是 null

屬性

備註

要加入。

Java 參考 java.time.ZoneId.of

適用於