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
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 BaseUtcOffset Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 DaylightName Gets the localized display name for the current time zone's daylight saving time.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 DisplayName Gets the localized general display name that represents the time zone.
Public propertyStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Local Gets a TimeZoneInfo object that represents the local time zone.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 StandardName Gets the localized display name for the time zone's standard time.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 SupportsDaylightSavingTime Gets a value indicating whether the time zone has any daylight saving time rules.
Public propertyStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Utc Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Top

Methods

  Name Description
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 ConvertTime(DateTime, TimeZoneInfo) Converts a time to the time in a particular time zone.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 ConvertTime(DateTimeOffset, TimeZoneInfo) Converts a time to the time in a particular time zone.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Equals(TimeZoneInfo) Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetAmbiguousTimeOffsets(DateTime) Returns information about the possible dates and times that an ambiguous date and time can be mapped to.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetAmbiguousTimeOffsets(DateTimeOffset) Returns information about the possible dates and times that an ambiguous date and time can be mapped to.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetHashCode Serves as a hash function for hashing algorithms and data structures such as hash tables. (Overrides Object.GetHashCode().)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetType Gets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IsInvalidTime Indicates whether a particular date and time is invalid.
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.

See Also

Reference