Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

TimeZoneInfo.Local-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft ein TimeZoneInfo-Objekt ab, das die lokale Zeitzone darstellt.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static TimeZoneInfo Local { get; }

Eigenschaftswert

Type: System.TimeZoneInfo

Ein Objekt, das die lokale Zeitzone darstellt.

Die lokale Zeitzone ist die Zeitzone auf dem Computer, auf dem der Code ausgeführt wird.

System_CAPS_importantWichtig

Sollten Sie stets über die lokale Zeitzone zugreifen der TimeZoneInfo.Local Eigenschaft anstatt der lokalen Zeit zone eine TimeZoneInfo Object-Variablen. Dies verhindert, dass die TimeZoneInfo Objektvariable aus wird durch einen Aufruf für ungültig erklärt die ClearCachedData Methode.

Die TimeZoneInfo zurückgegebenes Objekt die TimeZoneInfo.Local Eigenschaft spiegelt wider, die Einstellung von der passen Sie die Uhr für die Sommerzeit Änderungen automatisch an Kontrollkästchen oder die automatisch die Uhr für die Sommerzeit angepasst Kontrollkästchen in der Systemsteuerung Datum und Uhrzeit für Windows XP und Windows Vista, bzw. Wenn das Kontrollkästchen deaktiviert ist, enthält die zwischengespeicherte Kopie der lokalen Zeitzone keine Informationen für die Sommerzeit an. Dies bedeutet Folgendes:

Dies ist "true", jedoch nicht, wenn ein Verweis auf die lokale Zeitzone abgerufen wird mithilfe der FindSystemTimeZoneById Methode.

Die Local Eigenschaft entspricht der CurrentTimeZone Eigenschaft von der TimeZone Klasse.

Hinweise für Aufrufer:

Beim Konvertieren von Datumsangaben und Uhrzeiten, Windows XP erkennt nur die aktuelle Anpassungsregel, die er ohne Ausnahmen gilt, einschließlich früherer Datumsangaben (d. h., Datumsangaben, die älter als das Anfangsdatum des aktuellen Anpassungsregel sind). Auf Windows XP, um zu verhindern, dass lokale Datums- und Uhrzeitinformationen gebotenen der Local -Sitzungsobjekts gehen auseinander anhand der Datums- und Uhrzeitangabe Informationen, die in der Taskleiste angezeigt der TimeZoneInfo zurückgegebenes Objekt die Local -Eigenschaft gilt auch die aktuellen Anpassungsregel für früherer Datumsangaben. Anwendungen auf Windows XP , erfordern in der Vergangenheit genau Lokales Datum und Uhrzeit-Berechnungen müssen dieses Verhalten mit umgehen der FindSystemTimeZoneById Methode zum Abrufen einer TimeZoneInfo Objekt, das die lokale Zeitzone entspricht.

Das folgende Beispiel enthält ein Beispiel für eine Windows XP System in den USA Zeitzone Pacific anzuzeigen. Da die ersten drei alle Methodenaufrufe verwenden der lokalen Zeitzone zurückgegebenes der Local -Eigenschaft, gelten die aktuelle Zeitzone Anpassungsregel (der Effekt in 2007 eingeflossen) in ein Datum im Jahr 2006. Die aktuelle Anpassungsregel sorgt für den Übergang zur Sommerzeit am zweiten Sonntag im März ausgeführt; die vorherige Regel, die faktisch in 2006 zur Verfügung gestellt, für den Übergang zur Sommerzeit an der ersten Sonntag im April ausgeführt wurde. Nur die vierte-Methodenaufruf verwendet die FindSystemTimeZoneById Methode zum Abrufen der lokalen Zeitzone führt genau diese historische Datums- und Zeit-Konvertierung.

using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2006, 3, 21, 2, 0, 0);

      Console.WriteLine(date1.ToUniversalTime());
      Console.WriteLine(TimeZoneInfo.ConvertTimeToUtc(date1));
      Console.WriteLine(TimeZoneInfo.ConvertTimeToUtc(date1, TimeZoneInfo.Local));

      TimeZoneInfo tz = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");  
      Console.WriteLine(TimeZoneInfo.ConvertTimeToUtc(date1, tz));     
   }
}
// The example displays the following output on Windows XP systems:
//       3/21/2006 9:00:00 AM
//       3/21/2006 9:00:00 AM
//       3/21/2006 9:00:00 AM
//       3/21/2006 10:00:00 AM

Das folgende Beispiel ruft eine TimeZoneInfo Objekt, das die lokale Zeitzone darstellt, und gibt seine Anzeigenamen, der Name der Standardzeit und der Sommerzeit.

using System;

public class Example
{
   public static void Main()
   {
      TimeZoneInfo localZone = TimeZoneInfo.Local;
      Console.WriteLine("Local Time Zone ID: {0}", localZone.Id);
      Console.WriteLine("   Display Name is: {0}.", localZone.DisplayName);
      Console.WriteLine("   Standard name is: {0}.", localZone.StandardName);
      Console.WriteLine("   Daylight saving name is: {0}.", localZone.DaylightName); 
   }
}
// The example displays output like the following:
//     Local Time Zone ID: Pacific Standard Time
//        Display Name is: (UTC-08:00) Pacific Time (US & Canada).
//        Standard name is: Pacific Standard Time.
//        Daylight saving name is: Pacific Daylight Time.

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: