asctime, _wasctime

Convierta una estructura de hora tm en una cadena de caracteres. Hay disponibles versiones más seguras de estas funciones; consulte asctime_s, _wasctime_s.

Sintaxis

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

Parámetros

timeptr
Estructura de fecha y hora.

Valor devuelto

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

Comentarios

Hay disponibles versiones más seguras de estas funciones; consulte asctime_s, _wasctime_s.

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

Miembrotimeptr	Valor
tm_hour	Horas desde la medianoche (0-23).
tm_isdst	Positivo si el horario de verano está en vigor; 0 si el horario de verano no está en vigor; negativo si se desconoce el estado del horario de verano. La biblioteca en tiempo de ejecución de C usa las reglas de Estados Unidos para implementar el cálculo del horario de verano (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 del 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)

Para obtener información sobre cómo configurar la hora local, vea las timefunciones , _ftimey localtime . Para obtener información sobre cómo definir el entorno de zona horaria y las variables globales, consulte la _tzset función .

El resultado de cadena que asctime genera contiene exactamente 26 caracteres y tiene el formato Wed Jan 2 02:03:55 1980\n\0. Se usa un reloj de 24 horas. Todos los campos tienen un ancho constante. El carácter de nueva línea y el carácter nulo ocupan las dos últimas posiciones de la cadena. asctime usa un único búfer asignado estáticamente que contiene la cadena de devolución. Cada llamada a esta función destruye el resultado de la llamada anterior.

_wasctime es una versión de caracteres anchos de asctimey, de lo contrario, se comporta de forma idéntica a asctime.

Estas funciones validan sus parámetros. Si timeptr es un puntero nulo o si contiene valores fuera del intervalo, se invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función devuelve NULL y establece en errno en EINVAL.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignación de rutina de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tasctime	asctime	asctime	_wasctime

Requisitos

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

Ejemplo

Este programa coloca la hora del sistema en el entero aclocklargo , lo traduce en la estructura newtimey, a continuación, lo convierte en formulario de cadena para la salida mediante la asctime función .

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

Consulte también

Administración de tiempo
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64
_tzset
asctime_s, _wasctime_s