asctime, _wasctime

  • Articolo

Convertire una struttura temporale tm in una stringa di caratteri. Sono disponibili versioni più sicure di queste funzioni; vedere asctime_s, _wasctime_s.

Sintassi

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

Parametri

timeptr
Struttura di data e ora.

Valore restituito

asctime restituisce un puntatore al risultato della stringa di caratteri; _wasctime restituisce un puntatore al risultato della stringa di caratteri wide. Non esiste alcun valore restituito di errore.

Osservazioni:

Sono disponibili versioni più sicure di queste funzioni; vedere asctime_s, _wasctime_s.

La funzione asctime converte un'ora archiviata come struttura in una stringa di caratteri. Il timeptr valore viene in genere ottenuto da una chiamata a gmtime o localtime, che entrambi restituiscono un puntatore a una tm struttura, definita in TIME.H.

Membrotimeptr Valore
tm_hour Ore dalla mezzanotte (0-23)
tm_isdst Positivo se l'ora legale è attiva; 0 se l'ora legale non è attiva; negativo se lo stato dell'ora legale è sconosciuto. La libreria di runtime C presuppone le regole relative agli Stati Uniti per implementare il calcolo dell'ora legale (DST).
tm_mday Giorno del mese (1-31)
tm_min Minuti dopo l'ora (0-59)
tm_mon Mese (0-11; Gennaio = 0)
tm_sec Secondi dopo 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)

Per informazioni sulla configurazione dell'ora locale, vedere le timefunzioni , _ftimee localtime . Per informazioni sulla definizione dell'ambiente del fuso orario e delle variabili globali, vedere la _tzset funzione .

Il risultato stringa prodotto da asctime contiene esattamente 26 caratteri e ha il formato Wed Jan 2 02:03:55 1980\n\0. Viene usato un formato 24 ore. Tutti i campi hanno una larghezza costante. Il carattere di nuova riga e il carattere null occupano le ultime due posizioni della stringa. asctime usa un singolo buffer allocato in modo statico per contenere la stringa restituita. Ogni chiamata a questa funzione elimina definitivamente il risultato della chiamata precedente.

_wasctime è una versione a caratteri wide di asctimee in caso contrario si comporta in modo identico a asctime.

Queste funzioni convalidano i relativi parametri. Se timeptr è un puntatore Null o se contiene valori non compresi nell'intervallo, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

TCHAR.H routine _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_tasctime asctime asctime _wasctime

Requisiti

Ciclo Intestazione obbligatoria
asctime <time.h>
_wasctime <time.h> oppure <wchar.h>

Esempio

Questo programma inserisce l'ora di sistema nell'intero aclocklungo, la converte nella struttura newtimee quindi la converte in formato stringa per l'output usando la 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
}

Current date and time: Sun Feb  3 11:38:58 2002

Vedi anche

Gestione orari
ctime, _ctime32, _ctime64, _wctime, _wctime32_wctime64
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64
_tzset
asctime_s, _wasctime_s