DaylightTime Class
Defines the period of daylight saving time.
Assembly: mscorlib (in mscorlib.dll)
The DaylightTime type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() | Delta | Gets the TimeSpan that represents the difference between the standard time and the daylight saving time. |
![]() ![]() | End | Gets the DateTime that represents the date and time when the daylight saving period ends. |
![]() ![]() | Start | Gets the DateTime that represents the date and time when the daylight saving period begins. |
| Name | Description | |
|---|---|---|
![]() ![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() ![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() ![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() ![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
Daylight saving time is a period during the year when the time is advanced, usually by an hour, to take advantage of the extended daylight hours. At the end of the period, the time is set back to the standard time.
The DaylightTime class is used extensively by members of the System::TimeZone class.
The following code example uses the TimeZone::GetDaylightChanges(Int32) method to return the daylight saving time period and offset for selected years.
// Example of the TimeZone::GetDaylightChanges( int ) method. using namespace System; using namespace System::Globalization; void CreateDaylightTime( int year, TimeZone^ localZone ) { // Create a DaylightTime object for the specified year. DaylightTime^ daylight = localZone->GetDaylightChanges( year ); // Display the start and end dates and the time change. Console::WriteLine( "{0,-7}{1,-20:yyyy-MM-dd HH:mm}" "{2,-20:yyyy-MM-dd HH:mm}{3}", year, daylight->Start, daylight->End, daylight->Delta ); } int main() { String^ headFmt = "{0,-7}{1,-20}{2,-20}{3}"; // Get the local time zone. TimeZone^ localZone = TimeZone::CurrentTimeZone; Console::WriteLine( "This example of TimeZone::GetDaylightChanges( int ) " "generates the \nfollowing output, which varies " "depending on the time zone in which \nit is run. The " "example creates DaylightTime objects for specified \n" "years and displays the start and end dates and time " "change for \ndaylight saving time.\n" ); // Write a message explaining that start dates prior to 1986 // in the en-US culture may not be correct. // ( CultureInfo::CurrentCulture->Name == S"en-US" ) returns False. if ( CultureInfo::CurrentCulture->Name->CompareTo( "en-US" ) == 0 ) { Console::WriteLine( "Note: In the [en-US] culture, all start dates are " "calculated from \nthe first Sunday in April, based on " "a standard set in 1986. For \ndates prior to 1986, " "the calculated start date may not be accurate." ); } Console::WriteLine( "\nLocal time: {0}\n", localZone->StandardName ); Console::WriteLine( headFmt, "Year", "Start", "End", "Change" ); Console::WriteLine( headFmt, "----", "-----", "---", "------" ); CreateDaylightTime( 1960, localZone ); CreateDaylightTime( 1970, localZone ); CreateDaylightTime( 1980, localZone ); CreateDaylightTime( 1990, localZone ); CreateDaylightTime( 2000, localZone ); CreateDaylightTime( 2001, localZone ); CreateDaylightTime( 2002, localZone ); CreateDaylightTime( 2003, localZone ); CreateDaylightTime( 2004, localZone ); CreateDaylightTime( 2005, localZone ); CreateDaylightTime( 2020, localZone ); CreateDaylightTime( 2040, localZone ); } /* This example of TimeZone::GetDaylightChanges( int ) generates the following output, which varies depending on the time zone in which it is run. The example creates DaylightTime objects for specified years and displays the start and end dates and time change for daylight saving time. Note: In the [en-US] culture, all start dates are calculated from the first Sunday in April, based on a standard set in 1986. For dates prior to 1986, the calculated start date may not be accurate. Local time: Pacific Standard Time Year Start End Change ---- ----- --- ------ 1960 1960-04-03 02:00 1960-10-30 02:00 01:00:00 1970 1970-04-05 02:00 1970-10-25 02:00 01:00:00 1980 1980-04-06 02:00 1980-10-26 02:00 01:00:00 1990 1990-04-01 02:00 1990-10-28 02:00 01:00:00 2000 2000-04-02 02:00 2000-10-29 02:00 01:00:00 2001 2001-04-01 02:00 2001-10-28 02:00 01:00:00 2002 2002-04-07 02:00 2002-10-27 02:00 01:00:00 2003 2003-04-06 02:00 2003-10-26 02:00 01:00:00 2004 2004-04-04 02:00 2004-10-31 02:00 01:00:00 2005 2005-04-03 02:00 2005-10-30 02:00 01:00:00 2020 2020-04-05 02:00 2020-10-25 02:00 01:00:00 2040 2040-04-01 02:00 2040-10-28 02:00 01:00:00 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.



