gmtime_s, _gmtime32_s, _gmtime64_s

아티클
04/10/2013

구조에는 시간 값을 변환합니다.이러한 버전의 있습니다 _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( &ltime );

   // Obtain coordinated universal time: 
   err = _gmtime64_s( &newtime, &ltime );
   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 );
}