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
  • id 参数是空字符串 ("")。
  • baseUtcOffset 参数不表示整分钟数。
ArgumentOutOfRangeException baseUtcOffset 参数大于 14 小时或小于 -14 小时。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.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 系统要求。