asctime, _wasctime

Articolo
03/26/2013

Convertire un oggetto tm cronometrare la struttura a una stringa di caratteri.Più versioni sicure di queste funzioni sono disponibili, vedere asctime_s, _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

Parametri

timeptr
struttura di data/ora.

Valore restituito

asctime restituisce un puntatore al risultato della stringa di caratteri, _wasctime restituisce un puntatore al risultato della stringa con caratteri estesi.Non esiste un valore restituito degli errori.

Note

Più versioni sicure di queste funzioni sono disponibili, vedere asctime_s, _wasctime_s.

asctime la funzione converte un'ora archiviato come struttura a una stringa di caratteri.timeptr il valore è in genere ottenuto da una chiamata a gmtime o localtime, che entrambe restituiscono un puntatore a un oggetto tm struttura, definita in TIME.H.

membro del timeptr	Valore
tm_hour	Ore da mezzanotte (0-23)
tm_isdst	Positivo se l'ora legale è attivo; 0 se l'ora legale non è attivo; segno negativo se lo stato dell'ora legale è sconosciuto.La libreria di runtime C presuppone le regole degli Stati Uniti per implementare il calcolo dell'ora (DST) legale.
tm_mday	Giorno del mese (1-31)
tm_min	Rapporto dopo l'ora (0-59)
tm_mon	mese (0-11; gennaio = 0)
tm_sec	secondi dopo il minuto (0-59)
tm_wday	Giorno della settimana (0-6; domenica = 0)
tm_yday	Giorno dell'anno (0-365; 1° gennaio = 0)
tm_year	Anno (anno corrente meno 1900)

La stringa di caratteri convertita viene modificata in base alle impostazioni del fuso orario locale.Per informazioni sulla configurazione dell'ora locale, vedere tempo, _ftimee localtime funzioni e _tzset eseguire per informazioni sulla definizione dell'ambiente e variabili globali del fuso orario.

Il risultato della stringa fornito da l asctime contiene esattamente 26 caratteri e presenta il formato Wed Jan 02 02:03:55 1980\n\0.Un orario in formato 24 ore viene utilizzato.Tutti i campi dispongono di una larghezza costante.Il carattere di nuova riga e il carattere null occupano le ultime due posizioni della stringa.asctime utilizza un singolo, buffer statico allocato per utilizzare la stringa restituita.Ogni chiamata a questa funzione elimina il risultato della chiamata precedente.

_wasctime è una versione a caratteri estesi di asctime._wasctime e asctime comportano in modo identico in caso contrario.

Queste funzioni convalidano i relativi parametri.se timeptr è un puntatore null, o se contiene i valori non incluse nell'intervallo, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, la funzione restituisce NULL e set errno in EINVAL.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tasctime	asctime	asctime	_wasctime

Requisiti

routine	Intestazione di associazione
asctime	<time.h>
_wasctime	<time.h> o <wchar.h>

Esempio

Questo programma e l'ora di sistema integer lungo aclock, lo converte in struttura newtime quindi convertiti in stringa form per output, utilizzando il asctime funzione.

// crt_asctime.c
// compile with: /W3

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

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}