strftime

size_t strftime( char* str, size_t count,
                 const char* format, const struct tm* tp );

size_t strftime( char* restrict str, size_t count,
                 const char* restrict format, const struct tm* restrict tp );

Convierte la información de fecha y hora de un tiempo calendario dado tp a una cadena de caracteres multibyte terminada en nulo str de acuerdo con cadena de formato format. Hasta count bytes se escriben.

Parámetros

Cadena de formato

La cadena de formato consiste en cero o más especificadores de conversión y caracteres ordinarios (excepto %). Todos los caracteres ordinarios, incluyendo el carácter nulo de terminación, se copian a la cadena de salida sin modificación. Cada especificación de conversión comienza con el carácter %, opcionalmente seguido por E o O modificador (ignorado si no es soportado por la configuración regional), seguido por el carácter que determina el comportamiento del especificador. Los siguientes especificadores de formato están disponibles:

Valor de retorno

El número de bytes escritos en el arreglo de caracteres apuntado por str sin incluir el '\0' de terminación en caso de éxito. Si count fue alcanzado antes de que toda la cadena pudiera almacenarse, se devuelve 0 y el contenido es indeterminado.

Ejemplo

#include <locale.h>
#include <stdio.h>
#include <time.h>

int main(void)
{
    char buff[70];
    struct tm my_time =
    {
        .tm_year = 112, // = year 2012
        .tm_mon = 9,    // = 10th month
        .tm_mday = 9,   // = 9th day
        .tm_hour = 8,   // = 8 hours
        .tm_min = 10,   // = 10 minutes
        .tm_sec = 20    // = 20 secs
    };

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");

    setlocale(LC_TIME, "el_GR.utf8");

    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
}

Sunday Sun Oct  9 08:10:20 2012
Κυριακή Κυρ 09 Οκτ 2012 08:10:20 πμ EST

Referencias

Véase también