Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

ConvertSystemTimeToCalDateTime function

Deprecated. Converts a specified SYSTEMTIME structure to a CALDATETIME structure.


BOOL ConvertSystemTimeToCalDateTime(
  _In_  const SYSTEMTIME    lpSysTime,
  _In_        CALID         calId,
  _Out_       LPCALDATETIME lpCalDateTime



lpSysTime [in]

Pointer to the SYSTEMTIME structure to convert.

calId [in]

The system calendar identifier to use in the conversion.

lpCalDateTime [out]

Pointer to the equivalent CALDATETIME structure.

Return value

Returns TRUE if successful or FALSE otherwise. To get extended error information, the application can call GetLastError, which can return one of the following error codes:

  • ERROR_INVALID_PARAMETER. Any of the parameter values was invalid.


The earliest date supported by this function is January 1, 1601.

This function does not have an associated header file or library file. The application can call LoadLibrary with the DLL name (Kernel32.dll) to obtain a module handle. It can then call GetProcAddress with the module handle and the name of this function to get the function address.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]



See also

National Language Support
National Language Support Functions
Retrieving Time and Date Information



Community Additions

© 2015 Microsoft