SystemTimeToTzSpecificLocalTime 함수(timezoneapi.h)

아티클
03/05/2024

UTC(협정 세계시)의 시간을 지정된 표준 시간대의 해당 현지 시간으로 변환합니다.

구문

BOOL SystemTimeToTzSpecificLocalTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpUniversalTime,
  [out]          LPSYSTEMTIME                lpLocalTime
);

매개 변수

[in, optional] lpTimeZoneInformation

관심 있는 표준 시간대를 지정하는 TIME_ZONE_INFORMATION 구조체에 대한 포인터입니다.

lpTimeZone이 NULL인 경우 함수는 현재 활성 표준 시간대를 사용합니다.

[in] lpUniversalTime

변환할 UTC 시간을 지정하는 SYSTEMTIME 구조체에 대한 포인터입니다. 함수는 이 범용 시간을 지정된 표준 시간대의 해당 현지 시간으로 변환합니다.

[out] lpLocalTime

현지 시간을 수신하는 SYSTEMTIME 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 0이 아니고 함수는 lpLocalTime이 가리키는 SYSTEMTIME 구조체의 멤버를 적절한 현지 시간 값으로 설정합니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

SystemTimeToTzSpecificLocalTime 함수는 시스템 시간을 변환할 현지 시간에 DST(일광 절약 시간)가 적용되는지 여부를 고려합니다.

SystemTimeToTzSpecificLocalTime 함수는 다음 조건에서 현지 시간을 잘못 계산할 수 있습니다.

표준 시간대는 이전 및 새 연도에 대해 다른 UTC 오프셋을 사용합니다.
변환할 UTC 시간과 계산된 현지 시간은 서로 다른 연도입니다.

예제

예제는 Last-Write 시간 검색을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	timezoneapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll