ZoneId.Of 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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 相容。
適用於
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
- 屬性
備註
要加入。