DateTimeOffset Implicit Conversion (DateTime to DateTimeOffset)
Defines an implicit conversion of a DateTime object to a DateTimeOffset object.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- dateTime
- Type: System::DateTime
The object to convert.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The Coordinated Universal Time (UTC) date and time that results from applying the offset is earlier than MinValue. -or- The UTC date and time that results from applying the offset is later than MaxValue. |
The Implicit method enables the compiler to automatically convert a DateTime object to a DateTimeOffset object without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). It defines a widening conversion that does not involve data loss and does not throw an OverflowException. The Implicit method makes code such as the following possible:
This method is equivalent to the DateTimeOffset constructor. The offset of the resulting DateTimeOffset object depends on the value of the DateTime::Kind property of the dateTime parameter:
If the value of the DateTime::Kind property is DateTimeKind::Utc, the date and time of the DateTimeOffset object is set equal to dateTime, and its Offset property is set equal to 0.
If the value of the DateTime::Kind property is DateTimeKind::Local or DateTimeKind::Unspecified, the date and time of the DateTimeOffset object is set equal to dateTime, and its Offset property is set equal to the offset of the local system's current time zone.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, 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.