System.TimeZoneInfo.CreateCustomTimeZone 方法 (String, TimeSpan, String, String)
方法描述
创建带指定标识符的自定义时区、与协调世界时 (UTC) 的偏移量、显示名称以及标准时间显示名称。
语法定义(C# System.TimeZoneInfo.CreateCustomTimeZone 方法 (String, TimeSpan, String, String) 的用法)
public static TimeZoneInfo CreateCustomTimeZone( string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
id | System-String | 时区标识符。 |
baseUtcOffset | System-TimeSpan | 一个对象,表示此时区和协调世界时 (UTC) 之间的时差。 |
displayName | System-String | 新时区的显示名称。 |
standardDisplayName | System-String | 新时区的标准时间名称。 |
返回值 | System.TimeZoneInfo | 新时区。 |
提示和注释
此 CreateCustomTimeZone(String, TimeSpan, String, String) 方法重载适合于创建没有调整的时区(即,不支持夏时制的时区)。 若要定义包括夏时制调整的时区,请使用 TimeZoneInfo.CreateCustomTimeZone 或 TimeZoneInfo.CreateCustomTimeZone 方法。
下表显示提供给 TimeZoneInfo.CreateCustomTimeZone 方法的参数与该方法调用返回的 TimeZoneInfo 对象的属性之间的关系。
CreateCustomTimeZone 参数
TimeZoneInfo 属性
id
Id
baseUtcOffset
BaseUtcOffset
displayName
DisplayName
standardDisplayName
StandardName
通常,时区的标准时间名称与其标识符是相同的。 但时区标识符的长度不应超过 32 个字符。 传递给 displayName 参数的字符串遵循相当标准的格式。 显示名称的第一部分是时区与协调世界时的基本偏移量,以首字母缩略词 GMT(表示格林尼治标准时间)表示并括在括号内。 随后的字符串标识时区本身以及/或者时区中的一个或多个城市、地区或国家。 例如:
复制
(GMT+02:00) Athens, Beirut, Istanbul, Minsk
(GMT-02:00) Mid-Atlantic
(GMT-07:00) Mountain Time (US & Canada)
System.TimeZoneInfo.CreateCustomTimeZone 方法 (String, TimeSpan, String, String)例子
然后显示将本地时间转换为新时区中时间的结果。
string displayName = "(GMT+06:00) Antarctica/Mawson Time"; string standardName = "Mawson Time"; TimeSpan offset = new TimeSpan(06, 00, 00); TimeZoneInfo mawson = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName); Console.WriteLine("The current time is {0} {1}", TimeZoneInfo.ConvertTime(DateTime.Now, TimeZoneInfo.Local, mawson), mawson.StandardName);
异常
异常 | 异常描述 |
---|---|
ArgumentNullException | id 参数为 null。 |
ArgumentException |
|
ArgumentOutOfRangeException | baseUtcOffset 参数大于 14 小时或小于 -14 小时。 |
版本信息
.NET Framework 受以下版本支持:4、3.5 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。