Google

NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7">

strftime

(PHP 3, PHP 4 )

strftime --  Formatiert eine Zeit-/Datumsangabe nach den lokalen Einstellungen

Beschreibung:

string strftime ( string format [, int Timestamp])

Gibt einen String zurück, der den angegebenen Formatierungs-Merkmalen entspricht. Dabei wird der gegebene Timestamp/ Zeitstempel oder - falls dieser fehlt - die momentane lokale Zeit benutzt. Der Monats- und Wochentagsname wird entsprechend des per setlocale() eingestellten Wertes gesetzt.

Nachfolgend die im Formatierungsstring gültigen / bekannten Platzhalter:

  • %a - abgekürzter Name des Wochentages, abhängig von der gesetzten Umgebung

  • %A - ausgeschriebener Name des Wochentages, abhängig von der gesetzten Umgebung

  • %b - abgekürzter Name des Monats, abhängig von der gesetzten Umgebung

  • %B - ausgeschriebener Name des Monats, abhängig von der gesetzten Umgebung

  • %c - Wiedergabewerte für Datum und Zeit, abhängig von der gesetzten Umgebung

  • %C - Jahrhundert (Jahr geteilt durch 100, gekürzt auf Integer, Wertebereich 00 bis 99)

  • %d - Tag des Monats als Zahl (Bereich 00 bis 31)

  • %D - so wie %m/%d/%y

  • %e - Tag des Monats als Dezimal-Wert, einstelligen Werten wird ein Leerzeichen voran gestellt (Wertebereich ´ 0´ bis ´31´)

  • %g - wie %G, aber ohne Jahrhundert.

  • %G - Das vierstellige Jahr entsprechend der ISO Wochennummer (siehe %V). Das gleiche Format und der gleiche Wert wie bei %Y. Besonderheit: entspricht die ISO Wochennummer dem vorhergehenden oder folgendem Jahr, wird dieses Jahr verwendet.

  • %h - so wie %b

  • %H - Stunde als Zahl im 24-Stunden-Format (Bereich 00 bis 23)

  • %I - Stunde als Zahl im 12-Stunden-Format (Bereich 01 bis 12)

  • %j - Tag des Jahres als Zahl (Bereich 001 bis 366)

  • %m - Monat als Zahl (Bereich 01 bis 12)

  • %M - Minute als Dezimal-Wert

  • %n - neue Zeile

  • %p - entweder `am' oder `pm' (abhängig von der gesetzten Umgebung) oder die entsprechenden Zeichenketten der gesetzten Umgebung

  • %r - Zeit im Format a.m. oder p.m.

  • %R - Zeit in der 24-Stunden-Formatierung

  • %S - Sekunden als Dezimal-Wert

  • %t - Tabulator

  • %T - aktuelle Zeit, genau wie %H:%M:%S

  • %u - Tag der Woche als Dezimal-Wert [1,7], dabei ist 1 der Montag.

    Warnung

    Sun Solaris scheint mit dem Sonntag als 1 zu starten, obwohl ISO 9889:1999 (der aktuelle C Standard) klar festlegt, dass es der Montag sein sollte.

  • %U - Nummer der Woche des aktuellen Jahres als Dezimal-Wert, beginnend mit dem ersten Sonntag als erstem Tag der ersten Woche.

  • %V - Kalenderwoche (nach ISO 8601:1988) des aktuellen Jahres. Als Dezimal-Zahl mit dem Wertebereich 01 bis 53, wobei die Woche 01 die erste Woche mit mindestens 4 Tagen im aktuellen Jahr ist. Die Woche beginnt Montags (nicht Sonntags).(Benutzen Sie %G or %g für die Jahreskomponente die der Wochennummer für den gegebenen Timestamp entspricht.)

  • %w - Wochentag als Dezimal-Wert, Sonntag ist 0

  • %W - Nummer der Woche des aktuellen Jahres, beginnend mit dem ersten Montag als erstem Tag der ersten Woche.

  • %x - bevorzugte Datumswiedergabe (ohne Zeit), abhängig von der gesetzten Umgebung.

  • %X - bevorzugte Zeitwiedergabe (ohne Datum), abhängig von der gesetzten Umgebung.

  • %y - Jahr als 2-stellige-Zahl (Bereich 00 bis 99)

  • %Y - Jahr als 4-stellige-Zahl inklusive des Jahrhunderts

  • %Z - Zeitzone, Name, oder eine Abkürzung

  • %% - ein %-Zeichen

Anmerkung: Es ist durchaus möglich, dass Ihre C-Bibliothek nicht alle angegebenen Formatierungszeichen erkennt. In diesem Fall werden diese Zeichen von der PHP-Funktion strftime() nicht unterstützt. Das bedeutet, dass z.B. %e, %T und %D (vielleicht noch weitere) auf Windowssystemen nicht funktionieren.

Beispiel 1. strftime() Beispiel

setlocale (LC_TIME, "C");
print (strftime ("%A in Finnland ist "));
setlocale (LC_TIME, "fi_FI");
print (strftime ("%A, in Frankreich "));
setlocale (LC_TIME, "fr_FR");
print (strftime ("%A und in Deutschland "));
setlocale (LC_TIME, "de_DE");
print (strftime ("%A.\n"));
Diese Beispiele funktionieren nur, wenn auf Ihrem System die entsprechenden Locale-Codes installiert sind.

Siehe auch setlocale(), mktime() und die Open Group Spezifikation von strftime().