TimeZoneInfo.IsDaylightSavingTime 메서드

정의

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the current TimeZoneInfo object's time zone.

오버로드

IsDaylightSavingTime(DateTimeOffset)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTime)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTimeOffset)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

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

매개 변수

dateTimeOffset
DateTimeOffset

날짜 및 시간 값입니다.A date and time value.

반환

Boolean

dateTimeOffset 매개 변수가 일광 절약 시간이면 true이고, 그렇지 않으면 false입니다.true if the dateTimeOffset parameter is a daylight saving time; otherwise, false.

설명

의 반환 값은 TimeZoneInfo.IsDaylightSavingTime 개체가 나타내는 표준 시간대 TimeZoneInfoOffset 매개 변수의 속성 간 관계의 영향을 받습니다 dateTimeOffset .The return value of TimeZoneInfo.IsDaylightSavingTime is affected by the relationship between the time zone represented by the TimeZoneInfo object and the Offset property of the dateTimeOffset parameter. dateTimeOffset이 utc (협정 세계시)를 기준으로 하는 현재 표준 시간대의 오프셋에 해당 하지 않는 경우 메서드는 해당 시간을 현재 표준 시간대의 시간으로 변환 합니다.If dateTimeOffset does not correspond to the current time zone's offset from Coordinated Universal Time (UTC), the method converts that time to the time in the current time zone. 그런 다음 해당 날짜와 시간이 일광 절약 시간 인지 여부를 확인 합니다.It then determines whether that date and time is a daylight saving time.

개체가 나타내는 표준 시간대 TimeZoneInfo 가 일광 절약 시간을 지원 하지 않는 경우 메서드는 항상 false 을 반환 합니다.If the time zone represented by the TimeZoneInfo object does not support daylight saving time, the method always returns false. 표준 시간대가 일광 절약 시간을 지원 하는지 여부를 확인 하려면 해당 속성의 값을 검색 SupportsDaylightSavingTime 합니다.To determine whether a time zone supports daylight saving time, retrieve the value of its SupportsDaylightSavingTime property.

추가 정보

적용 대상

IsDaylightSavingTime(DateTime)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

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

매개 변수

dateTime
DateTime

날짜 및 시간 값입니다.A date and time value.

반환

Boolean

dateTime 매개 변수가 일광 절약 시간이면 true이고, 그렇지 않으면 false입니다.true if the dateTime parameter is a daylight saving time; otherwise, false.

예외

dateTime 값의 Kind 속성이 Local이고 dateTime이 잘못된 시간인 경우The Kind property of the dateTime value is Local and dateTime is an invalid time.

예제

다음 예제에서는 메서드를 사용 하 여 DisplayDateWithTimeZoneName TimeZoneInfo.IsDaylightSavingTime 표준 시간대의 표준 시간 이름 또는 일광 절약 시간 이름을 표시할지 여부를 결정 하는 라는 메서드를 정의 합니다.The following example defines a method named DisplayDateWithTimeZoneName that uses the TimeZoneInfo.IsDaylightSavingTime method to determine whether to display a time zone's standard time name or daylight saving time name.

private void DisplayDateWithTimeZoneName(DateTime date1, TimeZoneInfo timeZone)
{
   Console.WriteLine("The time is {0:t} on {0:d} {1}", 
                     date1, 
                     timeZone.IsDaylightSavingTime(date1) ?
                         timeZone.DaylightName : timeZone.StandardName);   
}
// The example displays output similar to the following:
//    The time is 1:00 AM on 4/2/2006 Pacific Standard Time   
Private Sub DisplayDateWithTimeZoneName(date1 As Date, timeZone As TimeZoneInfo)
   Console.WriteLine("The time is {0:t} on {0:d} {1}", _
                     date1, _
                     IIf(timeZone.IsDaylightSavingTime(date1), _
                         timezone.DaylightName, timezone.StandardName))   
End Sub
' The example displays output similar to the following:
'    The time is 1:00 AM on 4/2/2006 Pacific Standard Time   

설명

의 반환 값은 TimeZoneInfo.IsDaylightSavingTime TimeZoneInfo 다음 표와 같이 개체가 나타내는 표준 시간대와 Kind 매개 변수의 속성 간 관계의 영향을 받습니다 dateTime .The return value of TimeZoneInfo.IsDaylightSavingTime is affected by the relationship between the time zone represented by the TimeZoneInfo object and the Kind property of the dateTime parameter, as the following table shows.

TimeZoneInfo 개체TimeZoneInfo object DateTime.Kind 속성DateTime.Kind property 결과Result
TimeZoneInfo.Local DateTimeKind.Local 일광 절약 시간 인지 여부를 확인 dateTime 합니다.Determines whether dateTime is daylight saving time.
TimeZoneInfo.Local DateTimeKind.Utc dateTimeUtc (협정 세계시)를 현지 시간으로 변환 하 고 일광 절약 시간 인지 여부를 확인 합니다.Converts dateTime from Coordinated Universal Time (UTC) to local time and determines whether it is daylight saving time.
TimeZoneInfo.Local DateTimeKind.Unspecified dateTime 현지 시간을 나타내며 일광 절약 시간 인지 여부를 확인 합니다.Assumes that dateTime represents local time and determines whether it is daylight saving time.
TimeZoneInfo.Utc DateTimeKind.Local, DateTimeKind.Unspecified또는 DateTimeKind.UtcDateTimeKind.Local, DateTimeKind.Unspecified, or DateTimeKind.Utc 반환 false (UTC는 일광 절약 시간을 지원 하지 않음)Returns false (UTC does not support daylight saving time).
다른 모든 TimeZoneInfo 개체입니다.Any other TimeZoneInfo object. DateTimeKind.Local 현지 시간을 개체의 해당 하는 시간으로 변환한 TimeZoneInfo 다음 후자가 일광 절약 시간 인지 여부를 확인 합니다.Converts the local time to the equivalent time of the TimeZoneInfo object and then determines whether the latter is daylight saving time.
다른 모든 TimeZoneInfo 개체입니다.Any other TimeZoneInfo object. DateTimeKind.Utc UTC를 개체의 해당 하는 시간으로 변환한 TimeZoneInfo 다음 후자가 일광 절약 시간 인지 여부를 확인 합니다.Converts UTC to the equivalent time of the TimeZoneInfo object and then determines whether the latter is daylight saving time.
다른 모든 TimeZoneInfo 개체입니다.Any other TimeZoneInfo object. DateTimeKind.Unspecified 일광 절약 시간 인지 여부를 확인 dateTime 합니다.Determines whether dateTime is daylight saving time.

개체가 나타내는 표준 시간대 TimeZoneInfo 가 일광 절약 시간을 지원 하지 않는 경우 메서드는 항상 false 을 반환 합니다.If the time zone represented by the TimeZoneInfo object does not support daylight saving time, the method always returns false. 를 비롯 한 여러 표준 시간대는 Utc 일광 절약 시간을 준수 하지 않습니다.A number of time zones, including Utc, do not observe daylight saving time. 표준 시간대가 일광 절약 시간을 지원 하는지 여부를 확인 하려면 해당 속성의 값을 검색 SupportsDaylightSavingTime 합니다.To determine whether a time zone supports daylight saving time, retrieve the value of its SupportsDaylightSavingTime property.

dateTime매개 변수가 현재 개체의 표준 시간대에 모호한 시간을 지정 하는 경우 TimeZoneInfo.IsDaylightSavingTime 메서드는 dateTime 표준 시간으로 해석 하 고 false Kind 속성이 또는 인 경우를 반환 합니다 DateTimeKind.Local DateTimeKind.Unspecified .If the dateTime parameter specifies an ambiguous time in the current object's time zone, the TimeZoneInfo.IsDaylightSavingTime method interprets dateTime as standard time and returns false if its Kind property is DateTimeKind.Local or DateTimeKind.Unspecified. Kind속성이 인 경우 DateTimeKind.Utc 이 메서드는 적절 한 모호한 시간을 선택 하 고 일광 절약 시간 인지 여부를 나타냅니다.If the Kind property is DateTimeKind.Utc, this method will select the correct ambiguous time and indicate whether it is a daylight saving time.

메서드는 TimeZoneInfo.IsDaylightSavingTime(DateTime) false 모호한 날짜 및 시간 (즉, 특정 표준 시간대에서 표준 시간 또는 일광 절약 시간을 나타낼 수 있는 날짜 및 시간)에 대해를 반환할 수 있기 때문에 메서드를 사용 하 여 TimeZoneInfo.IsAmbiguousTime(DateTime) IsDaylightSavingTime(DateTime) 시간에 일광 절약 시간이 발생할 수 있는지 여부를 확인할 수 있습니다.Because the TimeZoneInfo.IsDaylightSavingTime(DateTime) method can return false for a date and time that is ambiguous (that is, a date and time that can represent either a standard time or a daylight saving time in a particular time zone), the TimeZoneInfo.IsAmbiguousTime(DateTime) method can be paired with the IsDaylightSavingTime(DateTime) method to determine whether a time may be a daylight saving time. 모호한 시간은 일광 절약 시간과 표준 시간을 둘 다 사용할 수 있기 때문에 IsAmbiguousTime(DateTime) 메서드를 먼저 호출 하 여 날짜와 시간이 일광 절약 시간 인지 여부를 확인할 수 있습니다.Because an ambiguous time is one that can be both a daylight saving time and a standard time, the IsAmbiguousTime(DateTime) method can be called first to determine whether a date and time may be a daylight saving time. 메서드가 false 를 반환 하는 경우 IsDaylightSavingTime(DateTime) 메서드를 호출 하 여 값이 일광 절약 시간 인지 여부를 확인할 수 있습니다 DateTime .If the method returns false, the IsDaylightSavingTime(DateTime) method can be called to determine whether the DateTime value is a daylight saving time. 다음 예제에서는이 방법을 보여 줍니다.The following example illustrates this technique.

DateTime unclearDate = new DateTime(2007, 11, 4, 1, 30, 0);
// Test if time is ambiguous.
Console.WriteLine("In the {0}, {1} is {2}ambiguous.", 
                  TimeZoneInfo.Local.DisplayName, 
                  unclearDate, 
                  TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) ? "" : "not ");
// Test if time is DST.
Console.WriteLine("In the {0}, {1} is {2}daylight saving time.", 
                  TimeZoneInfo.Local.DisplayName, 
                  unclearDate, 
                  TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate) ? "" : "not ");
Console.WriteLine();    
// Report time as DST if it is either ambiguous or DST.
if (TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) || 
    TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate))
    Console.WriteLine("{0} may be daylight saving time in {1}.", 
                      unclearDate, TimeZoneInfo.Local.DisplayName);  
// The example displays the following output:
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is ambiguous.
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is not daylight saving time.
//    
//    11/4/2007 1:30:00 AM may be daylight saving time in (GMT-08:00) Pacific Time (US & Canada).
Dim unclearDate As Date = #11/4/2007 1:30AM#
' Test if time is ambiguous.
Console.WriteLine("In the {0}, {1} is {2}ambiguous.", _ 
                  TimeZoneInfo.Local.DisplayName, _
                  unclearDate, _
                  IIf(TimeZoneInfo.Local.IsAmbiguousTime(unclearDate), "", "not "))
' Test if time is DST.
Console.WriteLine("In the {0}, {1} is {2}daylight saving time.", _ 
                  TimeZoneInfo.Local.DisplayName, _
                  unclearDate, _
                  IIf(TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate), "", "not "))
Console.WriteLine()    
' Report time as DST if it is either ambiguous or DST.
If TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) OrElse _ 
   TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate) Then
    Console.WriteLine("{0} may be daylight saving time in {1}.", _ 
                      unclearDate, TimeZoneInfo.Local.DisplayName)                                           
End If
' The example displays the following output:
'    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is ambiguous.
'    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is not daylight saving time.
'    
'    11/4/2007 1:30:00 AM may be daylight saving time in (GMT-08:00) Pacific Time (US & Canada).

dateTime매개 변수가 잘못 된 시간을 지정 하는 경우 매개 변수의 속성 값이 이면 메서드 호출에서을 throw 하 ArgumentException dateTime 고, Kind DateTimeKind.Local 그렇지 않으면 메서드는을 반환 합니다 false .If the dateTime parameter specifies an invalid time, the method call throws an ArgumentException if the value of the dateTime parameter's Kind property is DateTimeKind.Local; otherwise, the method returns false.

표준 시간대 TimeZoneInfo.IsDaylightSavingTime 이름을 표시 하는 경우 메서드를 호출 하 여 표준 시간대의 값 또는 해당 값을 사용할지 여부를 결정 StandardName DaylightName 합니다.Call the TimeZoneInfo.IsDaylightSavingTime method to determine whether to use a time zone's StandardName value or its DaylightName value when displaying the time zone name. 예시는 예제 섹션을 참조 하십시오.See the Example section for an illustration.

추가 정보

적용 대상