Provided by:
manpages-es_1.55-8_all 
NOMBRE
strftime - formatea fecha y hora
SINOPSIS
#include <time.h>
size_t strftime(char *s, size_t max, const char *format,
const struct tm *tm);
DESCRIPCIÓN
La función strftime() formatea el tiempo descompuesto en campos tm
según la especificación de formato format y coloca el resultado en el
vector de caracteres s de tamaño max.
Los caracteres normales de la cadena de formato se copian en s sin
conversión ninguna. Los especificadores de conversión se introducen con
un carácter de porcentaje ‘%’, y se reemplazan en s como sigue:
%a El nombre abreviado del dÃa de la semana según la localización
en curso.
%A El nombre del dÃa de la semana, completo, según la localización
en curso.
%b El nombre abreviado del mes según la localización en curso.
%B El nombre completo del mes según la localización en curso.
%c La representación preferida de fecha y hora para la localización
en curso.
%C El siglo (año/100) como un entero de 2 dÃgidos. (SU)
%d El dÃa del mes como un número en base diez (en el rango de 01 a
31).
%D Equivalente a %m/%d/%y. (Sip - sólo para norteamericanos. Los
norteamericanos deben darse cuenta que en otros paÃses %d/%m/%y
es bastante común. Esto significa que en un contexto
internacional este formato es ambiguo y no se deberÃa usar).
(SU)
%e Como %d, el dÃa del mes como un número decimal, pero un cero
inicial se reemplaza por un espacio. (SU)
%E Modificador; use formato alternativo, ver más abajo. (SU)
%F Equivalente a %Y-%m-%d (el formato de fecha de ISO 8601). (C99)
%G El año con siglo como un número decimal según el estándar ISO
8601. El año de 4 dÃgitos correspondiente al número de la
semana ISO (ver %V). Éste tiene el mismo formato y valor que
%y, salvo que si el número de la semana ISO pertenece al año
anterior o siguiente, ese año se utiliza en su lugar. (TZ).
%g Como %G, pero sin siglo, es decir, con un año de 2 dÃgitos
(00-99). (TZ)
%h Equivalente a %b. (SU)
%H La hora como un número en base diez en formato de 24 horas (en
el rango de 00 a 23).
%I La hora como un número en base diez en formato de 12 horas (en
el rango de 01 a 12).
%j El dÃa juliano (dÃa del año) como un número en base diez (en el
rango de 001 a 366).
%k La hora (en un reloj de 24 horas) como un número decimal (en el
rango de 0 a 23); los dÃgitos individuales son precedidos por un
blanco. (Ver también %H). (TZ)
%l La hora (en un reloj de 12 horas) como un número decimal (en el
rango de 1 a 12); los dÃgitos individuales son precedidos por un
blanco. (Ver tambÃen %I). (TZ).
%m El mes como un número en base diez (en el rango de 01 a 12).
%M El minuto como un número en base diez (en el rango de 00 a 59).
%n Un carácter de nueva lÃnea. (SU)
%O Modificador; use un formato alternativo, ver más abajo. (SU)
%p O ‘AM’ ("Ante Meridiem", antes del mediodÃa) o ‘PM’ ("Post
Meridiem", después del mediodÃa) de acuerdo con el valor del
tiempo dado, o la cadena de caracteres correspondiente según la
localización en curso. El medio dÃa se trata como ‘pm’ y la
media noche como ‘am’.
%P Como %p pero en letras minúsculas: ‘am’ o ‘pm’ o una cadena
correspondiente para la localización actual. (GNU)
%r El tiempo en notación a.m. o p.m.. En la localización POSIX
esto es equivalente a ‘%I:%M:%S %p’. (SU)
%R El tiempo en notación de 24 horas (%H:%M). (SU) Para una versión
que incluya lo segundos, ver %T más abajo.
%s El número de segundos desde la Época, es decir, desde 1970-01-01
00:00:00 UTC. (TZ)
%S El segundo como un número decimal (en el rango de 00 a 61)
%t Un carácter tabulador. (SU)
%T El tiempo en notación de 24 horas (%H:%M:%S). (SU)
%u El dÃa de la semana como un número decimal, en el rango de 1 a
7, siendo 1 el Lunes. Ver también %w. (SU)
%U El número de la semana del año actual como un número en base
decimal, en el rango de 00 a 53, empezando por el primer domingo
como el primer dÃa de la primera semana. Ver también %V y %W.
%W El número de la semana del año actual como un número decimal
según el estándar ISO 8601:1988, donde la semana 1 es la primera
semana que tiene al menos 4 dÃas del año actual y el lunes como
el primer dÃa de la semana. Ver también %U y %W. (SU)
%w El dÃa de la semana como un número decimal, en el rango de 0 a
6, siendo el domingo el cero. Ver también %u.
%W El número de la semana del año actual como un número decimal, en
el rango de 00 a 53, empezando con el primer Lunes como el
primer dÃa de la primera semana.
%x La representación preferida de la fecha (sin la hora) para la
localización en curso.
%X La representación preferida de la hora (sin la fecha) para la
localización en curso.
%y El año como un número en base diez sin la centuria (en el rango
de 00 a 99).
%Y El año como un número en base diez, incluyendo la centuria.
%z El huso horario como las horas de diferencia respecto a GMT.
Necesario para emitir fechas conformes a RFC822 (usando "%a, %d
%b %Y %H:%M:%S %z"). (GNU)
%Z La zona horaria, nombre o abreviatura.
%+ La fecha y hora en el formato de date(1). (TZ)
%% Un carácter de porcentaje literal, ’%’.
Algunos indicadores de conversión se pueden modificar precediéndolos
por un modificador E u O para indicar que se debe usar un formato
alternativo. Si no existen formatos o especificaciones alternativos
para la localización actual, el comportamiento quedará como si se usara
la especificación de conversión sin modificar. (SU) ‘The Single Unix
Specification’ menciona %Ec, %EC, %Ex, %EX, %Ry, %EY, %Od, %Oe, %OH,
%OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow, %OW, %Oy, donde el efecto del
modificador O es el de usar sÃmbolos numéricos alternativos (digamos,
números romanos) y el del modificador E es el de usar un representación
alternativa dependiente de la localización.
La estructura para el tiempo descompuesto, tm, se define en <time.h>.
Véase también ctime(3).
VALOR DEVUELTO
La función strftime() devuelve el número de caracteres puestos en el
vector s, sin incluir el carácter cero terminador (NUL), suponiendo que
la cadena, incluyendo el carácter cero terminador, cabe. En caso
contrario, devuelve 0 y el contenido del vector es indefinido. (Esto es
asà al menos desde la versión 4.4.4 de libc; las versiones de libc muy
antiguas, tales como la libc 4.4.1, devolvÃan max si el vector era
demasiado pequeño).
Dése cuenta que el valor devuelto 0 no indica necesariamente un error;
por ejemplo, en muchas localizaciones %p da lugar a una cadena vacÃa.
ENTORNO
Se usan las variables de entorno TZ y LC_TIME.
CONFORME A
ANSI C, SVID 3, ISO 9899. Existen inclusiones estrictas entre el
conjunto de conversiones dadas en ANSI C (sin marcar), aquellas dadas
en ‘the Single Unix Specification’ (marcadas como SU), aquellas dadas
en el paquete de huso horario de Olson (marcadas TZ) y aquellas dadas
en glibc (marcadas GNU), excepto que %+ no está soportado en glibc2.
Por otro lado, glibc2 tiene varias extensiones más. POSIX.1 sólo
referencia a ANSI C; POSIX.2 describe bajo date(1) varias extensiones
que se podrÃan aplicar también a strftime. La conversión %F está en
C99 y POSIX 1003.1-2001.
FALLOS
Algunas versiones con fallos de gcc se quejan sobre el uso de %c:
advertencia: ‘%c’ da sólo los 2 últimos dÃgitos del año en algunas
localizaciones. Por supuesto los programadores insisten en usar %c,
puesto que proporciona la representación de fecha y hora preferida.
Pueden encontrarse todo tipo de extraños atajos para evitar este
problema de gcc. Uno relativamente elegante es añadir una función
intermedia
size_t my_strftime(char *s, size_t max, const char *fmt, const
struct tm *tm) {
return strftime(s, max, fmt, tm);
}
VÉASE TAMBIÉN
date(1), time(2), ctime(3), setlocale(3), sprintf(3)