DateTimeOffset.LocalDateTime Eigenschaft

Definition

Ruft einen DateTime-Wert ab, der die Datums- und Uhrzeitkomponente des aktuellen DateTimeOffset-Objekts darstellt.Gets a DateTime value that represents the local date and time of the current DateTimeOffset object.

public:
 property DateTime LocalDateTime { DateTime get(); };
public DateTime LocalDateTime { get; }
member this.LocalDateTime : DateTime
Public ReadOnly Property LocalDateTime As DateTime

Eigenschaftswert

Die lokale Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts.The local date and time of the current DateTimeOffset object.

Beispiele

Das folgende Beispiel veranschaulicht verschiedene Konvertierungen DateTimeOffset von Werten in lokale Uhrzeiten in den USA. „Pacific Standard Time“ (USA) ausgeführt wird.The following example illustrates several conversions of DateTimeOffset values to local times in the U.S. Pacific Standard Time zone. Beachten Sie, dass die letzten drei Male alle mehrdeutig sind. die-Eigenschaft ordnet alle Elemente einem einzelnen Datum und einer Uhrzeit in der Pacific Standard Time Zone zu.Note that the last three times are all ambiguous; the property maps all of them to a single date and time in the Pacific Standard Time zone.

 DateTimeOffset dto;

 // Current time
 dto = DateTimeOffset.Now;
 Console.WriteLine(dto.LocalDateTime);
 // UTC time
 dto = DateTimeOffset.UtcNow;
 Console.WriteLine(dto.LocalDateTime);

// Transition to DST in local time zone occurs on 3/11/2007 at 2:00 AM
 dto = new DateTimeOffset(2007, 3, 11, 3, 30, 0, new TimeSpan(-7, 0, 0));      
 Console.WriteLine(dto.LocalDateTime);
 dto = new DateTimeOffset(2007, 3, 11, 2, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(dto.LocalDateTime);
 // Invalid time in local time zone
 dto = new DateTimeOffset(2007, 3, 11, 2, 30, 0, new TimeSpan(-8, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsInvalidTime(dto.DateTime));
 Console.WriteLine(dto.LocalDateTime);

 // Transition from DST in local time zone occurs on 11/4/07 at 2:00 AM
 // This is an ambiguous time
 dto = new DateTimeOffset(2007, 11, 4, 1, 30, 0, new TimeSpan(-7, 0, 0));
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 dto = new DateTimeOffset(2007, 11, 4, 2, 30, 0, new TimeSpan(-7, 0, 0));           
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 // This is also an ambiguous time
 dto = new DateTimeOffset(2007, 11, 4, 1, 30, 0, new TimeSpan(-8, 0, 0));           
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto));
 Console.WriteLine(dto.LocalDateTime);
 // If run on 3/8/2007 at 4:56 PM, the code produces the following
 // output:
 //    3/8/2007 4:56:03 PM
 //    3/8/2007 4:56:03 PM
 //    3/11/2007 3:30:00 AM
 //    3/11/2007 1:30:00 AM
 //    True
 //    3/11/2007 3:30:00 AM
 //    True
 //    11/4/2007 1:30:00 AM
 //    11/4/2007 1:30:00 AM
 //    True
 //    11/4/2007 1:30:00 AM      
 Dim dto As DateTimeOffset

 ' Current time
 dto = DateTimeOffset.Now
 Console.WriteLine(dto.LocalDateTime)
 ' UTC time
 dto = DateTimeOffset.UtcNow
 Console.WriteLine(dto.LocalDateTime)

' Transition to DST in local time zone occurs on 3/11/2007 at 2:00 AM
 dto = New DateTimeOffset(#03/11/2007 3:30AM#, New Timespan(-7, 0, 0))      
 Console.WriteLine(dto.LocalDateTime)
 dto = New DateTimeOffset(#03/11/2007 2:30AM#, New Timespan(-7, 0, 0))
 Console.WriteLine(dto.LocalDateTime)
 ' Invalid time in local time zone
 dto = New DateTimeOffset(#03/11/2007 2:30AM#, New Timespan(-8, 0, 0))
 Console.WriteLine(TimeZoneInfo.Local.IsInvalidTime(dto.DateTime))
 Console.WriteLine(dto.LocalDateTime)

 ' Transition from DST in local time zone occurs on 11/4/07 at 2:00 AM
 ' This is an ambiguous time
 dto = New DateTimeOffset(#11/4/2007 1:30AM#, New TimeSpan(-7, 0, 0))
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto))
 Console.WriteLine(dto.LocalDateTime)
 dto = New DateTimeOffset(#11/4/2007 2:30AM#, New TimeSpan(-7, 0, 0))           
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto))
 Console.WriteLine(dto.LocalDateTime)
 ' This is also an ambiguous time
 dto = New DateTimeOffset(#11/4/2007 1:30AM#, New TimeSpan(-8, 0, 0))           
 Console.WriteLine(TimeZoneInfo.Local.IsAmbiguousTime(dto))
 Console.WriteLine(dto.LocalDateTime)
 ' If run on 3/8/2007 at 4:56 PM, the code produces the following
 ' output:
 '    3/8/2007 4:56:03 PM
 '    3/8/2007 4:56:03 PM
 '    3/11/2007 3:30:00 AM
 '    3/11/2007 1:30:00 AM
 '    True
 '    3/11/2007 3:30:00 AM
 '    True
 '    11/4/2007 1:30:00 AM
 '    11/4/2007 1:30:00 AM
 '    True
 '    11/4/2007 1:30:00 AM      

Hinweise

Bei Bedarf konvertiert die LocalDateTime -Eigenschaft das Datum DateTimeOffset und die Uhrzeit des aktuellen-Objekts in das Datum und die Uhrzeit des lokalen Systems.If necessary, the LocalDateTime property converts the current DateTimeOffset object's date and time to the local system's date and time. Die Konvertierung ist ein zweistufiger Vorgang:The conversion is a two-step operation:

  1. Die-Eigenschaft konvertiert die DateTimeOffset Uhrzeit des aktuellen-Objekts in eine koordinierte Weltzeit (UTC).The property converts the current DateTimeOffset object's time to Coordinated Universal Time (UTC).

  2. Die-Eigenschaft konvertiert dann UTC in die lokale Zeit.The property then converts UTC to local time.

Es sind keine ungültigen Zeiten und mehrdeutige Zeiten der Standardzeit der lokalen Zone zugeordnet.There are no invalid times and ambiguous times are mapped to the local zone's standard time. (Bei der Konvertierung kann jedoch eine Anomalieerkennung erstellt DateTimeOffset werden: Wenn ein Wert, der vom lokalen Computer abgeleitet ist, ein mehrdeutiges Datum und eine mehrdeutige Uhrzeit widerspiegelt, kann dieser Wert in UTC und dann zurück in eine Ortszeit konvertiert werden, die sich von der ursprünglichen Uhrzeit unterscheidet.) Die-Eigenschaft wendet alle Anpassungsregeln in der lokalen Zeitzone an, wenn diese Konvertierung durchführt.(However, the conversion can create an anomaly: if a DateTimeOffset value that is derived from the local computer reflects an ambiguous date and time, that value can be converted to UTC and then back to a local time that differs from the original time.) The property applies any adjustment rules in the local time zone when it performs this conversion.

Diese Eigenschaft gibt sowohl das Datum als auch die Uhrzeit Komponente eines DateTimeOffset -Objekts zurück, das DateTime für DateTimeOffset die Konvertierung nützlich ist.This property returns both the date and the time component of a DateTimeOffset object, which makes it useful for DateTimeOffset to DateTime conversion. Zusätzlich zur Durchführung einer notwendigen Zeit Konvertierung unterscheidet sich diese Eigenschaft von DateTime der-Eigenschaft, indem der Wert Kind der-Eigenschaft des DateTime zurückgegebenen DateTimeKind.Local-Objekts auf festgelegt wird.In addition to performing any necessary time conversion, this property differs from the DateTime property by setting the value of the Kind property of the returned DateTime object to DateTimeKind.Local.

Gilt für:

Siehe auch