Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The VariantTimeToSystemTimemethod converts the Variant representation of time to it's System Time equivalent.

Syntax 

HRESULT VariantTimeToSystemTime(
  DATE 
date,
   SYSTEMTIME * 
pst
);

Parameters

date

[in] The Variant time date object to convert.

pst

[out] Reference to system time equivalent. For information about the SYSTEMTIMEstructure, see SYSTEMTIME.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

The method completed successfully.

Remarks

A Variant time 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 VariantTimeToSystemTime, passing the same parameters. ( DATEis type-defined as doublein the file wtypes.h.)

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also