strftime, wcsftime, _strftime_l, _wcsftime_l

Artículo
02/19/2013

Dar formato a una cadena de tiempo.

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 del búfer de strDest , medido en caracteres (char o wchart_t).
format
cadena de la Formato-CONTROL.
timeptr
estructura de datos detm .
locale
la configuración regional a utilizar.

Valor devuelto

strftime devuelve el número de caracteres título 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 que maxsize, strftime y wcsftime devuelve 0 y el contenido de strDest están ocultos.

El número de caracteres de strDest es igual al número de caracteres literales en format así como de cualquier carácter que se pueden agregar a format mediante códigos de formato.La null final de una cadena no se cuenta en el valor devuelto.

Comentarios

Las funciones de strftime y de wcsftime da formato al valor de tiempo de tm en timeptr según el argumento proporcionado de format y almacena el resultado en el búfer strDest*.* A lo sumo, caracteres de maxsize se colocan en la cadena.Para obtener una descripción de los campos de la estructura de timeptr , vea asctime.wcsftime es el equivalente de caracteres anchos de strftime; los puntos de argumento de cadena-puntero a una cadena de caracteres.Estas funciones se comportan exactamente igual de otra manera.

[!NOTA]

En versiones anteriores de Visual C++ 2005, la documentación descrito el parámetro de format de wcsftime como si el tipo de datos const wchar_t *, pero la implementación real del tipo de datos de format era const char *.La implementación del tipo de datos de formatse ha actualizado para reflejar la documentación anterior y actual, es decir, const wchar_t *.

esta función valida sus parámetros.Si strDest, format, otimeptr es un puntero null, o si la estructura de datos de tm dirigida por timeptr no es válida (por ejemplo, si contiene por valores de intervalo para la hora o la fecha), o si la cadena de format contiene un código de formato no válido, se invoca el controlador no válido del parámetro, como se describe en. Validación de parámetrosSi la ejecución puede continuar, la función devuelve 0 y establece errno a EINVAL.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_tcsftime	strftime	strftime	wcsftime

El argumento de format consta de uno o más códigos; como en printf, los códigos de formato va precedido por un signo de porcentaje (%).los caracteres que no comienzan con % se copian sin cambiar a strDest*.* La categoría de LC_TIME de la configuración regional actual afecta al formato de salida de strftime.(Para obtener más información sobre LC_TIME, vea setlocale.) Las funciones sin el sufijo de _l utilizan la configuración regional actualmente establecido.Las versiones de estas funciones con el sufijo de _l son idénticas salvo que toman la configuración regional como parámetro y utilizan que en lugar de la configuración regional actualmente establecido.Para obtener más información, vea Configuración regional.

Los códigos de formato para strftime se muestran a continuación:

%a
Nombre del día de la semana abreviado
%A
Nombre completo del día de la semana
%b
Nombre abreviado de meses
%B
Nombre completo del mes
%c
Representación de fecha y hora adecuada para la configuración regional
%d
Día de mes como un número decimal (01 – 31)
%H
hora en el formato de 24 horas (00 – 23)
%I
Hora en formato de hora 12 (01 – 12)
%j
Día del año como un número decimal (001 – 366)
%m
Mes como un número decimal (01 – 12)
%M
Minuto como un número decimal (00 – 59)
%p
A.m. actual/PM. de configuración regional.indicador del reloj de 12 horas
%S
Segundo como un número decimal (00 – 59)
%U
Semana del año como un número decimal, con sunday como primer día de la semana (00 – 53)
%w
Día de la semana como un número decimal (0 – 6; domingo es 0)
%W
Semana del año como un número decimal, con lunes como primer día de la semana (00 – 53)
%x
Presentación de la fecha para la configuración regional actual
%X
Representación de tiempo para la configuración regional actual
%y
Año sin el siglo, como un número decimal (00 – 99)
%Y
Año con el siglo, como un número decimal
%z, %Z
El nombre de la zona horaria o la abreviatura de la zona horaria, dependiendo de la configuración de registro; ningún carácter si la zona horaria es desconocida
%%
signo de porcentaje

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

Código de formato	Significado
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%	se omite el indicador de# .
%#c	La presentación de la fecha larga y la hora, es adecuado para la configuración regional actual.por ejemplo: “Martes 14 de marzo de 1995, 12:41: 29".
%#x	La representación de fecha larga, adecuadas 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, %#Y	Quite los ceros iniciales (si existe).