Article
11/18/2011

TimeZoneInfo Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Represents a time zone.

Inheritance Hierarchy

System.Object
System.TimeZoneInfo

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<TypeForwardedFromAttribute("System.Core, Version=3.5.0.0, Culture=Neutral, PublicKeyToken=b77a5c561934e089")> _
Public NotInheritable Class TimeZoneInfo _
    Implements IEquatable(Of TimeZoneInfo)

[TypeForwardedFromAttribute("System.Core, Version=3.5.0.0, Culture=Neutral, PublicKeyToken=b77a5c561934e089")]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>

The TimeZoneInfo type exposes the following members.

Properties

	Name	Description
	BaseUtcOffset	Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).
	DaylightName	Gets the localized display name for the current time zone's daylight saving time.
	DisplayName	Gets the localized general display name that represents the time zone.
	Local	Gets a TimeZoneInfo object that represents the local time zone.
	StandardName	Gets the localized display name for the time zone's standard time.
	SupportsDaylightSavingTime	Gets a value indicating whether the time zone has any daylight saving time rules.
	Utc	Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Top

Methods

	Name	Description
	ConvertTime(DateTime, TimeZoneInfo)	Converts a time to the time in a particular time zone.
	ConvertTime(DateTimeOffset, TimeZoneInfo)	Converts a time to the time in a particular time zone.
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Equals(TimeZoneInfo)	Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetAmbiguousTimeOffsets(DateTime)	Returns information about the possible dates and times that an ambiguous date and time can be mapped to.
	GetAmbiguousTimeOffsets(DateTimeOffset)	Returns information about the possible dates and times that an ambiguous date and time can be mapped to.
	GetHashCode	Serves as a hash function for hashing algorithms and data structures such as hash tables. (Overrides Object.GetHashCode().)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetUtcOffset(DateTime)	Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.
	GetUtcOffset(DateTimeOffset)	Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.
	IsAmbiguousTime(DateTime)	Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.
	IsAmbiguousTime(DateTimeOffset)	Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.
	IsDaylightSavingTime(DateTime)	Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.
	IsDaylightSavingTime(DateTimeOffset)	Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.
	IsInvalidTime	Indicates whether a particular date and time is invalid.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns the current TimeZoneInfo object's display name. (Overrides Object.ToString().)

Top

Remarks

A time zone is a geographical region in which the same time is used. TimeZoneInfo is an immutable class that represents a time zone. It recognizes two predefined time zones:

The local time zone (the time zone of the system on which Silverlight code is running). A TimeZoneInfo object that represents the local time zone can be retrieved from the TimeZoneInfo.Local property.
Coordinated Universal Time (UTC). A TimeZoneInfo object that represents UTC can be retrieved from the TimeZoneInfo.Utc property.

The TimeZoneInfo class includes the ConvertTime method, which allows conversions from the time in any time zone to either local time or UTC, or between the local time and UTC. It also offers a number of members that provide information about the time zone itself or about a particular time in that time zone.

You cannot instantiate a TimeZoneInfo object using the new keyword. Instead, you must retrieve the appropriate TimeZoneInfo object from either the Local property or the Utc property.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Partager via