Englisch: |
PmWikiDe /
Formatierungsanweisungen im Ausdruck
Autoren (Fortgeschrittene)
Der substrDer substr-Ausdruck schneidet Teile aus einem String heraus. Die Argumente werden durch Leerzeichen getrennt. Es sind
Beispiele:
Um die letzten n Zeichen aus einem String herauszuschneiden, verwenden Sie ftimeftime-Ausdrücke dienen der Formatierung von Datum und Zeit. Das allgemeine Format ist {(ftime "fmt" "when")}
{(ftime fmt="fmt" when="when" tz="tz" locale="locale")}
worin "fmt" ein Formatstring und "when" die zu formatierende Zeit ist. Die Argumente können in beiden Reihenfolgen geschrieben werden und können die optionalen Labels "fmt=" und "when=" nutzen. Das "tz"-Argument (time zone, Zeitzone) erlaubt das Setzen einer anderen Zeitzone, wenn auch nur in Installationen, die PHP 5.1 oder neuer nutzen. Siehe die Liste der unterstützten Zeitzonen, Argumente, die dort nicht zu finden sind, werden stillschweigend ignoriert. Das "locale"-Argument (language locale, lokale Sprache) erlaubt, das Zeitformat mit Wochentagen und Monaten in einer anderen Sprache auszugeben, sofern diese lokale Sprache auf dem Server verfügbar ist. Sie können mehrere "locale" zum Durchprobieren angeben, getrennt durch Kommata oder Leerzeichen, z. B. "fr_FR.utf8,fr_FR,fr". Wenn keine der gelisteten "locale" verfügbar ist, wird das Argument stillschweigend ignoriert. Wenn Sie bei internationalen "locale"-Einstellungen seltsame Zeichen sehen, versuchen Sie den ".uft8"- oder "UTF-8"-Teil hinzuzufügen oder wegzulassen, d. h. versuchen sie Beides – "fr_FR.utf8" und "fr_FR" – um zu sehen, welches bei Ihnen funktioniert. Wikis mit aktiviertem UTF-8 werden eher den ".utf8"-Teil brauchen. Beispiele:
Der "fmt"-Parameter ist das, was auf fmt= folgt, oder ein String, dessen erstes Zeichen ein '%' ist oder der Standard der Site (z. B. festgelegt in config.php). Die Formatkodes sind beschrieben in https://www.php.net/manual/de/function.strftime.php. In Ergänzung dazu ergibt '%o' die Endung einer Ordnungszahl ("st" für 1st), '%F' ein ISO-8601-Datum und '%s' einen UNIX-Zeitstempel (Sekunden seit 1.1.1970). Einige gebräuchliche Formatstrings sind: %F # ISO-8601-Datum "2024-11-01"
%s # Unix-Zeitstempel "1730468537"
%H:%M:%S # Zeit als hh:mm:ss "13:42:17"
%m/%d/%Y # Datum als mm/dd/yyyy "11/01/2024"
"%A, %B %e%o, %Y" # in Worten "Friday, November 1st, 2024"
"%A, %d. %B %Y" # in Worten (alternativ) "Friday, 01. November 2024"
Der "when"-Parameter versteht viele verschiedene Datumsformate. Der "when"-Parameter ist das, was auf when= folgt oder was nach dem Erkennen des Formatparameters übrigbleibt. Einige Beispiele: 2007-04-11 # ISO-8601-Datum
20070411 # Datum ohne Bindestriche, Schrägstriche oder Punkte
2007-03 # Monat
@1176304315 # Unix-Zeitstempel (Sekunden seit 1-Jan-1970 00:00 UTC)
now # Die aktuelle Zeit
today # heute um 00:00:00 Uhr
yesterday # gestern um 00:00:00 Uhr
"next Monday" # relatives Datum
"last Thursday" # relatives Datum
"-3 days" # vor drei Tagen
"+2 weeks" # in zwei Wochen ab jetzt
Anmerkung: Wenn Sie einen Unix-Zeitstempel umwandeln wollen, müssen Sie ein '@' voranstellen, also
auch wenn die Zeit aus einer Variablen stammt, wie hier:
Der "when"-Parameter nutzt PHPs strtotime-Funktion, um Datumstrings gemäß des GNU- Datum-Eingabe-Formats umzuwandeln; diese Funktion versteht nur englische Phrasen in Datumsangaben. Die Variable Ein ungültiger "when"-Parameter evaluiert zu @000000, also 01.01.1970 00:00Uhr. strlenDer strlen-Ausdruck gibt die Länge des Strings zurück. Das Argument ist der nachzumessende String. Das Argument muss in Anführungszeichen gesetzt sein, auch wenn es kein literaler String ist.
randDer rand-Ausdruck liefert eine Zufallszahl aus dem Bereich der ganzen Zahlen. Das erste Argument bezeichnet die kleinste Zahl, die zurückgegeben werden soll, das zweite Argument bezeichnet die größte Zahl, die zurückgegeben werden soll. Ohne Argumente erhält man eine Zahl zwischen 0 und RAND_MAX (Es heißt, die sei 2147483647, die Hälfte der größten Integerzahl. Es ist aber vom Betriebssystem abhängig, wie groß diese Zahl letztendlich ist).
modDer erweiterte "mod"-Ausdruck gibt den Modulo (Divisionsrest) einer Division zweier Zahlen zurück. Es kann in erweiterten Seitenlistenvorlagen zusammen mit
toupper / tolowerDer toupper- und der tolower-Ausdruck wandeln einen String in Groß- bzw. Kleinbuchstaben um. Das Argument ist der umzuwandelnde String.
ucfirstDer ucfirst-Ausdruck wandelt das erste Zeichen des Strings in einen Großbuchstaben um, wenn es ein Buchstabe ist. Das Argument ist der umzuwandelnde String.
ucwordsDer ucwords-Ausdruck wandelt den ersten Buchstaben jeden Wortes in dem String in einen Großbuchstaben um (eigentlich des erste Zeichen und jedes Zeichen nach einem Leerzeichen, wenn es denn ein Buchstabe ist). Das Argument ist der umzuwandelnde String.
pagenameDer pagename-Ausdruck bildet einen Seitennamen aus einem String. Der Seitenname eignet sich als Name zum Speichern, ist in WikiWordSchreibweise geschrieben und enthält keine für Dateisysteme verbotenen Zeichen und keine Leerzeichen mehr. Das Argument ist der umzuwandelnde String.
asspacedDer asspaced-Ausdruck zerlegt WikiWörter, indem es Leerzeichen vor Großbuchstaben einfügt. Das Argument ist der umzuwandelnde String.
Verschachteln von AusdrückenDie hier beschriebenen Ausdrücke können verschachtelt werden.
Der innere Ausdruck darf nicht mehr von geschweiften Klammern umgeben sein. Das Setzen von Anführungszeichen ist eine diffizile Angelegenheit. Anmerkungen
Siehe auch
Übersetzung von PmWiki.MarkupExpressions, Originalseite auf PmWikiDe.MarkupExpressions — Backlinks
|