VariantTimeToDosDateTime

INT VariantTimeToDosDateTime( 
  double  vtime,                  
  unsigned short FAR*  pwDosDate,  
  unsigned short FAR*  pwDosTime  
);
 

Converts the variant representation of a date and time to MS-DOS date and time values.

Parameters

vtime
The variant time to convert.
pwDosDate
Pointer to the location to store the converted MS-DOS date.
pwDosTime
Pointer to the location to store the converted MS-DOS time.

Return Value

The return value obtained from the returned INT is one of the following.

Result Meaning
True Success.
False Failure.

Comments

A variant time is stored as an 8-byte real value (double), representing a date between January 1, 1753 and December 31, 2078, inclusive. The value 2.0 represents January 1, 1900; 3.0 represents January 2, 1900, and so on. Adding 1 to the value increments the date by a day. The fractional part of the value represents the time of day. Therefore, 2.5 represents noon on January 1, 1900; 3.25 represents 6:00 a.m. on January 2, 1900, and so on. Negative numbers represent the dates prior to December 30, 1899.

For a description of the MS-DOS date and time formats, see DosDateTimeToVariantTime.

QuickInfo

  Windows NT: Use version 3.1 and later.
  Windows: Use Windows 95 and later.
  Header: Declared in oleauto.h.
  Import Library: Link with oleaut32.lib.