Metainformationen zur Seite
Dies ist eine alte Version des Dokuments!
Datums- und Zeit-Funktionen
LoxBerry XL stellt eine Reihe von Funktionen bereit, um mit Datum und Zeit zu arbeiten, und diese für eine Logik bzw. für Anzeige/Sprachausgabe aufzubereiten.
Grundsätzlich gilt für alle Datums- und Zeitfunktionen in LoxBerry XL:
- Wird ein Zeitparameter weggelassen, der String
"now"oder einfachnullübergeben, wird die aktuelle Zeit und das aktuelle Datum herangezogen. - Wird als Zeitparameter eine Epoch-Zeit übergeben, wird mit dieser Zeit gerechnet.
- Wird als Zeitparameter ein String im Format
"dd.mm.yyyy hh:mm"übergeben, wird mit dieser Angabe gerechnet.
Hier ein Beispiel anhand der Funktion $xl→minofday (Minuten seit Mitternacht):
echo $xl->minofday; // Liefert mit der aktuellen Uhrzeit "596" (Minuten seit Mitternacht) echo $xl->minofday(time()-60); // Liefert "595" (60 Sekunden vor "jetzt") echo $xl->minofday("24.03.2020 23:59"); // Liefert "1439" (weil letzte Minute vor Mitternacht) echo $xl->minofday("24.03.2020 23:59:59"); // !! Liefert einen Fehler! Sekunden bei der Zeitangabe sind nicht unterstützt!
Funktionen
| Funktionsaufruf | Beispiel-Ergebnis | Rückgabewert |
|---|---|---|
| Grundfunktionen | ||
| $xl→hour | 9 | Liefert die aktuelle Stunde (0-23) |
| $xl→minute | 53 | Liefert die aktuelle Minute (0-59) |
| $xl→day | 21 | Liefert den Tag des Monats (1-31) |
| $xl→month | 2 | Liefert das Monat des Jahrs (1-12) |
| $xl→year | 2020 | Liefert das Jahr (vierstellig) |
| Erweiterte Funktionen | ||
| $xl→dayofyear | 52 | Liefert den Tag des Jahres (1-366) |
| $xl→minofday | 596 | Liefert die Minuten seit Mitternacht |
| $xl→weekday | 5 | Der Wochentag (1…Mo 7…So) |
| $xl→week | 8 | Liefert die Kalenderwoche (nach ISO-8601:1988 erste Woche mit 4 Tagen) (1-53) |
| $xl→season | 4 | Astronomische/Kalendarische Jahreszeit 1…Frühling, 2…Sommer, 3…Herbst, 4…Winter |
| Datum und Zeit als Zeichenkette | ||
| $xl→date | 21.02. | Das Datum als String, ohne Jahresangabe |
| $xl→datetext | 21. Februar | Das Datum als String mit ausgeschriebenem Monat, ohne Jahr |
| $xl→time | 09:53 | Die Uhrzeit als String (hh:mm) |
| $xl→weekdaytext | Freitag | Der Wochentag als Text (Montag bis Sonntag) |
| $xl→monthtext | Februar | Das Monat als Text (Januar bis Dezember) |
| Lustige Funktionen | ||
| $xl→toxmasdays | 306 | Anzahl der Tage bis Weihnachten=24.12. 0:00 Uhr (0-365) |
| $xl→toxmastext | 10 Monate, 2 Tage und 13 Stunden | Die Dauer als Text bis Weihnachten |