TimeZoneInfo.IsAmbiguousTime 메서드

정의

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC(협정 세계시) 시간에 매핑할 수 있는지 여부를 결정합니다.

오버로드

IsAmbiguousTime(DateTime)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC(협정 세계시) 시간에 매핑할 수 있는지 여부를 결정합니다.

IsAmbiguousTime(DateTimeOffset)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC(협정 세계시) 시간에 매핑할 수 있는지 여부를 결정합니다.

IsAmbiguousTime(DateTime)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC(협정 세계시) 시간에 매핑할 수 있는지 여부를 결정합니다.

public:
 bool IsAmbiguousTime(DateTime dateTime);
public bool IsAmbiguousTime (DateTime dateTime);
member this.IsAmbiguousTime : DateTime -> bool
Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

매개 변수

dateTime
DateTime

날짜 및 시간 값입니다.

반환

dateTime 매개 변수가 모호한 경우 true이고, 그렇지 않은 경우 false입니다.

예외

dateTime 값의 Kind 속성이 Local이고 dateTime이 잘못된 시간인 경우

예제

태평양 표준 시간대에서 일광 절약 시간은 2007년 11월 4일 오전 2:00에 끝납니다. 다음 예제에서는 2007년 11월 4일 오전 12시 59분부터 2007년 11월 4일 오전 2:01까지 IsAmbiguousTime(DateTime) 1분 간격으로 시간을 태평양 표준 시간대를 나타내는 개체의 TimeZoneInfo 메서드로 전달합니다. 콘솔 출력은 2007년 11월 4일 오전 1:00부터 2007년 11월 4일 오전 1:59까지의 모든 시간이 모호함을 나타냅니다.

   // Specify DateTimeKind in Date constructor
   DateTime baseTime = new DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified);
   DateTime newTime;

   // Get Pacific Standard Time zone
   TimeZoneInfo pstZone = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");

   // List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
   for (int ctr = 0; ctr < 63; ctr++)
   {
      // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
      newTime = baseTime.AddMinutes(ctr);   
      Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime));
   }
// Specify DateTimeKind in Date constructor
let baseTime = DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)

// Get Pacific Standard Time zone
let pstZone = TimeZoneInfo.FindSystemTimeZoneById "Pacific Standard Time"

// List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
for i = 0 to 62 do
// Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
    let newTime = baseTime.AddMinutes i   
    printfn $"{newTime} is ambiguous: {pstZone.IsAmbiguousTime newTime}"
' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)
Dim newTime As Date

' Get Pacific Standard Time zone
Dim pstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time")

' List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
For ctr As Integer = 0 To 62
   ' Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr)   
   Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime))
Next

설명

모호한 시간은 현재 표준 시간대의 시간 범위 내에 속합니다. 즉, 표준 시간 또는 시간 조정 규칙을 애플리케이션에서 발생 하는 수 있습니다. 일반적으로 모호한 시간은 클록이 일광 절약 시간에서 표준 시간으로 돌아가도록 설정된 경우 발생합니다. 일러스트레이션은 예제 섹션을 참조하세요.

UTC(협정 세계시)는 모호한 시간이 없습니다. 일광 절약 시간을 지원하지 않는 표준 시간대도 마찬가지입니다. 따라서 이러한 표준 시간대에는 조정 규칙이 없으며 메서드에 대한 호출은 IsAmbiguousTime 항상 를 반환 false합니다.

일광 절약 시간을 관찰하는 표준 시간대의 경우 다음 표와 같이 이 메서드의 정확한 동작은 속성과 TimeZoneInfo 개체 간의 Kind 관계에 따라 달라집니다.

TimeZoneInfo 개체 형식 Kind 속성 값 동작
TimeZoneInfo.Local DateTimeKind.Local 또는 DateTimeKind.Unspecified 매개 변수가 dateTime 모호한지 여부를 확인합니다.
TimeZoneInfo.Local DateTimeKind.Utc dateTime 를 현지 시간으로 변환한 다음 해당 시간이 모호한지 여부를 결정합니다.
TimeZoneInfo.Utc DateTimeKind.Utc 또는 DateTimeKind.Unspecified false를 반환합니다.
TimeZoneInfo.Utc DateTimeKind.Local 가 모호한 경우 dateTime 는 표준 시간이라고 가정하고 UTC로 변환한 다음 를 반환합니다 false.
다른 표준 시간대. DateTimeKind.Local 또는 DateTimeKind.Utc dateTime 지정된 표준 시간대의 시간으로 변환한 다음 해당 시간이 모호한지 여부를 결정합니다.
다른 표준 시간대. DateTimeKind.Unspecified 가 모호한지 여부를 dateTime 확인합니다.

추가 정보

적용 대상

IsAmbiguousTime(DateTimeOffset)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC(협정 세계시) 시간에 매핑할 수 있는지 여부를 결정합니다.

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);
public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);
member this.IsAmbiguousTime : DateTimeOffset -> bool
Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

매개 변수

dateTimeOffset
DateTimeOffset

날짜와 시간입니다.

반환

dateTimeOffset 매개 변수가 현재 표준 시간대에서 모호한 경우 true이고 그렇지 않은 경우 false입니다.

설명

모호한 시간은 현재 표준 시간대의 시간 범위 내에 속합니다. 이 표준 시간 또는 시간 조정 규칙을 애플리케이션에서 결과 사용할 수 있다는 것을 의미 합니다. 일반적으로 모호한 시간은 클록이 일광 절약 시간에서 표준 시간으로 돌아가도록 설정된 경우 발생합니다. UTC(협정 세계시)는 모호한 시간이 없습니다. 일광 절약 시간을 지원하지 않는 표준 시간대도 마찬가지입니다.

메서드의 정확한 동작은 매개 변수의 dateTimeOffset 속성과 현재 표준 시간대 간의 Offset 관계에 따라 달라집니다. 속성 값이 현재 표준 시간대의 Offset UTC에서 가능한 오프셋인 경우 메서드는 해당 날짜와 시간이 모호한지 여부를 결정합니다. 그렇지 않으면 현재 표준 시간대의 시간으로 변환 dateTimeOffset 한 다음 해당 날짜와 시간이 모호한지 여부를 결정합니다.

적용 대상