Se recomienda usar Visual Studio 2017

strftime, wcsftime, _strftime_l, _wcsftime_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Dar formato a una cadena de hora.

size_t strftime(  
   char *strDest,  
   size_t maxsize,  
   const char *format,  
   const struct tm *timeptr   
);  
size_t _strftime_l(  
   char *strDest,  
   size_t maxsize,  
   const char *format,  
   const struct tm *timeptr,  
   _locale_t locale  
);  
size_t wcsftime(  
   wchar_t *strDest,  
   size_t maxsize,  
   const wchar_t *format,  
   const struct tm *timeptr   
);  
size_t _wcsftime_l(  
   wchar_t *strDest,  
   size_t maxsize,  
   const wchar_t *format,  
   const struct tm *timeptr,  
   _locale_t locale  
);  

Parámetros

strDest
Cadena de salida

maxsize
Tamaño de la strDest búfer, expresado en caracteres (char o wchart_t).

format
Cadena de control de formato.

timeptr
tmestructura de datos.

locale
Configuración regional que se va a usar.

strftimeDevuelve el número de caracteres que se colocan en strDest y wcsftime devuelve el número correspondiente de caracteres anchos.

Si el número total de caracteres, incluido el carácter null final, es más de maxsize, strftime y wcsftime devolver 0 y el contenido de strDest son indeterminados.

El número de caracteres de strDest es igual al número de caracteres literales de format , así como todos los caracteres que pueden agregarse al format a través de códigos de formato. No se contabiliza el carácter nulo de una cadena en el valor devuelto.

El strftime y wcsftime formato funciones la tm tiempo de valor en timeptr según proporcionado format argumento y el resultado en el búfer de almacén strDest . A lo sumo, maxsize caracteres se colocan en la cadena. Para obtener una descripción de los campos de la timeptr estructura, vea asctime. wcsftimees el equivalente de caracteres anchos de strftime; su argumento de puntero de cadena señala a una cadena de caracteres anchos. Por lo demás, estas funciones se comportan exactamente igual.

System_CAPS_ICON_note.jpg Nota

En las versiones anteriores de Visual C++ 2005, la documentación se describe la format parámetro de wcsftime como con los datos de tipo const wchar_t *, pero la implementación real de la format tipo de datos const char *. La implementación de la formattipo de datos se ha actualizado para reflejar la documentación anterior y la actual, es decir, const wchar_t *.

Esta función valida sus parámetros. Si strDest, format, otimeptr es un puntero nulo, o si la tm estructura de datos dirigido por timeptr no es válida (por ejemplo, si contiene valores fuera del intervalo para la hora o fecha), o si la format cadena contiene un código de formato no válido, se invoca el 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 0 y establece errno a EINVAL.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tcsftimestrftimestrftimewcsftime

El format argumento consta de uno o más códigos; como en printf, los códigos de formato están precedidos por un signo de porcentaje (%). Caracteres que no comienzan por % se copian sin cambios al strDest . El LC_TIME afecta a la categoría de la configuración regional actual del formato de salida de strftime. (Para obtener más información sobre LC_TIME, consulte setlocale.) Las funciones sin el _l usar el sufijo configuración regional. Las versiones de estas funciones con el _l sufijo son idénticas salvo que se toman la configuración regional como un parámetro y utilizarlo en vez de establecido actualmente configuración regional. Para obtener más información, vea Locale.

El formato de los códigos para strftime se enumeran a continuación:

%a
Nombre de la semana abreviado

%A
Nombre completo de día laborable

%b
Nombre abreviado del mes

%B
Nombre completo del mes

%c
Representación de fecha y hora adecuado para la configuración regional

%d
Día del mes como número decimal (01 – 31)

%H
Hora en formato de 24 horas (00 – 23)

%I
Hora en formato de 12 horas (01 – 12)

%j
Día del año como número decimal (001-366)

%m
Mes como número decimal (01 – 12)

%M
Minuto como número decimal (00 – 59)

%p
A.m. y la configuración regional actual. indicador de reloj de 12 horas

%S
Segundo como número decimal (00 – 59)

%U
Semana del año como número decimal, con el domingo como primer día de la semana (00 – 53)

%w
Día de la semana como número decimal (0 – 6; El domingo es 0)

%W
Semana del año como número decimal, con el lunes como primer día de la semana (00 – 53)

%x
Representación de fecha para la configuración regional actual

%X
Representación en tiempo de configuración regional

%y
Año sin el siglo, como número decimal (00 – 99)

%Y
Año con el siglo, como número decimal

%z, %Z
El nombre de la zona horaria o la abreviatura de la zona horaria, dependiendo de la configuración del registro; No hay caracteres si la zona horaria es desconocida

%%
Signo de porcentaje

Como en la printf (función), el # marca puede prefijo cualquier código de formato. En ese caso, el significado del código de formato se cambia como sigue.

Código de formatoSignificado
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%#se omitirá la marca.
%#cTiempo fecha y hora representación, adecuado para la configuración regional actual. Por ejemplo: "Martes, 14 de marzo de 1995, 12:41:29".
%#xRepresentación de fecha larga, adecuado para la configuración regional actual. Por ejemplo: "Martes, 14 de marzo de 1995".
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#YQuite los ceros a la izquierda (si existe).
RutinaEncabezado necesario
strftime<time.h>
wcsftime<time.h>o<wchar.h></wchar.h></time.h>
_strftime_l<time.h>
_wcsftime_l<time.h>o<wchar.h></wchar.h></time.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Vea el ejemplo de tiempo.

Configuración regional
Administración del tiempo
Manipulación de cadenas
localeconv
setlocale, _wsetlocale
strcoll (función)
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Mostrar: