SYSTEMTIME 구조체(minwinbase.h)
월, 일, 연도, 평일, 시간, 분, 초 및 밀리초에 대한 개별 멤버를 사용하여 날짜 및 시간을 지정합니다. 시간은 호출되는 함수에 따라 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
월입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
January |
|
February |
|
March |
|
April |
|
5월 |
|
6월 |
|
7월 |
|
8월 |
|
9월 |
|
10월 |
|
11월 |
|
12월 |
wDayOfWeek
요일입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
일요일 |
|
월요일 |
|
화요일 |
|
수요일 |
|
목요일 |
|
금요일 |
|
토요일 |
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비트 산술 연산을 사용합니다.
예제
다음 예제에서는 GetSystemTime 과 GetLocalTime 함수에서 검색한 시간 값 간의 차이를 보여 줍니다.
#include <windows.h>
#include <stdio.h>
void main()
{
SYSTEMTIME st, lt;
GetSystemTime(&st);
GetLocalTime(<);
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 포함) |