GetDateFormatWrapW 함수
[GetDateFormatWrapW 는 Windows XP에서 사용할 수 있습니다. 후속 버전에서는 사용할 수 없습니다. GetDateFormatW를 대신 사용해야 합니다.]
날짜를 지정된 로캘의 날짜 문자열로 서식을 지정합니다. 함수는 지정된 날짜 또는 로컬 시스템 날짜의 형식을 지정합니다.
참고
GetDateFormatWrapW 는 GetDateFormatW 함수의 래퍼입니다. 추가 사용량 정보는 GetDateFormat 페이지를 참조하세요.
구문
int GetDateFormatWrapW(
_In_ LCID Locale,
_In_ DWORD dwFlags,
_In_ const SYSTEMTIME *lpDate,
_In_ LPCWSTR pwzFormat,
_Out_ LPWSTR pwzDateStr,
_In_ int cchDate
);
매개 변수
-
로캘 [in]
-
형식: LCID
날짜 문자열의 서식을 지정할 로캘입니다. pwzFormat이 NULL인 경우 함수는 이 로캘의 날짜 형식에 따라 문자열의 형식을 지정합니다. pwzFormat이 NULL이 아닌 경우 함수는 그림 문자열 형식에 지정되지 않은 정보(예: 로캘의 일 및 월 이름)에만 로캘을 사용합니다.
이 매개 변수는 MAKELCID 매크로에서 만든 로캘 식별자이거나 다음과 같은 미리 정의된 값 중 하나일 수 있습니다.
-
LOCALE_SYSTEM_DEFAULT
-
기본 시스템 로캘입니다.
-
LOCALE_USER_DEFAULT
-
기본 사용자 로캘입니다.
dwFlags [in]
형식:DWORD
다양한 함수 옵션을 지정합니다. pwzFormat이 NULL이 아닌 경우 이 매개 변수는 0이어야 합니다. pwzFormat이 NULL인 경우 다음 값의 조합을 지정할 수 있습니다. DATE_YEARMONTH, DATE_SHORTDATE 또는 DATE_LONGDATE 지정하지 않고 pwzFormat 이 NULL인 경우 DATE_SHORTDATE 기본값으로 사용됩니다.
LOCALE_NOUSEROVERRIDE
설정된 경우 함수는 지정된 로캘에 대한 시스템 기본 날짜 형식을 사용하여 문자열의 형식을 지정합니다. 설정하지 않으면 함수는 로캘의 기본 날짜 형식에 대한 사용자 재정의를 사용하여 문자열의 형식을 지정합니다.
LOCALE_USE_CP_ACP
로캘의 코드 페이지 대신 문자열 번역에 시스템 ANSI 코드 페이지를 사용합니다.
DATE_SHORTDATE
짧은 날짜 형식을 사용합니다. 이 값은 DATE_LONGDATE 또는 DATE_YEARMONTH 사용할 수 없습니다.
DATE_LONGDATE
긴 날짜 형식을 사용합니다. 이 값은 DATE_SHORTDATE 또는 DATE_YEARMONTH 사용할 수 없습니다.
DATE_YEARMONTH
연도/월 형식을 사용합니다. 이 값은 DATE_SHORTDATE 또는 DATE_LONGDATE 사용할 수 없습니다.
DATE_USE_ALT_CALENDAR
대체 달력(있는 경우)을 사용하여 날짜 문자열의 서식을 지정합니다. 이 플래그가 설정된 경우 함수는 사용자 재정의를 사용하는 대신 해당 대체 달력의 기본 형식을 사용합니다. 사용자 재정의는 지정된 대체 일정에 대한 기본 형식이 없는 경우에만 사용됩니다.
DATE_LTRREADING
왼쪽에서 오른쪽 읽기 레이아웃에 대한 표시를 추가합니다. 이 값은 DATE_RTLREADING 사용할 수 없습니다.
DATE_RTLREADING
오른쪽에서 왼쪽 읽기 레이아웃에 대한 표시를 추가합니다. 이 값은 DATE_LTRREADING 사용할 수 없습니다.
lpDate [in]
형식: const SYSTEMTIME*
서식을 지정할 날짜 정보를 포함하는 SYSTEMTIME 구조체에 대한 포인터입니다. 이 포인터가 NULL이면 함수는 현재 로컬 시스템 날짜를 사용합니다.
pwzFormat [in]
형식: LPCWSTR
날짜 문자열을 형성하는 데 사용할 서식 그림에 대한 포인터입니다. pwzFormat이 NULL인 경우 함수는 지정된 로캘의 날짜 형식을 사용합니다. 자세한 내용은 GetDateFormat 을 참조하세요.
pwzDateStr [out]
형식: LPWSTR
서식이 지정된 날짜 문자열을 수신하는 버퍼에 대한 포인터입니다.
cchDate [in]
형식: int
pwzDateStr 버퍼의 크기를 문자 단위로 지정합니다. cchDate가 0이면 함수는 형식이 지정된 날짜 문자열을 보유하는 데 필요한 문자 수를 반환하며 pwzDateStr에서 가리키는 버퍼는 사용되지 않습니다.
반환 값
형식: int
함수가 성공하면 반환 값은 pwzDateStr이 가리키는 버퍼에 기록된 문자 수입니다. cchDate 매개 변수가 0이면 반환 값은 서식이 지정된 날짜 문자열을 보유하는 데 필요한 문자 수입니다. 개수에는 종료 null 문자가 포함됩니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. GetLastError 는 다음 오류 코드 중 하나를 반환할 수 있습니다.
-
ERROR_INSUFFICIENT_BUFFER
-
ERROR_INVALID_FLAGS
-
ERROR_INVALID_PARAMETER
설명
GetDateFormatWrapW 는 Windows XP 이전 운영 체제에서 유니코드 문자열을 사용하는 기능을 제공합니다. 기본 방법은 MsLU(Microsoft Layer for Unicode)와 함께 GetDateFormatW 를 사용하는 것입니다.
GetDateFormatWrapW 는 서수 311을 사용하여 Shlwapi.dll 직접 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|
추가 정보