DateTime.ToOADate Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Converts the value of this instance to the equivalent OLE Automation date.
public:
double ToOADate();public double ToOADate ();member this.ToOADate : unit -> doublePublic Function ToOADate () As DoubleReturns
A double-precision floating-point number that contains an OLE Automation date equivalent to the value of this instance.
Exceptions
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 midnight, 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 DateTime.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 MaxValue and earlier than midnight on January1, 0100. However, if the value of the current instance is MinValue, the method returns 0.
For more information, see Automation.
