TimeZoneInfo.IsDaylightSavingTime TimeZoneInfo.IsDaylightSavingTime TimeZoneInfo.IsDaylightSavingTime Method

정의

지정된 날짜 및 시간이 현재 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) IsDaylightSavingTime(DateTimeOffset) 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) IsDaylightSavingTime(DateTime) 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) IsDaylightSavingTime(DateTimeOffset) 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

매개 변수

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

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

반환

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

설명

반환 값 TimeZoneInfo.IsDaylightSavingTime 영향을 나타내는 표준 시간대 간의 관계를 TimeZoneInfo 개체 및 Offset 의 속성을 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) IsDaylightSavingTime(DateTime) 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

매개 변수

dateTime
DateTime DateTime DateTime

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

반환

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 변환 dateTime 현지 시간을 utc (협정 세계시)에서 일광 절약 시간 인지 여부를 결정 합니다.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.

추가 정보

적용 대상