localtime, _localtime32, _localtime64

Articolo
03/26/2013

Converte un valore e correggere il fuso orario locale.Più versioni sicure di queste funzioni sono disponibili, vedere localtime_s, _localtime32_s, _localtime64_s.

struct tm *localtime(
   const time_t *timer 
);
struct tm *_localtime32(
   const __time32_t *timer
);
struct tm *_localtime64(
   const __time64_t *timer 
);

Parametri

timer
puntatore a tempo archiviato.

Valore restituito

Restituire un puntatore al risultato della struttura, o NULL se la data passata alla funzione è:

Prima di mezzanotte, il 1° gennaio 1970.
dopo il 03:14: 07, il 19 gennaio 2038, UTC (che utilizzano _time32e time32_t).
dopo il 23:59: 59, il 31 dicembre, 3000, UTC (che utilizzano _time64 e __time64_t).

_localtime64, che utilizza __time64_t la struttura, vengono concesse le date da esprimere su con il 23:59: 59, il 31 dicembre, 3000, formato UTC (UTC), mentre _localtime32 rappresenta le date con il 03:14: 7 gennaio 19, 2038, UTC.

localtime è una funzione inline che restituisce _localtime64e time_t equivale a __time64_t.Se è necessario che il compilatore per interpretare time_tcome il 32 bit obsoleto time_t, è possibile definire _USE_32BIT_TIME_T.Questa operazione provocherà localtime per valutare a _localtime32.Questa operazione non è consigliabile perché l'applicazione può non riuscire dopo il 19 gennaio 2038 e non è consentita sulle piattaforme a 64 bit.

I campi del tipo di struttura il TM archiviare i valori seguenti, ciascuno dei quali viene int:

tm_sec
Secondi dopo il minuto (da 0 a 59).
tm_min
Rapporto dopo l'ora (da 0 a 59).
tm_hour
Ore dopo la 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
Valore positivo se l'ora legale è attivo; 0 se l'ora legale non è attivo; valore negativo se lo stato dell'ora legale è sconosciuto.se TZ la variabile di ambiente è impostata, la libreria di runtime del linguaggio C presuppone le regole appropriate negli Stati Uniti per implementare il calcolo dell'ora (DST) legale.

Note

localtime la funzione converte un'ora archiviato come time_t stimare e archivia il risultato in una struttura di tipo tm.long valore timer rappresenta i secondi trascorsi dalla mezzanotte (00:00: 00), il 1° gennaio 1970, UTC.Questo valore è in genere ottenuto dal time funzione.

sia il 32 bit che versioni a 64 bit di gmtime, mktime, mkgmtimee localtime qualsiasi utilizzo un singolo tm struttura di thread per la conversione.Ogni chiamata a una di queste routine elimina il risultato della chiamata precedente.

localtime corregge il fuso orario locale se l'utente innanzitutto imposta la variabile di ambiente globali TZ.quando TZ è impostato, altre tre variabili di ambiente (_timezone, _daylighte _tzname) vengono impostate automaticamente anche.se TZ la variabile non è impostata, localtime tenta di utilizzare le informazioni del fuso orario specificato nell'applicazione ora/data nel Pannello di controllo.Se tali informazioni non possono essere ottenute, PST8PDT, ovvero il fuso orario Ora solare Pacifico, viene utilizzato per impostazione predefinita.vedere _tzset per una descrizione di tali variabili.TZ è un'estensione Microsoft e non una parte della definizione standard ANSI di localtime.

[!NOTA]

L'ambiente di destinazione deve tentare di determinare se l'ora legale è attiva.

Queste funzioni convalidano i relativi parametri.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.

Requisiti

routine	Intestazione di associazione
localtime	<time.h>
_localtime32	<time.h>
_localtime64	<time.h>

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

Esempio

// crt_localtime.cpp
// compile with: /W3
/* This program uses _time64 to get the current time 
 * and then uses localtime64() to convert this time to a structure 
 * representing the local time. The program converts the result 
 * from a 24-hour clock to a 12-hour clock and determines the 
 * proper extension (AM or PM).
 */

#include <stdio.h>
#include <string.h>
#include <time.h>

int main( void )
{
        struct tm *newtime;
        char am_pm[] = "AM";
        __time64_t long_time;

        _time64( &long_time );           // Get time as 64-bit integer.
                                         // Convert to local time.
        newtime = _localtime64( &long_time ); // C4996
        // Note: _localtime64 deprecated; consider _localetime64_s

        if( newtime->tm_hour > 12 )        // Set up extension.
                strcpy_s( am_pm, sizeof(am_pm), "PM" );
        if( newtime->tm_hour > 12 )        // Convert from 24-hour
                newtime->tm_hour -= 12;    //   to 12-hour clock.
        if( newtime->tm_hour == 0 )        // Set hour to 12 if midnight.
                newtime->tm_hour = 12;

        char buff[30];
        asctime_s( buff, sizeof(buff), newtime );
        printf( "%.19s %s\n", buff, am_pm );
}