Windows API Reference

FileTimeToSystemTime

The FileTimeToSystemTime function converts a file time to a system time.

Syntax


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

Parameters

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.

Remarks

A file time is a 64-bit value that represents the number of 100-nanosecond intervals since January 1, 1601 (UTC).

A system time is a structure that represents time in coordinated universal time (UTC) or local time, depending on the system's configuration.

Requirements

Minimum supported client Windows 2000 Professional

Minimum supported server Windows 2000 Server

Header Winbase.h (include Windows.h)

Library Kernel32.lib

DLL Kernel32.dll