strftime ()- Datum/Zeit in Zeichenfolge konvertieren

Format

#include <time.h>
size_t strftime(char *s, size_t maxsize, const char *format,
                   const struct tm *timeptr);

Sprachniveau

ANSI

Sicher für Threads

Ja

Länderspezifisch

Das Verhalten dieser Funktion kann durch die Kategorien LC_CTYPE, LC_TIME und LC_TOD der aktuellen Ländereinstellung beeinflusst werden. Weitere Informationen finden Sie unter CCSIDs und Ländereinstellungen verstehen.

Beschreibung

Die Funktion strftime() platziert Bytes in dem Array, auf das von s verwiesen wird, wie durch die Zeichenfolge gesteuert, auf die durch formatverwiesen wird. Die Formatzeichenfolge besteht aus null oder mehr Konvertierungsspezifikationen und normalen Zeichen. Eine Konvertierungsspezifikation besteht aus einem Prozentzeichen (%) und einem abschließenden Konvertierungszeichen, das das Verhalten der Konvertierung bestimmt. Alle normalen Zeichen (einschließlich des abschließenden Nullbyte und Mehrbytezeichen) werden unverändert in das Array kopiert. Wenn das Kopieren zwischen Objekten stattfindet, die sich überlappen, ist das Verhalten nicht definiert. Es werden nicht mehr als maxsize Byte in das Array eingefügt. Die entsprechenden Zeichen werden durch die Werte in der Struktur bestimmt, auf die durch timeptrverwiesen wird, und durch die Werte, die in der aktuellen Ländereinstellung gespeichert sind.

Modifizierte Konvertierungskennungen

Einige Konvertierungskennungen können durch die Änderungszeichen E oder O geändert werden, um anzugeben, dass ein alternatives Format oder eine Spezifikation verwendet werden soll und nicht das, was normalerweise von der unveränderten Konvertierungskennung verwendet wird. Wenn eine modifizierte Konvertierungskennung ein Feld in der aktuellen Ländereinstellung verwendet, das nicht verfügbar ist, entspricht das Verhalten der unveränderten Konvertierungsspezifikation. Wenn die Zeichenfolge era beispielsweise die leere Zeichenfolge "" ist, was bedeutet, dass die Zeichenfolge nicht verfügbar ist, würde sich %EY wie %Y verhalten.

Rückgabewert

Wenn die Gesamtzahl der Ergebnisbyte einschließlich des abschließenden Nullbyte nicht größer als maxsize ist, gibt strftime() die Anzahl der Byte zurück, die in das Array eingefügt wurden, auf das von sverwiesen wird, ohne das abschließende Nullbyte. Andernfalls wird 0 zurückgegeben und der Inhalt des Arrays ist unbestimmt.

Beispiel

#include <stdio.h>
#include <time.h>
 
int main(void)
{
     char s[100];
     int rc;
     time_t temp;
     struct tm *timeptr;

     temp = time(NULL);
     timeptr = localtime(&temp);

     rc = strftime(s,sizeof(s),"Today is %A, %b %d.\nTime:  %r", timeptr);
     printf("%d characters written.\n%s\n",rc,s);

     return 0;
}

/*************************************************
     The output should be similar to:
     46 characters written
     Today is Wednesday, Oct 24.
     Time:  01:01:15 PM
************************************************************/

Zugehörige Informationen