Procedure: Tijdzones maken met aanpassingsregels

Artikel
03/05/2024

De exacte tijdzone-informatie die door een toepassing vereist is, kan om verschillende redenen niet aanwezig zijn op een bepaald systeem:

De tijdzone is nooit gedefinieerd in het register van het lokale systeem.
Gegevens over de tijdzone zijn gewijzigd of verwijderd uit het register.
De tijdzone heeft geen nauwkeurige informatie over aanpassingen van tijdzones voor een bepaalde historische periode.

In deze gevallen kunt u de CreateCustomTimeZone methode aanroepen om de tijdzone te definiëren die vereist is voor uw toepassing. U kunt de overbelasting van deze methode gebruiken om een tijdzone te maken met of zonder aanpassingsregels. Als de tijdzone zomertijd ondersteunt, kunt u aanpassingen definiëren met vaste of zwevende aanpassingsregels. (Zie voor definities van deze termen de sectie 'Tijdzoneterminologie' in Overzicht van tijdzone.)

Belangrijk

Aangepaste tijdzones die zijn gemaakt door de CreateCustomTimeZone methode aan te roepen, worden niet toegevoegd aan het register. In plaats daarvan kunnen ze alleen worden geopend via de objectverwijzing die wordt geretourneerd door de CreateCustomTimeZone methode-aanroep.

In dit onderwerp wordt beschreven hoe u een tijdzone maakt met aanpassingsregels. Als u een tijdzone wilt maken die geen regels voor zomertijdaanpassing ondersteunt, raadpleegt u Procedure: Tijdzones maken zonder aanpassingsregels.

Een tijdzone maken met zwevende aanpassingsregels

Voor elke aanpassing (dat wil gezegd, voor elke overgang van en terug naar de standaardtijd gedurende een bepaald tijdsinterval), gaat u als volgt te werk:
1. Definieer de begintijd van de overgang voor de aanpassing van de tijdzone.
  
  U moet de TimeZoneInfo.TransitionTime.CreateFloatingDateRule methode aanroepen en deze doorgeven aan een DateTime waarde die de tijd van de overgang definieert, een geheel getal dat de maand van de overgang definieert, een geheel getal dat de week definieert waarop de overgang plaatsvindt en een DayOfWeek waarde die de dag van de week definieert waarop de overgang plaatsvindt. Met deze methode wordt een TimeZoneInfo.TransitionTime object geïnstitueert.
2. Definieer de eindovergangstijd voor de aanpassing van de tijdzone. Hiervoor is een andere aanroep naar de TimeZoneInfo.TransitionTime.CreateFloatingDateRule methode vereist. Met deze methode wordt een tweede TimeZoneInfo.TransitionTime object aangeroepen.
3. Roep de CreateAdjustmentRule methode aan en geef deze door aan de effectieve begin- en einddatums van de aanpassing, een TimeSpan object dat de hoeveelheid tijd in de overgang definieert en de twee TimeZoneInfo.TransitionTime objecten die bepalen wanneer de overgangen naar en van zomertijd plaatsvinden. Met deze methode wordt een TimeZoneInfo.AdjustmentRule object geïnstitueert.
4. Wijs het TimeZoneInfo.AdjustmentRule object toe aan een matrix met TimeZoneInfo.AdjustmentRule objecten.
Definieer de weergavenaam van de tijdzone. De weergavenaam volgt een vrij standaardindeling waarin de verschuiving van de tijdzone van Coordinated Universal Time (UTC) tussen haakjes staat en wordt gevolgd door een tekenreeks die de tijdzone, een of meer steden in de tijdzone, of een of meer van de landen of regio's in de tijdzone identificeert.
Definieer de naam van de standaardtijd van de tijdzone. Deze tekenreeks wordt doorgaans ook gebruikt als de id van de tijdzone.
Definieer de naam van de daglichttijd van de tijdzone.
Als u een andere id wilt gebruiken dan de standaardnaam van de tijdzone, definieert u de tijdzone-id.
Instantieer een TimeSpan object waarmee de offset van de tijdzone van UTC wordt gedefinieerd. Tijdzones met tijden die later zijn dan UTC, hebben een positieve offset. Tijdzones met tijden die ouder zijn dan UTC, hebben een negatieve verschuiving.
Roep de TimeZoneInfo.CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) methode aan om de nieuwe tijdzone te instantiëren.

Opmerking

In het volgende voorbeeld wordt een centrale standaardtijdzone gedefinieerd voor de Verenigde Staten die aanpassingsregels bevat voor verschillende tijdsintervallen van 1918 tot heden.

TimeZoneInfo cst;
// Declare necessary TimeZoneInfo.AdjustmentRule objects for time zone
TimeSpan delta = new TimeSpan(1, 0, 0);
TimeZoneInfo.AdjustmentRule adjustment;
List<TimeZoneInfo.AdjustmentRule> adjustmentList = new List<TimeZoneInfo.AdjustmentRule>();
// Declare transition time variables to hold transition time information
TimeZoneInfo.TransitionTime transitionRuleStart, transitionRuleEnd;

// Define new Central Standard Time zone 6 hours earlier than UTC
// Define rule 1 (for 1918-1919)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 03, 05, DayOfWeek.Sunday);
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 10, 05, DayOfWeek.Sunday);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1918, 1, 1), new DateTime(1919, 12, 31), delta,
                                                           transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 2 (for 1942)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, 2, 0, 0), 02, 09);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1942, 1, 1), new DateTime(1942, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 3 (for 1945)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, 23, 0, 0), 08, 14);
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, 2, 0, 0), 09, 30);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1945, 1, 1), new DateTime(1945, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define end rule (for 1967-2006)
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 10, 5, DayOfWeek.Sunday);
// Define rule 4 (for 1967-73)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 04, 05, DayOfWeek.Sunday);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1967, 1, 1), new DateTime(1973, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 5 (for 1974 only)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, 2, 0, 0), 01, 06);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1974, 1, 1), new DateTime(1974, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 6 (for 1975 only)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(new DateTime(1, 1, 1, 2, 0, 0), 02, 23);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1975, 1, 1), new DateTime(1975, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 7 (1976-1986)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 04, 05, DayOfWeek.Sunday);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1976, 1, 1), new DateTime(1986, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 8 (1987-2006)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 04, 01, DayOfWeek.Sunday);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1987, 1, 1), new DateTime(2006, 12, 31),
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);
// Define rule 9 (2007- )
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 03, 02, DayOfWeek.Sunday);
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 2, 0, 0), 11, 01, DayOfWeek.Sunday);
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(2007, 1, 1), DateTime.MaxValue.Date,
                                                           delta, transitionRuleStart, transitionRuleEnd);
adjustmentList.Add(adjustment);

// Convert list of adjustment rules to an array
TimeZoneInfo.AdjustmentRule[] adjustments = new TimeZoneInfo.AdjustmentRule[adjustmentList.Count];
adjustmentList.CopyTo(adjustments);

cst = TimeZoneInfo.CreateCustomTimeZone("Central Standard Time", new TimeSpan(-6, 0, 0),
      "(GMT-06:00) Central Time (US Only)", "Central Standard Time",
      "Central Daylight Time", adjustments);

Dim cst As TimeZoneInfo
' Declare necessary TimeZoneInfo.AdjustmentRule objects for time zone
Dim delta As New TimeSpan(1, 0, 0)
Dim adjustment As TimeZoneInfo.AdjustmentRule
Dim adjustmentList As New List(Of TimeZoneInfo.AdjustmentRule)
' Declare transition time variables to hold transition time information
Dim transitionRuleStart, transitionRuleEnd As TimeZoneInfo.TransitionTime

' Define new Central Standard Time zone 6 hours earlier than UTC
' Define rule 1 (for 1918-1919)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#02:00:00AM#, 03, 05, DayOfWeek.Sunday)
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#02:00:00AM#, 10, 05, DayOfWeek.Sunday)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1918#, #12/31/1919#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 2 (for 1942)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(#2:00:00AM#, 02, 09)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1942#, #12/31/1942#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 3 (for 1945)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(#11:00:00PM#, 08, 14)
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFixedDateRule(#2:00:00AM#, 09, 30)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1945#, #12/31/1945#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define end rule (for 1967-2006)
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#02:00:00AM#, 10, 5, DayOfWeek.Sunday)
' Define rule 4 (for 1967-73)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#2:00:00AM#, 04, 05, DayOfWeek.Sunday)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1967#, #12/31/1973#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 5 (for 1974 only)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(#2:00:00AM#, 01, 06)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1974#, #12/31/1974#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 6 (for 1975 only)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFixedDateRule(#2:00:00AM#, 02, 23)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1975#, #12/31/1975#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 7 (1976-1986)
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#2:00:00AM#, 04, 05, DayOfWeek.Sunday)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1976#, #12/31/1986#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 8 (1987-2006)  
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#2:00:00AM#, 04, 01, DayOfWeek.Sunday)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/1987#, #12/31/2006#, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)
' Define rule 9 (2007- )  
transitionRuleStart = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#2:00:00AM#, 03, 02, DayOfWeek.Sunday)
transitionRuleEnd = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#2:00:00AM#, 11, 01, DayOfWeek.Sunday)
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#01/01/2007#, Date.MaxValue.Date, delta, transitionRuleStart, transitionRuleEnd)
adjustmentList.Add(adjustment)

' Convert list of adjustment rules to an array
Dim adjustments(adjustmentList.Count - 1) As TimeZoneInfo.AdjustmentRule
adjustmentList.CopyTo(adjustments)

cst = TimeZoneInfo.CreateCustomTimeZone("Central Standard Time", New TimeSpan(-6, 0, 0), _
      "(GMT-06:00) Central Time (US Only)", "Central Standard Time", _
      "Central Daylight Time", adjustments)

De tijdzone die in dit voorbeeld is gemaakt, heeft meerdere aanpassingsregels. Zorg ervoor dat de effectieve begin- en einddatums van een aanpassingsregel niet overlappen met de datums van een andere aanpassingsregel. Als er sprake is van overlap, wordt er een InvalidTimeZoneException gegenereerd.

Voor zwevende aanpassingsregels wordt de waarde 5 doorgegeven aan de week parameter van de CreateFloatingDateRule methode om aan te geven dat de overgang plaatsvindt op de laatste week van een bepaalde maand.

Bij het maken van de matrix met TimeZoneInfo.AdjustmentRule objecten die moeten worden gebruikt in de TimeZoneInfo.CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) methode-aanroep, kan de code de matrix initialiseren tot de grootte die vereist is voor het aantal aanpassingen dat moet worden gemaakt voor de tijdzone. In plaats daarvan roept dit codevoorbeeld de Add methode aan om elke aanpassingsregel toe te voegen aan een algemene List<T> verzameling TimeZoneInfo.AdjustmentRule objecten. De code roept vervolgens de CopyTo methode aan om de leden van deze verzameling naar de matrix te kopiëren.

In het voorbeeld wordt ook de CreateFixedDateRule methode gebruikt om aanpassingen van vaste datums te definiëren. Dit is vergelijkbaar met het aanroepen van de CreateFloatingDateRule methode, behalve dat deze alleen de tijd, maand en dag van de overgangsparameters vereist.

Het voorbeeld kan worden getest met behulp van code zoals:

TimeZoneInfo est = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");

DateTime pastDate1 = new DateTime(1942, 2, 11);
Console.WriteLine("Is {0} daylight saving time: {1}", pastDate1,
                  cst.IsDaylightSavingTime(pastDate1));

DateTime pastDate2 = new DateTime(1967, 10, 29, 1, 30, 00);
Console.WriteLine("Is {0} ambiguous: {1}", pastDate2,
                  cst.IsAmbiguousTime(pastDate2));

DateTime pastDate3 = new DateTime(1974, 1, 7, 2, 59, 00);
Console.WriteLine("{0} {1} is {2} {3}", pastDate3,
                  est.IsDaylightSavingTime(pastDate3) ?
                      est.DaylightName : est.StandardName,
                  TimeZoneInfo.ConvertTime(pastDate3, est, cst),
                  cst.IsDaylightSavingTime(TimeZoneInfo.ConvertTime(pastDate3, est, cst)) ?
                      cst.DaylightName : cst.StandardName);
//
// This code produces the following output to the console:
//
//    Is 2/11/1942 12:00:00 AM daylight saving time: True
//    Is 10/29/1967 1:30:00 AM ambiguous: True
//    1/7/1974 2:59:00 AM Eastern Standard Time is 1/7/1974 2:59:00 AM Central Daylight Time

Dim est As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")

Dim pastDate1 As Date = #2/11/1942#
Console.WriteLine("Is {0} daylight saving time: {1}", pastDate1, _
                  cst.IsDaylightSavingTime(pastDate1))

Dim pastDate2 As Date = #10/29/1967 1:30AM#
Console.WriteLine("Is {0} ambiguous: {1}", pastDate2, _
                  cst.IsAmbiguousTime(pastDate2))

Dim pastDate3 As Date = #1/7/1974 2:59AM#
Console.WriteLine("{0} {1} is {2} {3}", pastDate3, _
                  IIf(est.IsDaylightSavingTime(pastDate3), _
                      est.DaylightName, est.StandardName), _
                  TimeZoneInfo.ConvertTime(pastDate3, est, cst), _
                  IIf(cst.IsDaylightSavingTime(TimeZoneInfo.ConvertTime(pastDate3, est, cst)), _
                      cst.DaylightName, cst.StandardName))
'
' This code produces the following output to the console:
' 
'    Is 2/11/1942 12:00:00 AM daylight saving time: True
'    Is 10/29/1967 1:30:00 AM ambiguous: True
'    1/7/1974 2:59:00 AM Eastern Standard Time is 1/7/1974 2:59:00 AM Central Daylight Time

De code compileren

Voor dit voorbeeld is het volgende vereist:

De volgende naamruimten worden geïmporteerd:

using System.Collections.Generic;
using System.Collections.ObjectModel;

Imports System.Collections.Generic
Imports System.Collections.ObjectModel

Delen via

Procedure: Tijdzones maken met aanpassingsregels

Een tijdzone maken met zwevende aanpassingsregels

Opmerking

De code compileren

Zie ook

Aanvullende resources