SYSTEMTIME Structure

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

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

Parameters

• wYear
  The current year.

• wMonth
  The current month; January is 1.

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

• wDay
  The current day of the month.

• wHour
  The current hour.

• wMinute
  The current minute.

• wSecond
  The current second.

• wMilliseconds
  The current millisecond.

Example

// Retrieves the current system date and time.  The system 
// time is expressed in Coordinated Universal Time (UTC). 
SYSTEMTIME systime;
GetSystemTime(&systime);

// Determine day of the week.
CString day;
switch (systime.wDayOfWeek)
{
   case 0:
      day = _T("Sunday");
   break;

   case 1:
      day = _T("Monday");
   break;

   case 2:
      day = _T("Tuesday");
   break;

   case 3:
      day = _T("Wednesday");
   break;

   case 4:
      day = _T("Thursday");
   break;

   case 5:
      day = _T("Friday");
   break;

   case 6:
      day = _T("Saturday");
   break;
}

// Show the time in a message box.
CString str;
str.Format(_T("%s %u/%u/%u  %u:%u:%u:%u"), day,
   systime.wYear, systime.wMonth, systime.wDay,
   systime.wHour, systime.wMinute, systime.wSecond,
   systime.wMilliseconds);

AfxMessageBox(str);

Requirements

Header: winbase.h

See Also

Concepts

Structures, Styles, Callbacks, and Message Maps

CTime::CTime