SYSTEMTIME 구조체(minwinbase.h)

2024-02-29

월, 일, 연도, 평일, 시간, 분, 초 및 밀리초에 대한 개별 멤버를 사용하여 날짜 및 시간을 지정합니다. 시간은 호출되는 함수에 따라 UTC(협정 세계시) 또는 현지 시간입니다.

구문

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

멤버

wYear

연도 이 멤버의 유효한 값은 1601~30827입니다.

wMonth

월입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
1	January
2	February
3	3월
4	April
5	5월
6	6월
7	7월
8	8월
9	9월
10	10월
11	11월
12	12월

wDayOfWeek

요일입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
0	일요일
1	월요일
2	화요일
3	수요일
4	목요일
5	금요일
6	토요일

wDay

날짜입니다. 이 멤버의 유효한 값은 1~31입니다.

wHour

시간입니다. 이 멤버의 유효한 값은 0~23입니다.

wMinute

분입니다. 이 멤버의 유효한 값은 0~59입니다.

wSecond

초입니다. 이 멤버의 유효한 값은 0~59입니다.

wMilliseconds

밀리초입니다. 이 멤버의 유효한 값은 0~999입니다.

설명

참고

SYSTEMTIME은 표시된 날짜가 실제 날짜이고 유효한 날짜인지 확인하기 위해 검사 않습니다. 이 API를 사용하는 경우 특히 윤년 시나리오에서 유효성을 확인해야 합니다. 자세한 내용은 윤일 준비를 참조하세요.

상대적인 시간을 얻기 위해 SYSTEMTIME 구조체에서 값을 추가하고 빼는 것은 권장되지 않습니다. 대신, 다음을 수행해야 합니다.

SYSTEMTIME 구조를 FILETIME 구조체로 변환합니다.
결과 FILETIME 구조를 ULARGE_INTEGER 구조체에 복사합니다.
ULARGE_INTEGER 값에 일반 64비트 산술 연산을 사용합니다.

시스템은 시간 원본과 동기화하여 주기적으로 시간을 새로 고칠 수 있습니다. 시스템 시간을 앞으로 또는 뒤로 조정할 수 있으므로 시스템 시간 판독값을 비교하여 경과 시간을 결정하지 마세요. 대신 Windows 시간에 설명된 방법 중 하나를 사용합니다.

예제

다음 예제에서는 GetSystemTime 함수에서 검색한 시간 값과 GetLocalTime 함수 간의 차이를 보여 줍니다.

#include <windows.h>
#include <stdio.h>

void main()
{
    SYSTEMTIME st, lt;
    
    GetSystemTime(&st);
    GetLocalTime(&lt);
    
    printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
}

// Sample output

The system time is: 19:34
 The local time is: 12:34

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
머리글	minwinbase.h(Windows.h 포함)