Share via


SYSTEMTIME Structure1

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at SYSTEMTIME Structure1.

The SYSTEMTIME 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;  

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

Structures, Styles, Callbacks, and Message Maps
CTime::CTime