Converts a file time to system time format. System time is based on Coordinated Universal Time (UTC).
Syntax
BOOL WINAPI FileTimeToSystemTime(
__in const FILETIME *lpFileTime,
__out LPSYSTEMTIME lpSystemTime
);
Parameters
- lpFileTime [in]
-
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 [out]
-
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.
Examples
For an example, see
Retrieving the Last-Write Time.
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 |
See Also
- DosDateTimeToFileTime
- File Times
- FILETIME
- FileTimeToDosDateTime
- SYSTEMTIME
- SystemTimeToFileTime
- Time Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009