TimeZoneInfo.CreateCustomTimeZone TimeZoneInfo.CreateCustomTimeZone TimeZoneInfo.CreateCustomTimeZone TimeZoneInfo.CreateCustomTimeZone Method

Definition

Definiert eine Zeitzone, die auf dem lokalen Computer nicht gefunden wird.Defines a time zone that is not found on the local computer.

Überlädt

CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String)

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen und einem Anzeigenamen für die Standardzeit.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen, einem Namen für die Standardzeit, einen Namen für die Sommerzeit und Regeln für die Sommerzeit.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, and daylight saving time rules.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen, einem Namen für die Standardzeit, einen Namen für die Sommerzeit, Regeln für die Sommerzeit und einem Wert, der angibt, ob das zurückgegebene Objekt Sommerzeitinformationen darstellt.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, daylight saving time rules, and a value that indicates whether the returned object reflects daylight saving time information.

CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String)

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen und einem Anzeigenamen für die Standardzeit.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.

public:
 static TimeZoneInfo ^ CreateCustomTimeZone(System::String ^ id, TimeSpan baseUtcOffset, System::String ^ displayName, System::String ^ standardDisplayName);
public static TimeZoneInfo CreateCustomTimeZone (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName);
static member CreateCustomTimeZone : string * TimeSpan * string * string -> TimeZoneInfo
Public Shared Function CreateCustomTimeZone (id As String, baseUtcOffset As TimeSpan, displayName As String, standardDisplayName As String) As TimeZoneInfo

Parameter

id
String String String String

Der Zeitzonenbezeichner.The time zone's identifier.

baseUtcOffset
TimeSpan TimeSpan TimeSpan TimeSpan

Ein Objekt, das den Zeitunterschied zwischen dieser Zeitzone und Coordinated Universal Time (UTC) darstellt.An object that represents the time difference between this time zone and Coordinated Universal Time (UTC).

displayName
String String String String

Der Anzeigename der neuen Zeitzone.The display name of the new time zone.

standardDisplayName
String String String String

Der Name der Standardzeit der neuen Zeitzone.The name of the new time zone's standard time.

Gibt zurück

Die neue Zeitzone.The new time zone.

Ausnahmen

Der id-Parameter ist null.The id parameter is null.

Der id-Parameter ist eine leere Zeichenfolge ("").The id parameter is an empty string ("").

- oder --or- Der baseUtcOffset-Parameter gibt keine ganze Zahl von Minuten an.The baseUtcOffset parameter does not represent a whole number of minutes.

Der Wert des baseUtcOffset-Parameters ist größer als 14 Stunden oder kleiner als -14 Stunden.The baseUtcOffset parameter is greater than 14 hours or less than -14 hours.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte Zeitzone für die Mawson-und Holme-Bay-Regionen der Antarktis erstellt.The following example creates a custom time zone for the Mawson and Holme Bay regions of Antarctica. Anschließend wird das Ergebnis der Umstellung der lokalen Zeit in die Zeit in der neuen Zeitzone angezeigt.It then displays the result of converting the local time to the time in the new time zone.

string displayName = "(GMT+06:00) Antarctica/Mawson Time";
string standardName = "Mawson Time"; 
TimeSpan offset = new TimeSpan(06, 00, 00);
TimeZoneInfo mawson = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName);
Console.WriteLine("The current time is {0} {1}", 
                  TimeZoneInfo.ConvertTime(DateTime.Now, TimeZoneInfo.Local, mawson),
                  mawson.StandardName);      
Dim displayName As String = "(GMT+06:00) Antarctica/Mawson Time"
Dim standardName As String = "Mawson Time" 
Dim offset As TimeSpan = New TimeSpan(06, 00, 00)
Dim mawson As TimeZoneInfo = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName)
Console.WriteLine("The current time is {0} {1}", _ 
                  TimeZoneInfo.ConvertTime(Date.Now, TimeZoneInfo.Local, mawson), _
                  mawson.StandardName)      

Hinweise

Diese Überladung der- MethodeeignetsichzumErstelleneinerZeitzone,diekeineAnpassungenaufweist(d.h.eineZeitzone,dieSommerzeitnichtunterstützt).CreateCustomTimeZone(String, TimeSpan, String, String)This overload of the CreateCustomTimeZone(String, TimeSpan, String, String) method is suitable for creating a time zone that has no adjustments (that is, a time zone that does not support daylight saving time). Verwenden Sie entweder die TimeZoneInfo.CreateCustomTimeZone -Methode oder die-Methode, um eine Zeitzone zu definieren, die Anpassungen für die TimeZoneInfo.CreateCustomTimeZone Sommerzeit einschließt.To define a time zone that includes adjustments for daylight saving time, use either the TimeZoneInfo.CreateCustomTimeZone or the TimeZoneInfo.CreateCustomTimeZone method.

Die folgende Tabelle zeigt die Beziehung zwischen den Parametern, die für die TimeZoneInfo.CreateCustomTimeZone -Methode bereitgestellt werden, TimeZoneInfo und den Eigenschaften des-Objekts, die durch den-Methoden Aufrufwert zurückgegeben werden.The following table shows the relationship between the parameters that are provided to the TimeZoneInfo.CreateCustomTimeZone method and the properties of the TimeZoneInfo object that are returned by the method call.

Parameter "kreatecustomtimezone"CreateCustomTimeZone parameter Timezoneingefo (Eigenschaft)TimeZoneInfo property
id Id
baseUtcOffset BaseUtcOffset
displayName DisplayName
standardDisplayName StandardName

In der Regel sind der Standardzeit Name der Zeitzone und der zugehörige Bezeichner identisch.Typically, the time zone's standard time name and its identifier are the same. Allerdings sollte die Länge des Bezeichners der Zeitzone nicht länger als 32 Zeichen sein.However, the length of the time zone's identifier should not exceed 32 characters. Die an den displayName -Parameter übergebenen Zeichenfolge folgt einem Recht standardmäßigen Format.The string passed to the displayName parameter follows a fairly standard format. Der erste Teil des anzeigen Amens ist der Basis Offset der Zeitzone von der koordinierten Weltzeit, der durch das Akronym GMT (für die Greenwich Mean Time) in Klammern eingeschlossen wird.The first portion of the display name is the time zone's base offset from Coordinated Universal Time, which is indicated by the acronym GMT (for Greenwich Mean Time), enclosed in parentheses. Danach folgt eine Zeichenfolge, die die Zeitzone selbst, eine oder mehrere der Städte, Regionen oder Länder in der Zeitzone oder beides identifiziert.This is followed by a string that identifies the time zone itself, or one or more of the cities, regions, or countries in the time zone, or both. Beispiel:For example:

(GMT+02:00) Athens, Beirut, Istanbul, Minsk  
(GMT-02:00) Mid-Atlantic  
(GMT-07:00) Mountain Time (US & Canada)  
Siehe auch

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen, einem Namen für die Standardzeit, einen Namen für die Sommerzeit und Regeln für die Sommerzeit.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, and daylight saving time rules.

public:
 static TimeZoneInfo ^ CreateCustomTimeZone(System::String ^ id, TimeSpan baseUtcOffset, System::String ^ displayName, System::String ^ standardDisplayName, System::String ^ daylightDisplayName, cli::array <TimeZoneInfo::AdjustmentRule ^> ^ adjustmentRules);
public static TimeZoneInfo CreateCustomTimeZone (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName, string daylightDisplayName, TimeZoneInfo.AdjustmentRule[] adjustmentRules);
static member CreateCustomTimeZone : string * TimeSpan * string * string * string * TimeZoneInfo.AdjustmentRule[] -> TimeZoneInfo
Public Shared Function CreateCustomTimeZone (id As String, baseUtcOffset As TimeSpan, displayName As String, standardDisplayName As String, daylightDisplayName As String, adjustmentRules As TimeZoneInfo.AdjustmentRule()) As TimeZoneInfo

Parameter

id
String String String String

Der Zeitzonenbezeichner.The time zone's identifier.

baseUtcOffset
TimeSpan TimeSpan TimeSpan TimeSpan

Ein Objekt, das den Zeitunterschied zwischen dieser Zeitzone und Coordinated Universal Time (UTC) darstellt.An object that represents the time difference between this time zone and Coordinated Universal Time (UTC).

displayName
String String String String

Der Anzeigename der neuen Zeitzone.The display name of the new time zone.

standardDisplayName
String String String String

Der Name der Standardzeit der neuen Zeitzone.The new time zone's standard time name.

daylightDisplayName
String String String String

Der Name der Sommerzeit der neuen Zeitzone.The daylight saving time name of the new time zone.

adjustmentRules
TimeZoneInfo.AdjustmentRule[]

Ein Array, das den UTC-Basisoffset für einen bestimmten Zeitraum erhöht.An array that augments the base UTC offset for a particular period.

Gibt zurück

Ein TimeZoneInfo-Objekt, das die neue Zeitzone darstellt.A TimeZoneInfo object that represents the new time zone.

Ausnahmen

Der id-Parameter ist null.The id parameter is null.

Der id-Parameter ist eine leere Zeichenfolge ("").The id parameter is an empty string ("").

- oder --or- Der baseUtcOffset-Parameter gibt keine ganze Zahl von Minuten an.The baseUtcOffset parameter does not represent a whole number of minutes.

Der Wert des baseUtcOffset-Parameters ist größer als 14 Stunden oder kleiner als -14 Stunden.The baseUtcOffset parameter is greater than 14 hours or less than -14 hours.

Die im adjustmentRules-Parameter angegebenen Anpassungsregeln überlappen sich.The adjustment rules specified in the adjustmentRules parameter overlap.

- oder --or- Die im adjustmentRules-Parameter angegebenen Anpassungsregeln sind nicht in chronologischer Reihenfolge.The adjustment rules specified in the adjustmentRules parameter are not in chronological order.

- oder --or- Mindestens ein adjustmentRules-Element ist null.One or more elements in adjustmentRules are null.

- oder --or- Auf ein Datum können mehrere Anpassungsregeln angewendet werden.A date can have multiple adjustment rules applied to it.

- oder --or- Die Summe aus dem baseUtcOffset-Parameter und dem DaylightDelta-Wert von einem oder mehreren Objekten im adjustmentRules-Array liegt über 14 Stunden oder unter -14 Stunden.The sum of the baseUtcOffset parameter and the DaylightDelta value of one or more objects in the adjustmentRules array is greater than 14 hours or less than -14 hours.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte Zeitzone für die Palmer-Station und die Anvers Insel in der Antarktis erstellt.The following example creates a custom time zone for the Palmer station and Anvers Island in Antarctica. Anschließend wird die lokale Zeit in die Zeit in der neuen Zeitzone konvertiert, und das Ergebnis wird angezeigt.It then converts the local time to the time in the new time zone and displays the result.

// Define transition times to/from DST
TimeZoneInfo.TransitionTime startTransition, endTransition;
startTransition = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 4, 0, 0), 
                                                                  10, 2, DayOfWeek.Sunday); 
endTransition = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 3, 0, 0), 
                                                                3, 2, DayOfWeek.Sunday);
// Define adjustment rule
TimeSpan delta = new TimeSpan(1, 0, 0);
TimeZoneInfo.AdjustmentRule adjustment;
adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1999, 10, 1), DateTime.MaxValue.Date, delta, startTransition, endTransition);
// Create array for adjustment rules
TimeZoneInfo.AdjustmentRule[] adjustments = {adjustment};
// Define other custom time zone arguments
string displayName = "(GMT-04:00) Antarctica/Palmer Time";
string standardName = "Palmer Time";
string daylightName = "Palmer Daylight Time";
TimeSpan offset = new TimeSpan(-4, 0, 0);
TimeZoneInfo palmer = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName, daylightName, adjustments);
Console.WriteLine("The current time is {0} {1}",  
                  TimeZoneInfo.ConvertTime(DateTime.Now, TimeZoneInfo.Local, palmer), 
                  palmer.StandardName);
' Define transition times to/from DST
Dim startTransition As TimeZoneInfo.TransitionTime = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#04:00:00#, 10, 2, DayOfWeek.Sunday) 
Dim endTransition As TimeZoneInfo.TransitionTime = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#3:00:00#, 3, 2, DayOfWeek.Sunday)
' Define adjustment rule
Dim delta As TimeSpan = New TimeSpan(1, 0, 0)
Dim adjustment As TimeZoneInfo.AdjustmentRule = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#10/01/1999#, Date.MaxValue.Date, delta, startTransition, endTransition)
' Create array for adjustment rules
Dim adjustments() As TimeZoneInfo.AdjustmentRule = {adjustment}
' Define other custom time zone arguments
Dim DisplayName As String = "(GMT-04:00) Antarctica/Palmer Time"
Dim standardName As String = "Palmer Standard Time"
Dim daylightName As String = "Palmer Daylight Time"
Dim offset As TimeSpan = New TimeSpan(-4, 0, 0)
Dim palmer As TimeZoneInfo = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName, daylightName, adjustments)
Console.WriteLine("The current time is {0} {1}", _ 
                  TimeZoneInfo.ConvertTime(Date.Now, TimeZoneInfo.Local, palmer), _
                  palmer.StandardName)

Hinweise

Diese über TimeZoneInfo.CreateCustomTimeZone Ladung der-Methode eignet sich zum Erstellen einer Zeitzone, die Sommerzeit unterstützt.This overload of the TimeZoneInfo.CreateCustomTimeZone method is suitable for creating a time zone that supports daylight saving time. Um eine Zeitzone zu definieren, die keine Sommerzeit unterstützt, verwenden Sie entweder TimeZoneInfo.CreateCustomTimeZone die- TimeZoneInfo.CreateCustomTimeZone Methode oder die-Methode.To define a time zone that does not support daylight saving time, use either the TimeZoneInfo.CreateCustomTimeZone or the TimeZoneInfo.CreateCustomTimeZone method.

Die folgende Tabelle zeigt die Beziehung zwischen den Parametern, die für die TimeZoneInfo.CreateCustomTimeZone -Methode bereitgestellt werden, TimeZoneInfo und den Membern des-Objekts, die durch den-Methoden aufzurufen werden.The following table shows the relationship between the parameters that are provided to the TimeZoneInfo.CreateCustomTimeZone method and the members of the TimeZoneInfo object that are returned by the method call.

Parameter "kreatecustomtimezone"CreateCustomTimeZone parameter Timezoneingefo-MemberTimeZoneInfo member
id Id
baseUtcOffset BaseUtcOffset
displayName DisplayName
standardDisplayName StandardName
daylightDisplayName DaylightName
adjustmentRules Ein Array von System.TimeZoneInfo.AdjustmentRule Objekten, die von GetAdjustmentRules der-Methode zurückgegeben werden.An array of System.TimeZoneInfo.AdjustmentRule objects returned by the GetAdjustmentRules method.

In der Regel sind der Standardzeit Name der Zeitzone und der zugehörige Bezeichner identisch.Typically, the time zone's standard time name and its identifier are the same. Allerdings sollte die Länge des Bezeichners der Zeitzone nicht länger als 32 Zeichen sein.However, the length of the time zone's identifier should not exceed 32 characters. Die an den displayName -Parameter übergebenen Zeichenfolge folgt einem Recht standardmäßigen Format.The string passed to the displayName parameter follows a fairly standard format. Der erste Teil des anzeigen Amens ist der Basis Offset der Zeitzone von der koordinierten Weltzeit, der durch das Akronym GMT (für die Greenwich Mean Time) in Klammern eingeschlossen wird.The first portion of the display name is the time zone's base offset from Coordinated Universal Time, which is indicated by the acronym GMT (for Greenwich Mean Time), enclosed in parentheses. Danach folgt eine Zeichenfolge, die die Zeitzone selbst, eine oder mehrere der Städte, Regionen oder Länder in der Zeitzone oder beides identifiziert.This is followed by a string that identifies the time zone itself, or one or more of the cities, regions, or countries in the time zone, or both. Beispiel:For example:

(GMT+02:00) Athens, Beirut, Istanbul, Minsk  
(GMT-02:00) Mid-Atlantic  
(GMT-07:00) Mountain Time (US & Canada)  

Der baseUtcOffset -Parameter definiert den Offset der benutzerdefinierten Zeitzone von der koordinierten Weltzeit (UTC) für alle Anpassungsregeln der Zeitzone.The baseUtcOffset parameter defines the custom time zone's offset from Coordinated Universal Time (UTC) for all of the time zone's adjustment rules. Anders ausgedrückt geht das TimeZoneInfo Objektmodell davon aus, dass der Offset der Zeitzone von UTC während der gesamten Lebensdauer der Zeitzone konstant ist, und ist unabhängig von bestimmten Anpassungsregeln vorhanden.In other words, the TimeZoneInfo object model assumes that the time zone's offset from UTC is constant throughout the life of the time zone, and exists independent of particular adjustment rules. Um eine Zeitzone widerzuspiegeln, die den Offset von UTC geändert hat, müssen Sie ein neues Zeit Zonen Objekt erstellen.To reflect a time zone that has changed its offset from UTC, you must create a new time zone object.

Die Anpassungsregeln einer Zeitzone werden wie folgt definiert:A time zone's adjustment rules are defined by doing the following:

  1. Aufrufen der CreateFloatingDateRule -Methode oder CreateFixedDateRule der-Methode, um die Anfangs-und Endzeit der Übergangszeit für jede Anpassungs Regel zu definieren.Calling either the CreateFloatingDateRule or the CreateFixedDateRule method to define the starting and ending transition time for each adjustment rule.

  2. Aufrufen der CreateAdjustmentRule -Methode für jede Anpassungs Regel.Calling the CreateAdjustmentRule method for each adjustment rule.

  3. Zuweisen der Anpassungsregeln zu einem Array, das als adjustmentRules -Parameter übergeben werden kann.Assigning the adjustment rules to an array that can be passed as the adjustmentRules parameter.

Siehe auch

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

Erstellt eine benutzerdefinierte Zeitzone mit einem angegebenen Bezeichner, einem Offset von Coordinated Universal Time (UTC), einem Anzeigenamen, einem Namen für die Standardzeit, einen Namen für die Sommerzeit, Regeln für die Sommerzeit und einem Wert, der angibt, ob das zurückgegebene Objekt Sommerzeitinformationen darstellt.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, daylight saving time rules, and a value that indicates whether the returned object reflects daylight saving time information.

public:
 static TimeZoneInfo ^ CreateCustomTimeZone(System::String ^ id, TimeSpan baseUtcOffset, System::String ^ displayName, System::String ^ standardDisplayName, System::String ^ daylightDisplayName, cli::array <TimeZoneInfo::AdjustmentRule ^> ^ adjustmentRules, bool disableDaylightSavingTime);
public static TimeZoneInfo CreateCustomTimeZone (string id, TimeSpan baseUtcOffset, string displayName, string standardDisplayName, string daylightDisplayName, TimeZoneInfo.AdjustmentRule[] adjustmentRules, bool disableDaylightSavingTime);
static member CreateCustomTimeZone : string * TimeSpan * string * string * string * TimeZoneInfo.AdjustmentRule[] * bool -> TimeZoneInfo
Public Shared Function CreateCustomTimeZone (id As String, baseUtcOffset As TimeSpan, displayName As String, standardDisplayName As String, daylightDisplayName As String, adjustmentRules As TimeZoneInfo.AdjustmentRule(), disableDaylightSavingTime As Boolean) As TimeZoneInfo

Parameter

id
String String String String

Der Zeitzonenbezeichner.The time zone's identifier.

baseUtcOffset
TimeSpan TimeSpan TimeSpan TimeSpan

Ein TimeSpan-Objekt, das den Zeitunterschied zwischen dieser Zeitzone und Coordinated Universal Time (UTC) darstellt.A TimeSpan object that represents the time difference between this time zone and Coordinated Universal Time (UTC).

displayName
String String String String

Der Anzeigename der neuen Zeitzone.The display name of the new time zone.

standardDisplayName
String String String String

Der Name der Standardzeit der neuen Zeitzone.The standard time name of the new time zone.

daylightDisplayName
String String String String

Der Name der Sommerzeit der neuen Zeitzone.The daylight saving time name of the new time zone.

adjustmentRules
TimeZoneInfo.AdjustmentRule[]

Ein Array von TimeZoneInfo.AdjustmentRule-Objekten, die den UTC-Basisoffset für einen bestimmten Zeitraum erhöhen.An array of TimeZoneInfo.AdjustmentRule objects that augment the base UTC offset for a particular period.

disableDaylightSavingTime
Boolean Boolean Boolean Boolean

true, um alle Sommerzeitinformationen in adjustmentRules mit dem neuen Objekt zu verwerfen, andernfalls false.true to discard any daylight saving time-related information present in adjustmentRules with the new object; otherwise, false.

Gibt zurück

Die neue Zeitzone.The new time zone. Wenn der disableDaylightSavingTime-Parameter true ist, verfügt das zurückgegebene Objekt nicht über Sommerzeitdaten.If the disableDaylightSavingTime parameter is true, the returned object has no daylight saving time data.

Ausnahmen

Der id-Parameter ist null.The id parameter is null.

Der id-Parameter ist eine leere Zeichenfolge ("").The id parameter is an empty string ("").

- oder --or- Der baseUtcOffset-Parameter gibt keine ganze Zahl von Minuten an.The baseUtcOffset parameter does not represent a whole number of minutes.

Der Wert des baseUtcOffset-Parameters ist größer als 14 Stunden oder kleiner als -14 Stunden.The baseUtcOffset parameter is greater than 14 hours or less than -14 hours.

Die im adjustmentRules-Parameter angegebenen Anpassungsregeln überlappen sich.The adjustment rules specified in the adjustmentRules parameter overlap.

- oder --or- Die im adjustmentRules-Parameter angegebenen Anpassungsregeln sind nicht in chronologischer Reihenfolge.The adjustment rules specified in the adjustmentRules parameter are not in chronological order.

- oder --or- Mindestens ein adjustmentRules-Element ist null.One or more elements in adjustmentRules are null.

- oder --or- Auf ein Datum können mehrere Anpassungsregeln angewendet werden.A date can have multiple adjustment rules applied to it.

- oder --or- Die Summe aus dem baseUtcOffset-Parameter und dem DaylightDelta-Wert von einem oder mehreren Objekten im adjustmentRules-Array liegt über 14 Stunden oder unter -14 Stunden.The sum of the baseUtcOffset parameter and the DaylightDelta value of one or more objects in the adjustmentRules array is greater than 14 hours or less than -14 hours.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte Zeitzone für die Palmer-Station und die Anvers Insel in der Antarktis erstellt.The following example creates a custom time zone for the Palmer station and Anvers Island in Antarctica. Der disableDaylightSavingTime -Parameter wird im Aufrufen der TimeZoneInfo.CreateCustomTimeZone -Methode auf truefestgelegt.It sets the disableDaylightSavingTime parameter in the call to the TimeZoneInfo.CreateCustomTimeZone method to true. Anschließend wird der Name der Sommerzeit der neuen Zeitzone angezeigt, sofern vorhanden, und die Anzahl der Anpassungsregeln, um zu bestätigen, dass die neue Zeitzone keine Sommerzeit Informationen enthält.It then displays the new time zone's daylight saving time name, if one is present, and the number of adjustment rules to confirm that the new time zone has no daylight saving time information.

// Define transition times to/from DST
TimeZoneInfo.TransitionTime startTransition, endTransition;
startTransition = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1, 4, 0, 0),
                                                                  10, 2, DayOfWeek.Sunday); 
endTransition = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(new DateTime(1, 1, 1,3, 0, 0), 
                                                                3, 2, DayOfWeek.Sunday);
// Define adjustment rule
TimeSpan delta = new TimeSpan(1, 0, 0);
TimeZoneInfo.AdjustmentRule adjustment = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(new DateTime(1999, 10, 1), 
                                      DateTime.MaxValue.Date, delta, startTransition, endTransition);
// Create array for adjustment rules
TimeZoneInfo.AdjustmentRule[] adjustments = {adjustment};
// Define other custom time zone arguments
string displayName = "(GMT-04:00) Antarctica/Palmer Time";
string standardName = "Palmer Standard Time";
string daylightName = "Palmer Daylight Time";
TimeSpan offset = new TimeSpan(-4, 0, 0);
// Create custom time zone without copying DST information
TimeZoneInfo palmer = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName, 
                                                  daylightName, adjustments, true);
// Indicate whether new time zone//s adjustment rules are present
Console.WriteLine("{0} {1}has {2} adjustment rules.", 
                  palmer.StandardName, 
                  ! (string.IsNullOrEmpty(palmer.DaylightName)) ?  "(" + palmer.DaylightName + ") ": "" , 
                  palmer.GetAdjustmentRules().Length);
// Indicate whether new time zone supports DST
Console.WriteLine("{0} supports DST: {1}", palmer.StandardName, palmer.SupportsDaylightSavingTime);
' Define transition times to/from DST
Dim startTransition As TimeZoneInfo.TransitionTime = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#04:00:00#, 10, 2, DayOfWeek.Sunday) 
Dim endTransition As TimeZoneInfo.TransitionTime = TimeZoneInfo.TransitionTime.CreateFloatingDateRule(#3:00:00#, 3, 2, DayOfWeek.Sunday)
' Define adjustment rule
Dim delta As TimeSpan = New TimeSpan(1, 0, 0)
Dim adjustment As TimeZoneInfo.AdjustmentRule = TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule(#10/01/1999#, Date.MaxValue.Date, delta, startTransition, endTransition)
' Create array for adjustment rules
Dim adjustments() As TimeZoneInfo.AdjustmentRule = {adjustment}
' Define other custom time zone arguments
Dim displayName As String = "(GMT-04:00) Antarctica/Palmer Time"
Dim standardName As String = "Palmer Standard Time"
Dim daylightName As String = "Palmer Daylight Time"
Dim offset As TimeSpan = New TimeSpan(-4, 0, 0)
Dim palmer As TimeZoneInfo = TimeZoneInfo.CreateCustomTimeZone(standardName, offset, displayName, standardName, daylightName, adjustments, True)
' Indicate whether new time zone's adjustment rules are present
Console.WriteLine("{0} {1}has {2} adjustment rules.", _
                  palmer.StandardName, _
                  IIf(Not String.IsNullOrEmpty(palmer.DaylightName), "(" & palmer.DaylightName & ") ", ""), _
                  palmer.GetAdjustmentRules().Length)
' Indicate whether new time zone supports DST
Console.WriteLine("{0} supports DST: {1}", palmer.StandardName, palmer.SupportsDaylightSavingTime)

Hinweise

Mit dieser Überladung der-Methode TimeZoneInfo.CreateCustomTimeZone können Sie eine benutzerdefinierte Zeitzone erstellen, deren Unterstützung für die Sommerzeit durch Bedingungen zur Laufzeit bestimmt werden kann.You can use this overload of the TimeZoneInfo.CreateCustomTimeZone method to create a custom time zone whose support for daylight saving time can be determined by conditions at run time.

Die folgende Tabelle zeigt die Beziehung zwischen den Parametern, die für die TimeZoneInfo.CreateCustomTimeZone -Methode bereitgestellt werden, TimeZoneInfo und den Membern des-Objekts, die durch den-Methoden aufzurufen werden.The following table shows the relationship between the parameters that are provided to the TimeZoneInfo.CreateCustomTimeZone method and the members of the TimeZoneInfo object that are returned by the method call.

Parameter "kreatecustomtimezone"CreateCustomTimeZone parameter Timezoneingefo (Eigenschaft)TimeZoneInfo property
id Id
baseUtcOffset BaseUtcOffset
displayName DisplayName
standardDisplayName StandardName
daylightDisplayName DaylightNameWenn disableDaylightSavingTime ist false; String.Empty WenndisableDaylightSavingTime ist .trueDaylightName if disableDaylightSavingTime is false; String.Empty if disableDaylightSavingTime is true.
adjustmentRules Ein Array von TimeZoneInfo.AdjustmentRule -Objekten, die GetAdjustmentRules von der disableDaylightSavingTime - falseMethode zurückgegeben werden, wenn ist GetAdjustmentRules true. ein disableDaylightSavingTime leeres Array, das von der Methode zurückgegeben wirdAn array of TimeZoneInfo.AdjustmentRule objects returned by the GetAdjustmentRules method if disableDaylightSavingTime is false; an empty array returned by the GetAdjustmentRules method if disableDaylightSavingTime is true.
disableDaylightSavingTime Nicht SupportsDaylightSavingTime.Not SupportsDaylightSavingTime.

In der Regel sind der Standardzeit Name der Zeitzone und der zugehörige Bezeichner identisch.Typically, the time zone's standard time name and its identifier are the same. Allerdings sollte die Länge des Bezeichners der Zeitzone nicht länger als 32 Zeichen sein.However, the length of the time zone's identifier should not exceed 32 characters. Die an den displayName -Parameter übergebenen Zeichenfolge folgt einem Recht standardmäßigen Format.The string passed to the displayName parameter follows a fairly standard format. Der erste Teil des anzeigen Amens ist der Basis Offset der Zeitzone von der koordinierten Weltzeit, der durch das Akronym GMT (für die Greenwich Mean Time) in Klammern eingeschlossen wird.The first portion of the display name is the time zone's base offset from Coordinated Universal Time, which is indicated by the acronym GMT (for Greenwich Mean Time), enclosed in parentheses. Danach folgt eine Zeichenfolge, die die Zeitzone selbst, eine oder mehrere der Städte, Regionen oder Länder in der Zeitzone oder beides identifiziert.This is followed by a string that identifies the time zone itself, or one or more of the cities, regions, or countries in the time zone, or both. Beispiel:For example:

(GMT+02:00) Athens, Beirut, Istanbul, Minsk  
(GMT-02:00) Mid-Atlantic  
(GMT-07:00) Mountain Time (US & Canada)  

Die Anpassungsregeln einer Zeitzone werden wie folgt definiert:A time zone's adjustment rules are defined by doing the following:

  1. Aufrufen der CreateFloatingDateRule -Methode oder CreateFixedDateRule der-Methode, um die Anfangs-und endübergangs Regeln für jede Anpassungs Regel zu definieren.Calling either the CreateFloatingDateRule or the CreateFixedDateRule method to define the starting and ending transition rules for each adjustment rule.

  2. Aufrufen der CreateAdjustmentRule -Methode für jede Anpassungs Regel.Calling the CreateAdjustmentRule method for each adjustment rule.

  3. Zuweisen der Anpassungsregeln zu einem Array, das als adjustmentRules -Parameter übergeben werden kann.Assigning the adjustment rules to an array that can be passed as the adjustmentRules parameter.

Wenn disableDaylightSavingTime der- falseParameter ist, ist der Vorgang dieser Methode mit der TimeZoneInfo.CreateCustomTimeZone -Überladung identisch.If disableDaylightSavingTime parameter is false, the operation of this method is identical to the TimeZoneInfo.CreateCustomTimeZone overload. Wenn disableDaylightSavingTime DaylightName ist true, enthält das zurückgegebene-Objekt keine Anpassungsregeln und keine-Eigenschaft, deren Wert eine leere Zeichenfolge ist.If disableDaylightSavingTime is true, the returned object includes no adjustment rules and a DaylightName property whose value is an empty string.

Siehe auch

Gilt für: