| SYNOPSIS |
| string strftime() |
| string strftime(string fmt) |
| string strftime(int clock) |
| string strftime(string fmt, int clock) |
| string strftime(string fmt, int clock, int localized) |
| |
| BESCHREIBUNG |
| Gibt, aehnliche wie ctime(), eine Zeit als formatierten String zurueck. |
| Hierbei kann ein String mit div. Platzhaltern vom Benutzer angegeben |
| werden (s.u.). Wird kein String angegeben, wird "%c" als Formatstring |
| benutzt. |
| |
| Das Argument <clock> wird als Anzahl Sekunden seit dem 01.01.1970, 00:00 |
| Uhr interpretiert. Wenn <clock> nicht angegeben wird, wird time() |
| verwendet. |
| |
| Das Argument <localized> gibt an, ob die Ausgabe englisch (das sog. |
| klassische "C" locale) oder in der jeweiligen Landessprache (z.B. |
| deutsch) erfolgen soll. Hierbei haengt die Sprache allerdings von den auf |
| dem Mudrechner gesetzten Umgebungsvariablen LC_TIME oder LC_ALL ab, sie |
| kann nicht selber gewaehlt werden. Wird kein <localized> angegeben, wird |
| 1 verwendet, was einer Ausgabe in Landessprache entspricht. |
| 0: Ausgabe im klassischen "C" locale (english) |
| 1: Ausgabe in Landessprache des Mudrechners. |
| |
| ANMERKUNGEN |
| Der zurueckgebene Ergebnisstring ist max. 511 Zeichen lang. |
| |
| PLATZHALTER |
| Diese Funktion versteht alle Platzhalter, die die Funktion strftime() aus |
| der C-Standardbibliothek versteht. Momentan sind dies: |
| %a Der abgekuerzte Wochentag abhaengig von der momentanen Locale. |
| %A Der gesamte Wochentag abhaengig von der momentanen Locale. |
| %b Der abgekuerzte Monatsname abhaengig von der momentanen Locale. |
| %B Der volle Monatsname abhaengig von der momentanen Locale. |
| %c Das bevorzugte Datums- und Uhrzeit-Repraesentation laut Einstel- |
| lungen der momentanen Locale. |
| %C Das Jahrhundert als zweistellige Zahl. |
| %d Der Tag im Monat als Dezimalzahl (01 - 31). |
| %D Aequivalent zu %m/%d/%y. (US-amerikanisches Format. In anderen |
| Laendern ist %d/%m/%y durchaus ueblich . In internationalem Kon- |
| text ist dieses Format daher mehrdeutig und sollte nicht verwen- |
| det werden.) |
| %e Wie %d, der Tag im Monat als Dezimalzahl, aber eine fuehrende |
| Null ist durch ein Leerzeichen ersetzt. |
| %E Modifikator: Alternatives Format benutzen, s.u. |
| %g Wie %G, aber ohne das Jahrhundert, also mit zweistelligem Jahr |
| (00-99). |
| %G Das Jahr laut ISO 8601 mit dem Jahrhundert als Dezimalzahl. Das |
| vierstellige Jahr, das zu ISO-Wochennummer (siehe %V) passt. Es |
| hat dasselbe Format und denselben Wert wie %y, nur dass, wenn |
| die ISO-Wochennummer zum vorhergehenden oder naechsten Jahr |
| gehoert, dieses Jahr stattdessen benutzt wird. |
| %h Aequivalent zu %b. |
| %H Die Stunde im 24h-Format als Ganzzahl (00 - 23). |
| %I Die Stunde im 12h-Format als Ganzzahl (01 - 12). |
| %j Der Tag im Jahr als Ganzzahl (001 - 366). |
| %k Die Stunde im 24h-Format als Ganzzahl (0 - 23); einzelne Ziffern |
| haben ein vorangestelltes Leerzeichen. (Siehe %H.) |
| %l Die Stunde im 12h-Format als Ganzzahl (0 - 12); einzelne Ziffern |
| haben ein vorangestelltes Leerzeichen. (Siehe %I.) |
| %m Der Monat als Ganzzahl (01 - 12). |
| %M Die Minute als Ganzzahl (00 - 59). |
| %n Ein Zeilenvorschub. |
| %p Entweder 'AM' oder 'PM', je nach der uebergebenen Uhrzeit, oder |
| die zugehoerigen Zeichenketten in der momentanen Locale. Mittag |
| erhaelt 'PM', Mitternacht 'AM'. |
| %P Wie %p, aber in Kleinbuchstaben. |
| %r Zeit in AM/PM-Notation; in der POSIX-Locale ist das Aequivalent |
| zu '%I:%M:%S %p'. |
| %R Zeit in 24h-Notation (%H:%M). (SU) Fuer eine Version mit Sekunden |
| siehe %T. |
| %s Die Zahl der Sekunden seit der Epoche, also seit 1970-01-01 |
| 00:00:00 UTC. |
| %S Die Sekunde als Ganzzahl (00 - 61). |
| %t Ein Tabulatorzeichen. |
| %T Zeit in 24h-Notation (%H:%M:%S). |
| %u Der Tag der Woche als Zahl von 1 bis 7, mit Montag als 1. Siehe |
| auch %w. |
| %U Die Wochennummer des aktuellen Jahres als Ganzzahl von 00 bis |
| 53, beginnend mit dem ersten Sonntag als erster Tag der ersten |
| Woche. Siehe auch %V und %W. |
| %V Die Wochennummer nach ISO 8601:1988 als Dezimalzahl von 01 bis |
| 53, wobei Woche 1 die erste Woche ist, die wenigstens 4 Tage im |
| laufenden Jahr hat, mit Montag als dem ersten Tag der Woche. |
| Siehe auch %U und %W. |
| %w Der Tag der Woche als Zahl von 0 bis 6, mit Sonntag als 0. |
| Siehe auch %u. |
| %W Die Wochennummer des aktuellen Jahres als Ganzzahl von 00 bis |
| 53, beginnend mit dem ersten Montag als erster Tag der ersten |
| Woche. |
| %x Die bevorzugte Datums-Repraesentation ohne die Zeit in der momen- |
| tanen Locale. |
| %X Die bevorzugte Uhrzeit-Repraesentation ohne das Datum in der |
| momentanen Locale. |
| %y Das Jahr als Ganzzahl ohne das Jahrhundert (00 - 99). |
| %Y Das Jahr als Ganzzahl mit dem Jahrhundert. |
| %z Die Zeitzone als Stundendifferenz zu GMT. Benoetigt, um |
| RFC822-konforme Datumsangaben zu erhalten (mit '%a, %d %b %Y |
| %H:%M:%S %z'). |
| %Z Die Zeitzone oder der Name oder die Abkuerzung. |
| %+ Datum und Zeit im Format von date(1). |
| %% Das Zeichen '%'. |
| |
| FEHLER |
| Es gibt keinen Platzhalter fuer die Mondphase. |
| |
| BEISPIELE |
| write(strftime("Heute ist %A, der %d. %B %Y.\n")) |
| ergibt z.B. |
| "Heute ist Montag, der 24. September 2007.\n" |
| |
| GESCHICHTE |
| Eingefuehrt in LDMud 3.3.718. |
| |
| SIEHE AUCH |
| ctime(E), gmtime(E), localtime(E), mktime(E), time(E), utime(E) |