FILETIME Structure

Structures | Win32 API Reference | Windows Drivers

MSDN > Documentation > Windows > API Reference > Win32 Structures > FILETIME

The FILETIME structure contains a date or time, expressed as the number of 100-nanosecond intervals since January 1, 1601 (UTC). A file's creation, last access, and last write times are stored in this format.

Syntax


typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME;

Members

  • dwLowDateTime: DWORD

    The low-order part of the file time.

  • dwHighDateTime: DWORD

    The high-order part of the file time.

Remarks

The FILETIME structure is a 64-bit value. To retrieve or set the value of a FILETIME structure, use the ULARGE_INTEGER structure.

The number of 100-nanosecond intervals that have elapsed since January 1, 1601 (UTC) is represented by the FILETIME structure. The maximum value for FILETIME represents approximately 30,000 years of UTC time.

Use the following functions to convert FILETIME structures to other time formats:

  • FileTimeToLocalFileTime
  • FileTimeToSystemTime
  • SystemTimeToFileTime

Requirements

Header: fileapi.h

Library: Kernel32.lib

DLL: Kernel32.dll

See Also