The SystemTimeToVariantTime method converts a system time object to it's Variant equivalent.
A DATE, or Variant Time Object, is stored as an 8-byte real value (double) representing a date between January 1, 100 and December 31, 9999, 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.
This method was needed for Windows Mobile devices running software prior to Pocket PC 2000. Its current implementation simply calls the Windows Embedded CE function SystemTimeToVariantTime, passing the same parameters. (
DATE is type-defined as
double in the file wtypes.h.)