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

Konvertiert die Datums- und Zeitinformationen aus einer gegebenen Kalenderzeit tp in eine nullterminierte Multibyte-Zeichenkette str gemäß Formatstring format. Es werden bis zu count Bytes geschrieben.

Parameter

-Objekt, das die zu formatierende Zeit angibt

Formatstring%Der Formatstring besteht aus null oder mehr Konvertierungsspezifizierern und gewöhnlichen Zeichen (außer %). Alle gewöhnlichen Zeichen, einschließlich des terminierenden Nullzeichens, werden ohne Änderung in die Ausgabezeichenkette kopiert. Jede Konvertierungsspezifikation beginnt mit einem E-Zeichen, optional gefolgt von einem O- oder

Rückgabewert

Die Anzahl der Bytes, die in das durch str bezeichnete Zeichenarray geschrieben wurden, ohne das terminierende '\0' bei Erfolg. Wenn count erreicht wurde, bevor die gesamte Zeichenkette gespeichert werden konnte, wird 0 zurückgegeben und der Inhalt ist unbestimmt.

Beispiel

#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

Referenzen

Siehe auch