Export (0) Print
Expand All

DateTime.ToOADate Method

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

[Visual Basic]
Public Function ToOADate() As Double
[C#]
public double ToOADate();
[C++]
public: double ToOADate();
[JScript]
public function ToOADate() : double;

Return Value

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

Exceptions

Exception Type 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 value is the number of days from midnight, 30 December 1899. 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 represented by -1.0; and 6 A.M., 29 December 1899 represented by -1.25.

Only DateTime objects with a tick value that is greater than or equal to positive or negative 31241376000000000 can be represented as an OLE Automation Date. An uninitialized DateTime, that is, an instance with a tick value of 0, is converted to the equivalent uninitialized OLE Automation Date, that is, a date with a value of 0.0 which represents midnight, 30 December 1899.

Note   The Ticks value of a DateTime is between MinValue and MaxValue.
Note   The maximum value of a DateTime is equal to the maximum value of an OLE Automation Date.

See FromOADate and the MSDN Online Libary at http://msdn.microsoft.com/library/default.asp for more information about OLE Automation.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

DateTime Structure | DateTime Members | System Namespace | Double | FromOADate

Show:
© 2014 Microsoft