gmtime, _gmtime32, _gmtime64

아티클
04/10/2013

구조에는 시간 값을 변환 합니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see gmtime_s, _gmtime32_s, _gmtime64_s.

struct tm *gmtime( 
   const time_t *timer 
);
struct tm *_gmtime32( 
   const time32_t *timer 
);
struct tm *_gmtime64( 
   const __time64_t *timer 
);

매개 변수

timer
저장 된 시간에 대 한 포인터입니다.자정 이후 시간 (초) 경과 따라 시간 표시 (00: 00: 00), 1970 년 1 월 1 일 협정 세계시 (UTC)입니다.

반환 값

포인터 형식의 구조를 반환할 tm.반환 된 구조체의 필드는 계산된 된 값을 보유에서 timer 인수 로컬 시간이 아니라 UTC입니다.각 구조체 필드 형식이 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.

32 비트 및 64 비트 버전의 gmtime, mktime, mkgmtime, 및 localtime모든 단일 사용 tm 변환에 대 한 스레드 단위 구조입니다.이러한 함수 중 하나를 호출할 때마다 이전 호출의 결과 소멸 시킵니다.경우 timer 자정 utc 1970 년 1 월 1 일 이전 날짜를 나타내는 gmtime 반환 NULL.없음 오류가 반환이 됩니다.

_gmtime64사용 하는 __time64_t 구조, 반면 날짜까지 23시 59분: 59부터, 3000, 12 월 31 UTC로 표현 될 수 있습니다 _gmtime32 만-03시 14분: 07 2038 1 월 19 일에 UTC 날짜를 나타냅니다.자정 utc 1970 년 1 월 1 일을 모두 이러한 함수에 대 한 날짜 범위입니다.

gmtime산출 하는 인라인 함수 이며 _gmtime64 및 time_t 입니다 __time64_t.해석 하도록 컴파일러를 강제 하는 경우 time_t 로 이전 32 비트 time_t를 정의할 수 있습니다 _USE_32BIT_TIME_T.그러면 이렇게 하면 gmtime 에 인라인을 _gmtime32.2038 년 1 월 18 일 이후 응용 프로그램이 실패 하 고 64 비트 플랫폼에서 사용할 수 없습니다 때문에 권장 되지 않습니다.

이러한 함수는 매개 변수를 확인 합니다.경우 timer 는 null 포인터 또는 타이머 값이 음수 이면이 함수는 잘못 된 매개 변수 처리기의 설명에 따라 호출 매개 변수 유효성 검사.실행 계속 될 수 있습니다 경우에 함수 반환 NULL 를 설정 하 고 errno 에 EINVAL.

설명

_gmtime32 함수를 세분화를 timer 형식의 정적으로 할당 된 구조에서 저장 한 tm정의 된 시간에.H.값은 timer 에 대 한 호출에서 일반적으로 얻은 time 함수.

[!참고]

대상 환경 일광 절약 시간제 적용 되는지 결정 하십시오.C 런타임 라이브러리 일광 절약 시간제 (DST)의 계산을 구현 하는 미국 규칙을 가정 합니다.

요구 사항

루틴	필수 헤더
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_gmtime.c
// compile with: /W3
// This program uses _gmtime64 to convert a long-
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime to
// convert this structure to an output string.
 
#include <time.h>
#include <stdio.h>

int main( void )
{
   struct tm *newtime;
   __int64 ltime;
   char buff[80];

   _time64( &ltime );

   // Obtain coordinated universal time:
   newtime = _gmtime64( &ltime ); // C4996
   // Note: _gmtime64 is deprecated; consider using _gmtime64_s
   asctime_s( buff, sizeof(buff), newtime );
   printf( "Coordinated universal time is %s\n", buff );
}