_get_tzname
시간대 이름 또는 일광 절약 시간제 표준 시간 영역 이름 (DST) 의 문자 문자열 표현을 검색합니다.
errno_t _get_tzname(
size_t* pReturnValue,
char* timeZoneName,
size_t sizeInBytes,
int index
);
매개 변수
[out] pReturnValue
NULL 종결자를 포함한 timeZoneName 의 문자열 길이.[out] timeZoneName
index 에 따라 시간대 이름 또는 일광 절약 시간제 표준 시간 영역 이름 (DST) 의 표현에 대한 문자 문자열의 주소.[in] sizeInBytes
timeZoneName 문자 문자열의 크기(바이트)입니다.[in] index
검색할 두 시간대 이름 중 하나의 인덱스.
반환 값
성공적이면 0, 그렇지 않은 경우 errno 형식 값.
timeZoneName 가 NULL 이거나, 또는 sizeInBytes 0 이거나 0 보다 작은 경우(둘 다는 아님), 매개 변수 유효성 검사 처럼 잘못된 매개 변수 처리기가 적용됩니다. 계속해서 실행하도록 허용된 경우, 함수는 errno 를 EINVAL 에 설정하고 EINVAL을 반환합니다.
오류 조건
pReturnValue |
timeZoneName |
sizeInBytes |
index |
반환 값 |
timeZoneName의 내용입니다. |
---|---|---|---|---|---|
TZ 이름의 크기 |
NULL |
0 |
0 또는 1 |
0 |
수정 안 됨 |
TZ 이름의 크기 |
any |
> 0 |
0 또는 1 |
0 |
TZ 이름 |
수정 안 됨 |
NULL |
> 0 |
any |
EINVAL |
수정 안 됨 |
수정 안 됨 |
any |
0 |
any |
EINVAL |
수정 안 됨 |
수정 안 됨 |
any |
> 0 |
> 1 |
EINVAL |
수정 안 됨 |
설명
_get_tzname 함수는 pReturnValue 에서의 문자열의 크기와 함게 인덱스 값에 따라 timeZoneName 의 주소에 표준 시간대 이름 또는 일광 절약 시간제 표준 시간 영역 이름 (DST) 의 문자 문자열 표현을 검색합니다. timeZoneName 이 NULL 이고 sizeInBytes 이 0 일 경우, 두 시간대의 문자열의 크기(바이트)는 pReturnValue 로 반환됩니다. 인덱스 값은 표준 시간대일 경우 0 이고 일광 절약 표준 시간대일 경우 1 이어야 합니다. 다른 인덱스 값은 정의 되지 않은 결과를 가집니다.
인덱스 값
index |
timeZoneName의 내용입니다. |
timeZoneName 기본값 |
---|---|---|
0 |
표준 시간대 이름 |
"PST" |
1 |
일광 절약 표준 시간대 이름 |
"PDT" |
> 1 또는 < 0 |
errno 을 EINVAL 로 설정 |
수정 안 됨 |
런타임 동안 값이 명시적으로 변경되지 않는한 기본값은 각각 "PST" 및 "PDT" 입니다. 이러한 문자 배열의 크기는 TZNAME_MAX 값에 따라 관리 됩니다.
요구 사항
루틴 |
필수 헤더 |
---|---|
_get_tzname |
<time.h> |
자세한 내용은 호환성을 참조하십시오.
해당 .NET Framework 항목
해당 사항 없음. 표준 C 함수를 호출하려면 PInvoke를 사용합니다. 자세한 내용은 플랫폼 호출 예제를 참조하십시오.