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

Header winbase.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Time Structures
GetLocalTime
GetSystemTime
SetLocalTime
SetSystemTime
FILETIME

Other Resources