====== 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 einfach ''%%null%%'' ü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):

<code php>
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!
</code>


===== 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                                                     |