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.

Beispiel:

echo CAT_Helper_DateTime::getDate();

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:

echo CAT_Helper_DateTime::getDate($time);

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

echo CAT_Helper_DateTime::getDate($time,true);

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

Analog zum Datum kann auch eine formatierte Uhrzeit ausgegeben werden:

echo CAT_Helper_DateTime::getTime();

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

Auch das geht:

echo CAT_Helper_DateTime::getDateTime();

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.