SYSTEMTIME

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure represents a date and time using individual members for the month, day, year, weekday, hour, minute, second, and millisecond.

Syntax

typedef struct _SYSTEMTIME {
  WORD wYear;
  WORD wMonth;
  WORD wDayOfWeek;
  WORD wDay;
  WORD wHour;
  WORD wMinute;
  WORD wSecond;
  WORD wMilliseconds;
} SYSTEMTIME;

Members

• wYear
  Specifies the current year.

• wMonth
  Specifies the current month; 1 indicates January, 2 February, and so on.

• wDayOfWeek
  Specifies the current day of the week; Sunday = 0, Monday = 1, and so on.

• wDay
  Specifies the current day of the month.

• wHour
  Specifies the current hour.

• wMinute
  Specifies the current minute.

• wSecond
  Specifies the current second.

• wMilliseconds
  Specifies the current millisecond.

Remarks

Millisecond granularity may not be supported by a hardware platform. The caller of this function should not rely on more than second granularity. It is not recommended that you add and subtract values from this structure to obtain relative times.

The following list shows tasks to perform instead:

• Convert the SYSTEMTIME structure to a FILETIME structure.
• Copy the resulting FILETIME structure to a ULARGE_INTEGER structure.
• Use usual 64-bit arithmetic on the ULARGE_INTEGER value.

Requirements

See Also

Reference

Time Structures
GetLocalTime
GetSystemTime
SetLocalTime
SetSystemTime
FILETIME

Other Resources