DateTimeOffset.LocalDateTime 속성

정의

현재 DateTime 개체의 현지 날짜 및 시간을 나타내는 DateTimeOffset 값을 가져옵니다.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

속성 값

현재 DateTimeOffset 개체의 현지 날짜와 시간입니다.The local date and time of the current DateTimeOffset object.

예제

다음 예제에서는 미국 태평양 표준 시간대의 현지 시간으로 DateTimeOffset 값을 변환 하는 몇 가지 방법을 보여 줍니다.The following example illustrates several conversions of DateTimeOffset values to local times in the U.S. Pacific Standard Time zone. 마지막 세 번은 모호한 모든; note 속성은 단일 날짜 및 태평양 표준 시간대의 시간에 모두를 매핑합니다.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      

설명

필요한 경우 LocalDateTime 속성은 현재 DateTimeOffset 개체의 날짜와 시간을 로컬 시스템의 날짜 및 시간으로 변환 합니다.If necessary, the LocalDateTime property converts the current DateTimeOffset object's date and time to the local system's date and time. 변환 작업이 2 단계:The conversion is a two-step operation:

  1. 속성은 현재 DateTimeOffset 개체의 시간을 UTC (협정 세계시)로 변환 합니다.The property converts the current DateTimeOffset object's time to Coordinated Universal Time (UTC).

  2. 그런 다음 속성을 현지 시간 UTC를 변환합니다.The property then converts UTC to local time.

잘못 된 경우가 있습니다 및 모호한 시간을 현지 시간대의 표준 시간으로 매핑됩니다.There are no invalid times and ambiguous times are mapped to the local zone's standard time. 그러나 변환에서 비정상을 만들 수 있습니다. 로컬 컴퓨터에서 파생 된 DateTimeOffset 값이 모호한 날짜와 시간을 반영 하는 경우 해당 값을 UTC로 변환한 다음 원래 시간과 다른 현지 시간으로 되돌릴 수 있습니다. 속성은이 변환을 수행할 때 현지 표준 시간대의 조정 규칙을 적용 합니다.(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.

이 속성은 DateTimeOffset 개체의 날짜 및 시간 구성 요소를 모두 반환 합니다 .이 구성 요소를 사용 하면 DateTimeOffsetDateTime 하는 데 유용 합니다.This property returns both the date and the time component of a DateTimeOffset object, which makes it useful for DateTimeOffset to DateTime conversion. 필요한 시간 변환을 수행 하는 것 외에도이 속성은 반환 된 DateTime 개체의 Kind 속성 값을 DateTimeKind.Local로 설정 하 여 DateTime 속성과 다릅니다.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.

적용 대상

추가 정보