asctime, _wasctime

Artículo
04/10/2013

Convierte una estructura en tiempo de tm a una cadena de caracteres.Versiones más seguras de estas funciones están disponibles; vea asctime_s, _wasctime_s.

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

Parámetros

timeptr
Estructura de hora o de fecha.

Valor devuelto

asctime devuelve un puntero al resultado de la cadena de caracteres; _wasctime devuelve un puntero al resultado de cadena de caracteres.No hay ningún valor devuelto del error.

Comentarios

Versiones más seguras de estas funciones están disponibles; vea asctime_s, _wasctime_s.

La función de asctime convierte una hora almacenada como una estructura a una cadena de caracteres.El valor de timeptr se obtiene normalmente de una llamada a gmtime o a localtime, que ambos devuelven un puntero a una estructura de tm , definido en TIME.H.

miembro del timeptr	Valor
tm_hour	horas desde la medianoche (0-23)
tm_isdst	Positivo si el horario de verano está vigente; 0 si el horario de verano no está vigente; negativa si el estado de horario de verano es desconocido.La biblioteca en tiempo de ejecución de C supone las reglas de los Estados Unidos para implementar el cálculo en tiempo de Daylight Guardar (DST).
tm_mday	Día del mes (1-31)
tm_min	minutos después de la hora (0-59)
tm_mon	mes (0-11; enero = 0)
tm_sec	Segundos después de minuto (0-59)
tm_wday	día de la semana (0-6; domingo = 0)
tm_yday	Día del año (0-365; 1 de enero = 0)
tm_year	Año (año actual menos 1900)

Cadena de caracteres convierte también se ajusta según la configuración de zonas de la hora local.Para obtener información sobre la configuración de la hora local, vea tiempo, _ftime, y las funciones de localtime y la función de _tzset para obtener información sobre la definición del entorno y las variables globales de la zona horaria.

El resultado de la cadena generado por asctime contiene exactamente 26 caracteres y tiene el formato Wed Jan 02 02:03:55 1980\n\0.se utiliza un reloj de 24 horas.todos los campos tienen un ancho constante.El carácter de nueva línea y el carácter null ocupan las dos últimas posiciones de la cadena.asctime utiliza un búfer único, estática asignado para contener la cadena devuelta.cada llamada a esta función destruye el resultado de la llamada anterior.

_wasctime es una versión con caracteres anchos de asctime._wasctime y asctime se comportan exactamente igual de otra manera.

estas funciones validan sus parámetros.Si timeptr es un puntero null, o si contiene valores del intervalo, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, la función devuelve NULL y establece errno a EINVAL.

Asignación rutinaria de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_tasctime	asctime	asctime	_wasctime

Requisitos

rutina	Encabezado necesario
asctime	<time.h>
_wasctime	<time.h> o <wchar.h>

Ejemplo

Este programa coloca la hora del sistema en aclockentero largo, la convierte en la estructura newtime y la convierte al formato de cadena para la salida, mediante la función 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
}