TimeZoneInfo Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Represents a time zone.
Inheritance Hierarchy
System..::.Object
System..::.TimeZoneInfo
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
Public NotInheritable Class TimeZoneInfo _
Implements IEquatable(Of TimeZoneInfo)
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>
The TimeZoneInfo type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
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. |
.gif "Static member") |
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 | |
|---|---|---|
.gif "Public method") |
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. |
.gif "Protected method") |
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 Windows Phone 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
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone
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.