ZoneId.Of 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| Of(String) |
从 ID 获取 ZoneId 的实例,确保 ID 有效且可供使用。 |
| Of(String, IDictionary<String,String>) |
使用别名映射获取 ZoneId 的实例,以补充标准区域 ID。 |
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,而不是 null
返回
区域 ID,而不是 null
- 特性
注解
从 ID 获取 ZoneId 的实例,确保 ID 有效且可供使用。 此方法分析生成 ZoneId 或 ZoneOffset 的 ID。 如果 ID 为“Z”,或以“+”或“-”开头,则返回 ZoneOffset。 结果将始终是可以获取 ZoneRules 的有效 ID。 分析与区域 ID 逐步进行匹配,如下所示。 如果区域 ID 等于“Z”,则结果为 ZoneOffset.UTC。 如果区域 ID 由单个字母组成,则区域 ID 无效,并引发 DateTimeException。 如果区域 ID 以“+”或“-”开头,则 ID 使用 ZoneOffset.of(String)分析为 ZoneOffset。 如果区域 ID 等于“GMT”、“UTC”或“UT”,则结果是与 ZoneOffset.UTC 相同的 ID 和规则的 ZoneId。 如果区域 ID 以“UTC+”、“UTC-”、“GMT+”、“GMT-”、“UT+”或“UT-”开头,则 ID 是基于偏移量的前缀 ID。 ID 以两个或三个字母前缀和后缀(以符号开头)拆分。 后缀解析为 ZoneOffset。 结果将为具有指定 UTC/GMT/UT 前缀的 ZoneId,以及根据 ZoneOffset.getId()规范化的偏移 ID。 返回的 ZoneId 的规则将等效于已分析的 ZoneOffset。 所有其他 ID 都分析为基于区域的区域 ID。 区域 ID 必须与正则表达式 [A-Za-z][A-Za-z0-9~/._+-]+ 匹配,否则将引发 DateTimeException。 如果区域 ID 不在配置的 ID 集中,则会引发 ZoneRulesException。 区域 ID 的详细格式取决于提供数据的组。 IANA 时区数据库(TZDB)提供默认数据集。 这具有“{area}/{city}”形式的区域 ID,例如“欧洲/巴黎”或“美国/New_York”。 这与 TimeZone 中的大多数 ID 兼容。
适用于
Of(String, IDictionary<String,String>)
使用别名映射获取 ZoneId 的实例,以补充标准区域 ID。
[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,而不是 null
- aliasMap
- IDictionary<String,String>
别名区域 ID(通常缩写)映射到实际区域 ID,而不是 null
返回
区域 ID,而不是 null
- 特性
注解
使用别名映射获取 ZoneId 的实例,以补充标准区域 ID。 许多时区的用户使用短缩写,例如“太平洋标准时间”的 PST 和“太平洋夏令时”的 PDT。 这些缩写不是唯一的,因此不能用作 ID。 此方法允许在应用程序中设置和重用字符串到时区的映射。