Parameter Position | Typ | Erforderlich | Standardwert | Beschreibung |
---|---|---|---|---|
1 | string | Nein | %b %e, %Y | Das Format des ausgegebenen Datums. |
2 | string | Nein | n/a | Der Standardwert (Datum) wenn die Eingabe leer ist. |
Formatiert Datum und Uhrzeit in das definierte 'strftime()'-Format. Daten können als Unix-Timestamps, MySQL-Timestamps und jeder Zeichenkette die aus 'Monat Tag Jahr' (von strtotime parsebar) besteht übergeben werden. Designer können 'date_format' verwenden, um vollständige Kontrolle über das Format des Datums zu erhalten. Falls das übergebene Datum leer ist und der zweite Parameter übergeben wurde, wird dieser formatiert und ausgegeben.
Example 5.8. date_format (Datums Formatierung)
{$smarty.now|date_format} {$smarty.now|date_format:"%A, %B %e, %Y"} {$smarty.now|date_format:"%H:%M:%S"} AUSGABE: Feb 6, 2001 Tuesday, February 6, 2001 14:33:00
Example 5.9. 'date_format' Konvertierungs Spezifikation
%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 folgenden 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. %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 BEMERKUNG FÜR PROGRAMMIERER: 'date_format' ist ein wrapper für PHP's 'strftime()'-Funktion. Je nachdem auf welchem System ihr PHP kompiliert wurde, ist es durchaus möglich, dass nicht alle angegebenen Formatierungszeichen unterstützt werden. Beispielsweise stehen %e, %T, %R und %D (eventuell weitere) auf Windowssystemen nicht zur Verfügung.