asctime, _wasctime

Artigo
08/25/2010

Converter um tm estrutura de time a uma seqüência de caractere. Versões mais seguras dessas funções estão disponível; consulte asctime_s, _wasctime_s.

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

Parâmetros

timeptr
Data/time estrutura.

Valor de retorno

asctime Retorna um ponteiro para o resultado de seqüência de caractere; _wasctime Retorna um ponteiro para o resultado de seqüência de caractere largos. Não há nenhum valor retornado de erro.

Comentários

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

The asctime função converte uma time armazenada sistema autônomo uma estrutura para uma seqüência de caractere. The timeptr valor geralmente é obtido de uma telefonar para gmtime ou localtime, que os dois retornam um ponteiro para um tm estrutura, definida no TIME.H.

membro timeptr	Valor
tm_hour	Horas desde a meia-noite (0 – 23)
tm_isdst	Positivo se o time de economia de horário de verão estiver em vigor; 0 se a time de verão não em vigor; negativo se status do horário de verão for desconhecido.A biblioteca de time 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 hora (0 – 59)
tm_mon	Mês (0–11; janeiro = 0)
tm_sec	Segundos após minuto (0 – 59)
tm_wday	Dia da semana (0 a 6; domingo = 0)
tm_yday	Dia do ano (0–365; 0 = 1 º de janeiro)
tm_year	Ano (ano corrente menos 1900)

A seqüência de caractere convertida é também ajustada de acordo com a hora local zona configurações.Para obter informações sobre como configurar a time local, consulte o time, _ftime, and localTime funções e o _tzset função para obter informações sobre como definir o ambiente de fuso horário e variáveis global.

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

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

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

Mapeamento de rotina de texto genérica

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

Este programa coloca a time do sistema o long inteiro aclock, converte-o para a estrutura newtime e a converte ao formulário de cadeia de caracteres para 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
}

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