asctime, _wasctime

Artigo
06/09/2015

Converter uma estrutura de tempo de tm a uma cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte asctime_s, _wasctime_s.

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

Parâmetros

timeptr
Estrutura de data/hora.

Valor de retorno

asctime retorna um ponteiro para o resultado da cadeia de caracteres; _wasctime retorna um ponteiro para o resultado da cadeia de caracteres de ampla caractere. Não há nenhum valor de retorno do erro.

Comentários

Versões mais seguras dessas funções estão disponíveis; consulte asctime_s, _wasctime_s.

A função de asctime converte uma hora armazenados como uma estrutura para uma cadeia de caracteres. O valor de timeptr geralmente é obtido de uma chamada para gmtime ou a localtime, que ambos retornam um ponteiro para uma estrutura de tm , definido em. TIME.H.

membro de timeptr	Valor
tm_hour	Hora desde meia-noite (0-23)
tm_isdst	Positivo se o horário de verão é aplicado; 0 se o horário de verão não for aplicado; negativo se o status do horário de verão é desconhecido. A biblioteca de tempo de execução C assumirá as regras dos Estados Unidos para implementar o cálculo de horário de verão (DST).
tm_mday	Dia do mês (1-31)
tm_min	Minutos depois da hora (0-59)
tm_mon	Mês (0-11; janeiro = 0)
tm_sec	Segundos após o minuto (0-59)
tm_wday	Dia da semana (0-6; Domingo = 0)
tm_yday	Dia do ano (0-365; 1º de janeiro = 0)
tm_year	Ano (o ano atual menos 1900)

A cadeia de caracteres convertida também é ajustada de acordo com as configurações de fuso horário local. Para obter informações sobre como configurar a hora local, consulte hora, _ftime, e as funções de localtime e a função de _tzset para obter mais informações sobre como configurar o ambiente de fuso horário e variáveis globais.

O resultado da cadeia de caracteres gerado por asctime contém exatamente 26 caracteres e tem o formato Wed Jan 02 02:03:55 1980\n\0. Um relógio de 24 horas é usado. Todos os campos têm uma largura constante. O caractere de nova linha e o caractere nulo ocupam as duas posições as mais recentes de cadeia de caracteres. asctime usa um único buffer, estaticamente atribuído para manter a cadeia de caracteres de retorno. Cada chamada para essa função destrói o resultado da chamada anterior.

_wasctime é uma versão de caracteres largos de asctime. Caso contrário, _wasctime e asctime, ao contrário, se comportam de forma idêntica.

Essas funções validam seus parâmetros. Se timeptr for um ponteiro nulo, ou se contiver valores fora do escopo, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução puder continuar, a função retornará NULL e definirá errno como EINVAL.

Mapeamento de rotina de Genérico- texto

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tasctime	asctime	asctime	_wasctime

Requisitos

Rotina	Cabeçalho necessário
asctime	<time.h>
_wasctime	<time.h ou> wchar.h <>

Exemplo

Esse programa coloca a hora do sistema em inteiro longo aclock, tradu-los na estrutura newtime e converte a cadeia de caracteres no formato de saída, usando a função de asctime .

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