gmtime_s, _gmtime32_s, _gmtime64_s
구조에는 시간 값을 변환합니다.이러한 버전의 있습니다 _gmtime32, _gmtime64 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.
errno_t gmtime_s(
struct tm* _tm,
const __time_t* time
);
errno_t _gmtime32_s(
struct tm* _tm,
const __time32_t* time
);
errno_t _gmtime64_s(
struct tm* _tm,
const __time64_t* time
);
매개 변수
_tm
에 대 한 포인터를 tm 구조체입니다.반환 된 구조체의 필드는 계산된 된 값을 보유에서 timer 인수 로컬 시간이 아니라 UTC입니다.time
저장 된 시간에 대 한 포인터입니다.자정 이후 시간 (초) 경과 따라 시간 표시 (00: 00: 00), 1970 년 1 월 1 일 협정 세계시 (UTC)입니다.
반환 값
성공 하는 경우에 0입니다.실패 하면 반환 값은 오류 코드입니다.오류 코드는 errno.h에 정의 됩니다. 이러한 오류에 대 한 목록을 참조 하십시오. errno.
오류 조건
_tm |
time |
Return |
값_tm |
---|---|---|---|
NULL |
모든 |
EINVAL |
수정 되지 않았습니다. |
않은 NULL (올바른 메모리를 가리키는) |
NULL |
EINVAL |
모든 필드를-1로 설정 합니다. |
없습니다NULL |
< 0 |
EINVAL |
모든 필드를-1로 설정 합니다. |
첫 번째 두 오류 조건을 경우에 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.실행을 계속 수 있으면 이러한 함수를 설정 errno 에 EINVAL 를 반환 하 고 EINVAL.
설명
_gmtime32_s 함수를 세분화는 time 형식의 구조체에 저장 한 tm, time.h에 정의 된.전달 된 주소는 _tm.값은 time 에 대 한 호출에서 일반적으로 얻은 time 함수.
[!참고]
대상 환경 일광 절약 시간제 적용 되는지 결정 하십시오.C 런타임 라이브러리의 일광 절약 시간제 계산을 구현 하기 위한 미국 규칙을 가정 합니다.
각 구조체 필드 형식이 int, 다음 표에 나와 있는 것 처럼.
tm_sec
시간 (초) 후 1 분 (0-59).tm_min
분 (0-59).tm_hour
시간 (0-23).tm_mday
월 (1 – 31)의 일입니다.tm_mon
달 (0-11. 1 월 = 0).tm_year
1 년 (현재 연도 1900 뺀)입니다.tm_wday
요일 (0-6. 0 = 일요일).tm_yday
연간 일자 (0-365. 1 월 1 일 = 0).tm_isdst
항상 0에 대 한 gmtime.
_gmtime64_s를 사용 하 여 __time64_t 구조, 날짜의 23시 59분: 59부터, 3000, 12 월 31 UTC를 표현할 수 있습니다 반면, gmtime32_s 만-03시 14분: 07 2038 1 월 19 일에 UTC 날짜를 나타냅니다.자정 utc 1970 년 1 월 1 일을 모두 이러한 함수에 대 한 날짜 범위입니다.
gmtime_s산출 하는 인라인 함수 이며 _gmtime64_s 및 time_t 입니다 __time64_t.해석 하도록 컴파일러를 강제 하는 경우 time_t 로 이전 32 비트 time_t를 정의할 수 있습니다 _USE_32BIT_TIME_T.그러면 이렇게 하면 gmtime_s 에 인라인을 _gmtime32_s.2038 년 1 월 18 일 이후 응용 프로그램이 실패 하 고 64 비트 플랫폼에서 사용할 수 없습니다 때문에 권장 되지 않습니다.
요구 사항
루틴 |
필수 헤더 |
---|---|
gmtime_s |
<time.h> |
_gmtime32_s |
<time.h> |
_gmtime64_s |
<time.h> |
더 많은 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
예제
// crt_gmtime64_s.c
// This program uses _gmtime64_s to convert a 64-bit
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime_s to
// convert this structure to an output string.
#include <time.h>
#include <stdio.h>
int main( void )
{
struct tm newtime;
__int64 ltime;
char buf[26];
errno_t err;
_time64( <ime );
// Obtain coordinated universal time:
err = _gmtime64_s( &newtime, <ime );
if (err)
{
printf("Invalid Argument to _gmtime64_s.");
}
// Convert to an ASCII representation
err = asctime_s(buf, 26, &newtime);
if (err)
{
printf("Invalid Argument to asctime_s.");
}
printf( "Coordinated universal time is %s\n",
buf );
}
해당 .NET Framework 항목
참고 항목
참조
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
localtime_s, _localtime32_s, _localtime64_s