TimeZoneInfo.TransitionTime Struct

Definition

Provides information about a specific time change, such as the change from daylight saving time to standard time or vice versa, in a particular time zone.

public: value class TimeZoneInfo::TransitionTime : IEquatable<TimeZoneInfo::TransitionTime>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public readonly struct TimeZoneInfo.TransitionTime : IEquatable<TimeZoneInfo.TransitionTime>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
public struct TimeZoneInfo.TransitionTime : IEquatable<TimeZoneInfo.TransitionTime>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[System.Serializable]
public struct TimeZoneInfo.TransitionTime : IEquatable<TimeZoneInfo.TransitionTime>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo.TransitionTime = struct
    interface IDeserializationCallback
    interface ISerializable
[<System.Serializable>]
type TimeZoneInfo.TransitionTime = struct
    interface ISerializable
    interface IDeserializationCallback
Public Structure TimeZoneInfo.TransitionTime
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo.TransitionTime), ISerializable
Inheritance
TimeZoneInfo.TransitionTime
Attributes
Implements

Remarks

You can use the TimeZoneInfo.TransitionTime structure to indicate when a transition from standard time to daylight saving time, or from daylight saving time back to standard time, occurs. This structure supports both fixed-date rules and floating-date rules. Use fixed-date rules for time transitions that occur on a specific day of a specific month (such as 2:00 A.M. on November 3). Use floating-date rules for time transitions that occur on a specific day of a specific week of a specific month (such as 2:00 A.M. on the first Sunday of November).

The following table compares the properties used in fixed-date and floating-date transitions:

Month Week Day Time
Fixed-date rule Month N/A Day TimeOfDay
Floating-date rule Month Week DayOfWeek TimeOfDay

For both fixed-date and floating-date transitions, the TimeOfDay property gets the time at which the time change occurs. For transitions from standard to daylight saving time, this is the time zone's standard time value. For transitions from daylight saving to standard time, this is the time zone's daylight saving time value. This is a DateTime value whose date component is ignored; its year, month, and day value must always equal 1.

Note

An instance of the TimeZoneInfo.TransitionTime structure is immutable. Once an object has been created, its values cannot be modified.

A TimeZoneInfo.TransitionTime object can be created by calling the static (Shared in Visual Basic) CreateFixedDateRule and CreateFloatingDateRule methods to create a fixed or floating-date rule, respectively. The starting and ending TimeZoneInfo.TransitionTime objects are then supplied as parameters to the CreateAdjustmentRule method to create a new adjustment rule that includes this transition time information.

The DaylightTransitionStart and DaylightTransitionEnd properties of an TimeZoneInfo.AdjustmentRule object return a TimeZoneInfo.TransitionTime object.

Properties

Day

Gets the day on which the time change occurs.

DayOfWeek

Gets the day of the week on which the time change occurs.

IsFixedDateRule

Gets a value indicating whether the time change occurs at a fixed date and time (such as November 1) or a floating date and time (such as the last Sunday of October).

Month

Gets the month in which the time change occurs.

TimeOfDay

Gets the hour, minute, and second at which the time change occurs.

Week

Gets the week of the month in which a time change occurs.

Methods

CreateFixedDateRule(DateTime, Int32, Int32)

Defines a time change that uses a fixed-date rule (that is, a time change that occurs on a specific day of a specific month).

CreateFloatingDateRule(DateTime, Int32, Int32, DayOfWeek)

Defines a time change that uses a floating-date rule (that is, a time change that occurs on a specific day of a specific week of a specific month).

Equals(Object)

Determines whether an object has identical values to the current TimeZoneInfo.TransitionTime object.

Equals(TimeZoneInfo+TransitionTime)

Determines whether the current TimeZoneInfo.TransitionTime object has identical values to a second TimeZoneInfo.TransitionTime object.

GetHashCode()

Serves as a hash function for hashing algorithms and data structures such as hash tables.

Operators

Equality(TimeZoneInfo+TransitionTime, TimeZoneInfo+TransitionTime)

Determines whether two specified TimeZoneInfo.TransitionTime objects are equal.

Inequality(TimeZoneInfo+TransitionTime, TimeZoneInfo+TransitionTime)

Determines whether two specified TimeZoneInfo.TransitionTime objects are not equal.

Explicit Interface Implementations

IDeserializationCallback.OnDeserialization(Object)

Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Populates a SerializationInfo object with the data that is required to serialize this object.

Applies to