Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DateTimeOffset Implicit Conversion (DateTime to DateTimeOffset)

Defines an implicit conversion of a DateTime object to a DateTimeOffset object.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
public static implicit operator DateTimeOffset (
	DateTime dateTime
)

Parameters

dateTime
Type: System.DateTime
The object to convert.

Return Value

Type: System.DateTimeOffset
The converted object.
ExceptionCondition
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:


DateTimeOffset timeWithOffset;
timeWithOffset = new DateTime(1008, 7, 3, 18, 45, 0);
outputBlock.Text += timeWithOffset.ToString() + "\n";

timeWithOffset = DateTime.UtcNow;
outputBlock.Text += timeWithOffset.ToString() + "\n";

timeWithOffset = DateTime.SpecifyKind(DateTime.Now,
                                      DateTimeKind.Unspecified);
outputBlock.Text += timeWithOffset.ToString() + "\n";

timeWithOffset = new DateTime(2008, 1, 1, 2, 30, 0) +
                 new TimeSpan(1, 0, 0, 0);
outputBlock.Text += timeWithOffset.ToString() + "\n";
// The example produces the following output if run on 3/20/2007 
// at 6:25 PM on a computer in the U.S. Pacific Daylight Time zone:
//       7/3/2008 6:45:00 PM -07:00
//       3/21/2007 1:25:52 AM +00:00
//       3/20/2007 6:25:52 PM -07:00
//       1/2/2008 2:30:00 AM -08:00      


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:

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.