====== Datum und Uhrzeit ======

Der DateTime-Helper dient in erster Linie der Formatierung von Datum und Uhrzeit gemäß den Einstellungen, die der Benutzer vorgenommen hat. Der Modulautor muß sich also nicht um die korrekte Formatierung kümmern und auch keine eigenen Einstellungen für das Datumsformat vorsehen.

===== Formatiertes Datum ausgeben =====

Beispiel:
<sxh php>echo CAT_Helper_DateTime::getDate();</sxh>

Ohne Angabe eines Timestamps (also das, was ''time()'' zurückliefert) gibt ''getDate()'' automatisch das aktuelle Datum zurück. Es ist also nicht notwendig, als Parameter ''time()'' anzugeben.

Um ein beliebiges anderes Datum zu formatieren, wird dieses als Parameter angegeben:
<sxh php>echo CAT_Helper_DateTime::getDate($time);</sxh>

Die Funktion verfügt über einen optionalen zweiten Parameter, mit dessen Hilfe statt des kurzen ein langes Datumsformat ausgegeben wird. 

**Beispiel**:

  * Kurzes Format -> 09.08.2014
  * Langes Format -> Samstag, den 09. August 2014

<sxh php>echo CAT_Helper_DateTime::getDate($time,true);</sxh>

Das genaue Format wird aus den Benutzer- bzw. globalen Einstellungen genommen.

===== Uhrzeit ausgeben =====

Analog zum Datum kann auch eine formatierte Uhrzeit ausgegeben werden:
<sxh php>echo CAT_Helper_DateTime::getTime();</sxh>

Diese Funktion erwartet als einzigen (optionalen) Parameter einen Timestring. Auch hier wird die aktuelle Uhrzeit ausgegeben, wenn kein Zeitstempel übergeben wurde.

===== Datum UND Uhrzeit =====

Auch das geht:
<sxh php>echo CAT_Helper_DateTime::getDateTime();</sxh>

===== Dwoo Plugins =====

Zur Nutzung bzw. Formatierung von Datumsangaben passend zu den CMS-Einstellungen existiert auch ein Dwoo-Plugin: 

    {format_date()}
    bzw.
    {format_date(<Timestamp>)}
    bzw.
    {format_date(<Timestamp>,1)}

Ein entsprechendes Plugin für Zeitangaben gibt es derzeit nicht.