LocalFileTimeToFileTime function (fileapi.h)

Converts a local file time to a file time based on the Coordinated Universal Time (UTC).

Syntax

BOOL LocalFileTimeToFileTime(
  [in]  const FILETIME *lpLocalFileTime,
  [out] LPFILETIME     lpFileTime
);

Parameters

[in] lpLocalFileTime

A pointer to a FILETIME structure that specifies the local file time to be converted into a UTC-based file time.

[out] lpFileTime

A pointer to a FILETIME structure to receive the converted UTC-based file time. This parameter cannot be the same as the lpLocalFileTime parameter.

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, use the GetLastError function.

Remarks

LocalFileTimeToFileTime uses the current settings for the time zone and daylight saving time. Therefore, if it is daylight saving time, this function will take daylight saving time into account, even if the time you are converting is in standard time.

Requirements

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

See also

FILETIME

FileTimeToLocalFileTime

Local Time

Time Functions