Class MapZone
Represents a single
<mapZone>
element in the CLDR Windows zone mapping file.
Since 1.1.x
Availability net45, netstandard1.3
Inheritance
Object
MapZone
Implements
IEquatable<MapZone>
Inherited Members
Object.Equals(Object, Object)
Object.ReferenceEquals(Object, Object)
Object.GetType()
Object.MemberwiseClone()
Namespace: NodaTime.TimeZones.Cldr
Assembly: NodaTime.dll
Syntax
public sealed class MapZone : IEquatable<MapZone>
Constructors
MapZone(String, String, IList<String>)
Creates a new mapping entry.
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public MapZone(string windowsId, string territory, IList<string> tzdbIds)
Parameters
Type | Name | Description |
---|---|---|
String | windowsId | Windows system time zone identifier. Must not be null. |
String | territory | Territory code. Must not be null. |
IList<String> | tzdbIds | List of territory codes. Must not be null, and must not contains null values. |
Remarks
This constructor is only public for the sake of testability.
Exceptions
Type | Condition |
---|---|
ArgumentNullException | windowsId, territory or tzdbIds is null |
Fields
FixedOffsetTerritory
Identifier used for the "fixed offset" territory. A zone mapping with
this territory will always have a single entry. The value of this constant is "ZZ".
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public const string FixedOffsetTerritory = "ZZ"
Field Value
Type | Description |
---|---|
String |
PrimaryTerritory
Identifier used for the primary territory of each Windows time zone. A zone mapping with
this territory will always have a single entry. The value of this constant is "001".
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public const string PrimaryTerritory = "001"
Field Value
Type | Description |
---|---|
String |
Properties
Territory
Gets the territory code for this mapping.
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public string Territory { get; }
Property Value
Type | Description |
---|---|
String | The territory code for this mapping. (The value returned is never null.) |
Remarks
This is typically either "001" to indicate that it's the primary territory for this ID, or
"ZZ" to indicate a fixed-offset ID, or a different two-character capitalized code
which indicates the geographical territory.
TzdbIds
Gets a read-only non-empty collection of TZDB zone identifiers for this mapping, such as
"America/Chicago" and "America/Matamoros" (both of which are TZDB zones associated with the "Central Standard Time"
Windows system time zone).
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public IList<string> TzdbIds { get; }
Property Value
Type | Description |
---|---|
IList<String> | A read-only non-empty collection of TZDB zone identifiers for this mapping. (The value returned is never null.) |
Remarks
For the primary and fixed-offset territory IDs ("001" and "ZZ") this always
contains exactly one time zone ID.
WindowsId
Gets the Windows system time zone identifier for this mapping, such as "Central Standard Time".
Since 1.1.x
Availability net45, netstandard1.3
Declaration
public string WindowsId { get; }
Property Value
Type | Description |
---|---|
String | The Windows system time zone identifier for this mapping, such as "Central Standard Time". (The value returned is never null.) |
Remarks
Most Windows system time zone identifiers use the name for the "standard" part of the zone as the overall identifier. Don't be fooled: just because a time zone includes "standard" in its identifier doesn't mean that it doesn't observe daylight saving time.
Methods
Equals(MapZone)
Since 2.0.x
Availability net45, netstandard1.3
Declaration
public bool Equals(MapZone other)
Parameters
Type | Name | Description |
---|---|---|
MapZone | other |
Returns
Type | Description |
---|---|
Boolean |
Equals(Object)
Since 2.0.x
Availability net45, netstandard1.3
Declaration
public override bool Equals(object obj)
Parameters
Type | Name | Description |
---|---|---|
Object | obj |
Returns
Type | Description |
---|---|
Boolean |
Overrides
System.Object.Equals(System.Object)
GetHashCode()
Since 2.0.x
Availability net45, netstandard1.3
Declaration
public override int GetHashCode()
Returns
Type | Description |
---|---|
Int32 |
Overrides
System.Object.GetHashCode()
ToString()
Since 2.0.x
Availability net45, netstandard1.3
Declaration
public override string ToString()
Returns
Type | Description |
---|---|
String |
Overrides
System.Object.ToString()
Implements
System.IEquatable<T>