gmtime, _gmtime32, _gmtime64

Articolo
03/26/2013

Convertire un valore in una struttura.Più versioni sicure di queste funzioni sono disponibili, vedere 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 
);

Parametri

timer
puntatore a tempo archiviato.Il tempo viene rappresentato come secondi trascorsi dalla mezzanotte (00:00: 00), il 1° gennaio 1970, formato UTC (UTC).

Valore restituito

Restituire un puntatore a una struttura di tipo il TM.I campi della struttura restituita utilizzano il valore restituito di timer argomento in UTC anziché in fase l'ora locale.Ognuno dei campi della struttura è di tipo int, come segue:

tm_sec
Secondi dopo il minuto (da 0 a 59).
tm_min
Rapporto dopo l'ora (da 0 a 59).
tm_hour
Ore da mezzanotte (da 0 a 23).
tm_mday
Giorno del mese (da 1 a 31).
tm_mon
Mese (da 0 a 11; gennaio = 0).
tm_year
Anno (anno corrente meno 1900).
tm_wday
Giorno della settimana (da 0 a 6; domenica = 0).
tm_yday
Giorno dell'anno (da 0 a 365; 1° gennaio = 0).
tm_isdst
sempre 0 per gmtime.

sia il 32 bit che versioni a 64 bit di gmtime, mktime, mkgmtimee localtimequalsiasi utilizzo un singolo tm struttura di thread per la conversione.Ogni chiamata a una di queste funzioni elimina il risultato di una chiamata precedente.se timer rappresenta una data prima di mezzanotte, il 1° gennaio 1970, gmtime restituisce NULL.Non sono presenti ritorni di errore.

_gmtime64, che utilizza __time64_t la struttura, vengono concesse le date da esprimere su con il 23:59: 59, il 31 dicembre, 3000, UTC, mentre _gmtime32 rappresentare solo date con il 03:14: 7 gennaio 19, 2038, UTC.La mezzanotte, il 1° gennaio 1970, è il limite inferiore dell'intervallo di date per entrambe queste funzioni.

gmtime è una funzione inline che restituisce _gmtime64 e time_t equivale a __time64_t.Se è necessario che il compilatore per interpretare time_t come il 32 bit obsoleto time_t, è possibile definire _USE_32BIT_TIME_T.Questa operazione provocherà gmtime per essere foderato in un oggetto _gmtime32.Questa operazione non è consigliabile perché l'applicazione può non riuscire dopo il 18 gennaio 2038 e non è consentita sulle piattaforme a 64 bit.

Queste funzioni convalidano il parametro.se timer è un puntatore null, o se il valore del timer è negativo, queste funzioni richiamare un gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, il ripristino di funzioni NULL e set errno in EINVAL.

Note

_gmtime32 la funzione riparte timer stimare e archiviarli in una struttura in modo statico allocata di tipo tm, definito in TIME.H.il valore di timer in genere viene ottenuto da una chiamata a time funzione.

[!NOTA]

L'ambiente di destinazione deve tentare di determinare se viene tenuto conto dell'ora legale è attiva.La libreria di runtime C presuppone le regole degli Stati Uniti per implementare il calcolo dell'ora (DST) legale.

Requisiti

routine	Intestazione di associazione
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

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