SetLocalTime
| 원형 |
BOOL SetLocalTime(CONST SYSTEMTIME *lpSystemTime); |
| MFC 원형 |
해당하는 함수 없음 |
| 인수 |
▶lpSystemTime : 설정할 로컬 시간을 가지고 있는 SYSTEMTIME 구조체 |
| 리턴 |
성공하면 0이 아닌 값을 리턴하고 실패하면 0을 리턴한다. |
| 설명 |
현재 로컬 시간을 lpSystemTime 구조체가 가진 시간으로 변경한다. 로컬 시간이란 시스템이 유지하는 시스템 시간(UTC)에서 현재 컴퓨터가 실행되고 있는 시간대와 일광절약 설정을 계산하여 변환한 시간이다. 대한민국의 로컬 시간은 UTC 시간보다 9시간 더 빠르다. 이 함수는 lpSystemTime 구조체의 로컬 시간에서 9시간을 빼서 시스템 시간을 변경해 준다. 따라서 현재 컴퓨터의 시간과 날짜를 변경하려면 이 함수를 사용하면 된다. SYSTEMTIME 구조체를 선언하고 이 구조체에 변경하고자 하는 날짜와 시간을 대입해 준 후 SetLocalTime 함수를 호출해 주면 된다. 이때 주의할 것은 SYSTEMTIME 구조체의 모든 멤버를 제대로 초기화해 주어야 한다는 점이다. 구조체 선언후 날짜 멤버만 설정한 상태로 이 함수를 호출하면 시, 분, 초 멤버가 쓰레기값을 가지고 있을 수 있으므로 제대로 시간을 바꾸지 못한다. 단, 이 함수는 요일을 wDayOfWeek 멤버는 무시한다. 요일은 날짜가 주어지면 자동으로 계산되는 것이므로 따로 설정할 수 없다. NT/2000 이상에서는 시간을 변경하려면 SE_SYSTEMTIME_NAME 특권이 있어야 한다. 이 함수는 특권을 먼저 설정한 후 시간을 갱신하므로 특별히 특권 프로그래밍을 할 필요는 없다. 시스템 시간은 모든 프로그램이 참조하는 중요한 정보이므로 프로그램이 함부로 수정해서는 안된다. 시스템 시간을 변경한 후에 모든 탑 레벨 윈도우게 WM_TIMECHANGE 메시지를 보내 주어야 한다. 예제 1 다음 예제는 현재 시스템 시간을 2002년 5월 5일 05:05분으로 변경한다. 마우스 왼쪽 버튼을 누르면 시간이 변경되며 오른쪽 버튼을 누르면 원래 시간으로 복구해 준다.
LRESULT CALLBACK WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
HDC hdc;
PAINTSTRUCT ps;
static SYSTEMTIME old;
SYSTEMTIME st;
char str[128];
switch(iMessage) {
case WM_CREATE:
SetTimer(hWnd, 1, 1000, NULL);
return 0;
case WM_LBUTTONDOWN:
GetLocalTime(&old);
st.wYear=2002;
st.wMonth=5;
st.wDay=5;
st.wHour=5;
st.wMinute=5;
st.wSecond=0;
st.wMilliseconds=0;
SetLocalTime(&st);
return 0;
case WM_RBUTTONDOWN:
SetLocalTime(&old);
return 0;
case WM_TIMER:
hdc=GetDC(hWnd);
GetLocalTime(&st);
wsprintf(str, "%d년 %d월 %d일 %d:%d:%d",
st.wYear, st.wMonth, st.wDay, st.wHour, st.wMinute, st.wSecond);
TextOut(hdc,10,10,str,lstrlen(str));
ReleaseDC(hWnd, hdc);
return 0;
case WM_PAINT:
hdc=BeginPaint(hWnd, &ps);
EndPaint(hWnd, &ps);
return 0;
case WM_DESTROY:
KillTimer(hWnd, 1);
SetLocalTime(&old);
PostQuitMessage(0);
return 0;
}
return(DefWindowProc(hWnd,iMessage,wParam,lParam));
}
이 예제는 실제로 컴퓨터의 시계를 바꾸는데 이 상태로 프로그램을 종료하면 컴퓨터의 시계가 엉망이 될 위험이 있으므로 WM_DESTROY에서 원래 시간으로 복구하도록 하였다. 단, 테스트 중에 흐른 시간만큼은 오차가 발생하므로 이 예제를 테스트해 본 후 원래 시간을 잘 맞춰 놓기 바란다. |
| 참고함수 |
GetLocalTime : 현재 로컬 시간을 조사한다. |
| 플랫폼 | 95이상 |
| 참조 |
|
|
written by http://www.winapi.co.kr
|