Kalender Funktionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

Beschreibung

Kalender Funktionen zur Berechnung von Kalender-Daten. Diese Methoden stellen eine einfache Alternative zu der Methode dateGet des Date-Objektes dar. Manipulation von Kalender-Daten können nur über das Date-Objekt vorgenommen werden.

Diese Methoden sollen zur logischen Auswertung von Daten dienen. Für die Ausgabe sollte der Print-Tag verwendet werden, da diser Datumsformatierungen beherrscht, die auch entsprechende Locale-Setzungen auswerten können. So liefert die Konstante system.constants.NOVEMBER nicht die Wert 11, wie man möglicherweise erwarten würde, sondern analog zur Sprache Java den Wert 10. Das korrekte Ergebnis würde jedoch stets folgender Code liefern:

<sp:print name="month(${myDate},${system.constants.MONTH})"/> liefert den Wert 10 (entspricht ${system.constants.NOVEMBER})
<sp:print name="myDate" dateformat="MM"/> liefert den Wert 11

Funktionen

Methode Rückgabewert Beschreibung ab IES Version
millisecond(Date x) Number Liefert die Millisekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 387 zurückgeliefert. 2.0.4
second(Date x) Number Liefert die Sekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 20 zurückgeliefert. 2.0.4
minute(Date x) Number Liefert die Minuten von x. Bei einer Uhrzeit von 12:43:20.387 wird 43 zurückgeliefert. 2.0.4
hour(Date x) Number Liefert die Stunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 12 zurückgeliefert. 2.0.4
day(Date x) bzw. dayOfMonth(Date x) Number Liefert die Tage von x. Bei einen Datum von 3.11.2008 wird 3 zurückgeliefert. 2.0.4
dayOfWeek(Date x) Number Liefert den Tag der Woche von x. Bei einen Datum von 3.11.2008 wird system.contants.MONDAY zurückgeliefert. Entsprechend den Werktagen wird eine der Konstanten system.contants.SUNDAY, system.contants.MONDAY, system.contants.TUESDAY, system.contants.WEDNESDAY, system.contants.THURSDAY, system.contants.FRIDAY oder system.contants.SATURDAY zurückgeliefert. 2.0.4
dayOfYear(Date x) Number Liefert den Tag des Jahres von x. Bei einen Datum von 3.11.2008 wird 308 zurückgeliefert. 2.0.4
week(Date x) bzw. weekOfYear(Date x) Number Liefert die Woche des Jahres von x. Bei einen Datum von 3.11.2008 wird 45 zurückgeliefert. 2.0.4
weekOfMonth(Date x) Number Liefert die Woche des Monats von x. Bei einen Datum von 3.11.2008 wird 1 zurückgeliefert. 2.0.4
month(Date x) Number Liefert den Monat von x. Bei einen Datum von 3.11.2008 wird system.contants.NOVEMBER zurückgeliefert. Entsprechend den Monaten wird eine der Konstanten system.contants.JANUARY, system.contants.FEBRUARY, system.contants.MARCH, system.contants.APRIL, system.contants.MAY, system.contants.JUNE, system.contants.JULY, system.contants.AUGUST, system.contants.SEPTEMBER, system.contants.OCTOBER, system.contants.NOVEMBER oder system.contants.DECEMBER zurückgeliefert. 2.0.4
year(Date x) Number Liefert das Jahr von x. Bei einen Datum von 3.11.2008 wird 2008 zurückgeliefert. 2.0.4