asctime, _wasctime

Artigo
02/25/2013

Converter um tm estrutura para uma seqüência de caracteres de tempo.Versões mais seguras dessas funções estão disponíveis; see asctime_s, _wasctime_s.

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

Parâmetros

timeptr
Estrutura de hora/data.

Valor de retorno

asctimeRetorna um ponteiro para o resultado de seqüência de caracteres; _wasctimeRetorna um ponteiro para o resultado de cadeia de caracteres largos.Não há nenhum valor de retorno de erro.

Comentários

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

O asctime função converte um horário armazenado como uma estrutura para uma seqüência de caracteres.O timeptr valor geralmente é obtido de uma chamada para gmtime ou localtime, que retornam um ponteiro para uma tm estrutura, definida no tempo.H.

membro do timeptr	Valor
tm_hour	Horas desde a meia-noite (0 – 23)
tm_isdst	Positivo se o horário de verão está em vigor; 0 se o horário de verão não está em vigor. negativo se o status do horário de verão é desconhecido.A biblioteca de tempo de execução c assume as regras dos Estados Unidos para implementar o cálculo do horário de verão (DST).
tm_mday	Dia do mês (1 – 31)
tm_min	Minutos após a 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 a 6; Domingo = 0)
tm_yday	Dia do ano (0–365; 1º De janeiro = 0)
tm_year	Ano (ano atual menos 1900)

A seqüência de caracteres convertidas 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 o tempo, _ftime, e localtime funções e o _tzset a função para obter informações sobre como definir o ambiente de fuso horário e variáveis globais.

O resultado da seqüência de caracteres produzido por asctime contém exatamente 26 caracteres e tem a forma Wed Jan 02 02:03:55 1980\n\0.É usado um relógio de 24 horas.Todos os campos tem uma largura de constante.O caractere de nova linha e o caractere nulo ocupam as duas últimas posições da seqüência de caracteres.asctimeusa um único buffer estaticamente alocado para armazenar a seqüência de retorno.Cada chamada para essa função destrói o resultado da chamada anterior.

_wasctimeé uma versão de caractere largo de asctime._wasctimee asctime tenham comportamento idêntico caso contrário.

Essas funções validam seus parâmetros.Se timeptr é um ponteiro nulo ou se ele contiver valores fora do intervalo, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, a função retornará NULL e define errno para EINVAL.

Mapeamento de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_tasctime	asctime	asctime	_wasctime

Requisitos

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

Exemplo

Este programa coloca a hora do sistema no inteiro longo aclock, converte-o para a estrutura de newtime e o converte em forma de seqüência de saída, usando o asctime função.

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