gmtime, _gmtime32, _gmtime64

Článek
03/26/2013

Převeďte časovou hodnotu struktury.Bezpečnější verze tyto funkce jsou k dispozici; 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 
);

Parametry

timer
Ukazatel času uložené.Čas je reprezentován jako sekund uplynulých od půlnoci (00: 00), 1. ledna 1970, koordinovaný světový čas (UTC).

Vrácená hodnota

Vrátí ukazatel na strukturu typu tm.Pole vrácené struktury podržte vyhodnocené hodnoty timer argument v UTC, nikoli v místním čase.Každé pole struktura je typu int, takto:

tm_sec
Sekund po minuta (0-59).
tm_min
Minut po hodině (0-59).
tm_hour
Hodin od půlnoci (0-23).
tm_mday
Den v měsíci (1-31).
tm_mon
Měsíc (0 – 11; Ledna = 0).
tm_year
Rok (aktuální rok minus 1900).
tm_wday
Den v týdnu (0 – 6; Neděle = 0).
tm_yday
Den roku (0 – 365; Ledna = 0).
tm_isdst
Vždy 0 pro gmtime.

Obě 32bitové a 64bitové verze gmtime, mktime, mkgmtime, a localtimepoužívat jeden tm struktury na podproces pro převod.Každé volání do jedné z těchto funkcí ničí výsledek jakékoli předchozí volání.Pokud timer představuje datum před půlnoci 1. ledna 1970, gmtime vrátí NULL.Neexistuje žádná chyba návratu.

_gmtime64, která používá __time64_t struktury, že umožňuje data vyjádřeno až 23: 59: 59, do 31. prosince 3000 UTC, _gmtime32 představují pouze data prostřednictvím 03: 14: 07 19 01.01.08, UTC.Půlnoc, 1. ledna 1970 je dolní mez rozsah dat pro obě tyto funkce.

gmtimevložené funkce, jehož výsledkem je _gmtime64 a time_t je ekvivalentní __time64_t.Chcete-li vynutit kompilátor interpretace time_t jako staré 32-bit time_t, můžete definovat _USE_32BIT_TIME_T.Tím dojde k gmtime se v technologii kanálů umožňuje na _gmtime32.Nedoporučuje se, protože aplikace může selhat po 18 01.01.08, a není povoleno na 64bitových platformách.

Tyto funkce ověřit jejich parametrů.Pokud timer je ukazatel hodnotu null nebo pokud je záporná hodnota časovače, tyto funkce vyvolat obslužnou rutinu neplatný parametr popsaným v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí funkce NULL a errno na EINVAL.

Poznámky

_gmtime32 Funkce rozdělí timer hodnotu a ukládá staticky přidělené struktury typu tm, definované v čase.H.Hodnota timer se obvykle získá z volání time funkce.

[!POZNÁMKA]

Cílové prostředí se pokuste zjistit, zda je v platnosti letní čas.C Runtime library předpokládá USA pravidla pro výpočet letní čas (DST).

Požadavky

Rutina	Požadované záhlaví
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

// 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 );
}