gmtime, _gmtime32, _gmtime64

2013-03-26

Konwertowanie wartości czasu, do struktury.Bezpieczniejsze wersje te funkcje są dostępne; 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
Wskaźnik, aby czas przechowywane.Czas jest reprezentowana jako sekund, jaka upłynęła od północy (00: 00), 1 stycznia 1970 roku skoordynowanego czasu uniwersalnego (UTC).

Wartość zwracana

Zwraca wskaźnik do struktury typu tm.Pola struktury zwracane przytrzymaj oceniana wartość timer argument, zgodnie z czasem UTC, a nie czas lokalny.Każde z pól struktury jest typu int, w następujący sposób:

tm_sec
Sekund po minucie (0-59).
tm_min
Minut po godzinie (0-59).
tm_hour
Godziny od północy (0-23).
tm_mday
Dzień miesiąca (1 – 31).
tm_mon
Miesiąc (0 – 11; Stycznia = 0).
tm_year
Rok (bieżącego roku minus 1900).
tm_wday
Dzień tygodnia (0-6; Niedziela = 0).
tm_yday
Dzień roku (0 – 365; 1 Stycznia = 0).
tm_isdst
Zawsze 0 dla gmtime.

Zarówno 32-bitowych i 64-bitowe wersje gmtime, mktime, mkgmtime, i localtimewszystkie użyć pojedynczego tm struktury na wątku do konwersji.Każde wywołanie do jednego z tych funkcji niszczy wynik wszelkie poprzednie wywołanie.Jeśli timer reprezentuje datę przed północą, 1 stycznia 1970 r., gmtime zwraca NULL.Istnieje bez powrotu błąd.

_gmtime64, który korzysta z __time64_t struktury, pozwala dat wyrażone są do 23: 59: 59, 31 grudnia, 3000, UTC, należy _gmtime32 reprezentują tylko daty poprzez 03: 14: 07 19 stycznia 2038, UTC.Północy, 1 stycznia 1970 r., jest dolną granicą zakres dat dla obu tych funkcji.

gmtimefunkcji śródwierszowej, której wynikiem jest _gmtime64 i time_t jest równoważne z __time64_t.Jeśli trzeba wymusić na kompilatorze interpretowania time_t jako stary 32-bitowe time_t, można zdefiniować _USE_32BIT_TIME_T.Spowoduje to zaawansowana gmtime się w rurowy do _gmtime32.Nie jest to zalecane, ponieważ aplikacja może zakończyć się niepowodzeniem po 18 stycznia 2038, i nie jest dozwolone na platformach 64-bitowych.

Te funkcje sprawdzania poprawności ich parametrów.Jeśli timer jest wskaźnik zerowy, lub jeśli wartość czasomierza jest ujemna, te funkcje Wywołaj funkcję obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość NULL i errno do EINVAL.

Uwagi

_gmtime32 Dzieli się funkcja timer wartość i zapisuje go w strukturze statycznie przydzielonego typu tm, określonych w czasie.H.Wartość timer uzyskuje się zwykle z wywołania time funkcji.

[!UWAGA]

Środowiska docelowego należy spróbować ustalić, czy jest czasu letniego obowiązujące.Biblioteka uruchomieniowa c przyjmuje zasady Stanów Zjednoczonych, wykonywania obliczeń czasu letniego (DST).

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

Przykład

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