TimeZoneInfo.TransitionTime Struct

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

TimeZoneInfo.TransitionTime.cs

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

type TimeZoneInfo.TransitionTime = struct
    interface IDeserializationCallback
    interface ISerializable

Public Structure TimeZoneInfo.TransitionTime
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo.TransitionTime), ISerializable

Inheritance

Object

ValueType

TimeZoneInfo.TransitionTime

Implements

IEquatable<TimeZoneInfo.TransitionTime> IDeserializationCallback ISerializable

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.