FileTimeToSystemTime function

Converts a file time to system time format. System time is based on Coordinated Universal Time (UTC).

Syntax

BOOL FileTimeToSystemTime(
  const FILETIME *lpFileTime,
  LPSYSTEMTIME   lpSystemTime
);

Parameters

lpFileTime

A pointer to a FILETIME structure containing the file time to be converted to system (UTC) date and time format.

This value must be less than 0x8000000000000000. Otherwise, the function fails.

lpSystemTime

A pointer to a SYSTEMTIME structure to receive the converted file time.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

   
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

DosDateTimeToFileTime

FILETIME

File Times

FileTimeToDosDateTime

SYSTEMTIME

SystemTimeToFileTime

Time Functions