FileTimeToSystemTime Function

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

Syntax

C++ 
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 clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinbase.h (include Windows.h)
LibraryKernel32.lib
DLLKernel32.dll

See Also

DosDateTimeToFileTime
File Times
FILETIME
FileTimeToDosDateTime
SYSTEMTIME
SystemTimeToFileTime
Time Functions

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Community Content

dmex
vb.net syntax
<DllImport("Kernel32.dll", SetLastError:=True)> _
Public Shared Function FileTimeToSystemTime(ByRef FileTime As FILETIME, ByRef SystemTime As SYSTEMTIME) As Long
End Function
Tags : vb.net syntax

dmex
C# syntax
[DllImport("Kernel32.dll", SetLastError=true)]
private static extern long FileTimeToSystemTime(ref FILETIME FileTime, ref SYSTEMTIME SystemTime);
Tags : c# syntax

Thomas Lee
UTC or not?
It'd be nice if the function documented whether the time returned is in UTC or local time. I can deduce that since FILETIME is in UTC this should return a UTC time, but it's possible the function does a conversion. I shouldn't have to test it to find out.
Tags : contentbug

Page view tracker