DateTime.ToOADate Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Updated: May 2010

Converts the value of this instance to the equivalent OLE Automation date.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function ToOADate As Double
public double ToOADate()

Return Value

Type: System.Double
A double-precision floating-point number that contains an OLE Automation date equivalent to the value of this instance.

Exceptions

Exception Condition
OverflowException

The value of this instance cannot be represented as an OLE Automation date.

Remarks

An OLE Automation date is implemented as a floating-point number whose integral component is the number of days before or after 30 December 1899, and whose fractional component represents the time on that day divided by 24. For example, midnight, 31 December 1899 is represented by 1.0; 6 A.M., 1 January 1900 is represented by 2.25; midnight, 29 December 1899 is represented by -1.0; and 6 A.M., 29 December 1899 is represented by -1.25.

The base OLE Automation date is midnight, 30 December 1899. The minimum OLE Automation date is midnight, 1 January 0100. The maximum OLE Automation date is the same as MaxValue, the last moment of 31 December 9999.

The ToOADate method throws an OverflowException if the current instance represents a date that is later than MinValue and earlier than midnight on January1, 0100. However, if the value of the current instance is MinValue, the method returns 0.

For more information about OLE Automation, see the MSDN Library.

Version Information

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

Platforms

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

Change History

Date

History

Reason

May 2010

Expanded the Remarks section.

Customer feedback.