asctime, _wasctime
div
EOF
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

asctime, _wasctime

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 
);

timeptr

Estructura de hora o de fecha.

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.

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

rutina

Encabezado necesario

asctime

<time.h>

_wasctime

<time.h> o <wchar.h>

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
}
fecha y hora actual: Sun 3 de febrero de 11: 38:58 2002

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft