Kalender Funktionen: Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
 
(8 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Beschreibung==
 
==Beschreibung==
−
Kalender Funktionen zur Berechnung von Kalender-Daten
+
Kalender Funktionen zur Berechnung von Kalender-Daten. Diese Methoden stellen eine einfache Alternative zu der Methode <code>dateGet</code> des [[Date|Date-Objektes]] dar. Manipulation von Kalender-Daten können nur über das [[Date|Date-Objekt]] vorgenommen werden.
 +
 
 +
Diese Methoden sollen zur logischen Auswertung von Daten dienen. Für die Ausgabe sollte der [[Print (SP-Tag)|Print-Tag]] verwendet werden, da diser [[Dateformat|Datumsformatierungen]] beherrscht, die auch entsprechende Locale-Setzungen auswerten können. So liefert die Konstante <code>system.constants.NOVEMBER</code> nicht die Wert <code>11</code>, wie man möglicherweise erwarten würde, sondern analog zur Sprache Java den Wert <code>10</code>. Das korrekte Ergebnis würde jedoch stets folgender Code liefern:
 +
 
 +
<source lang="xml">
 +
<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
 +
</source>
  
 
==Funktionen==
 
==Funktionen==
−
{| class="prettytable"
+
{| class="prettytable sortable"
 
|- class="hintergrundfarbe1"
 
|- class="hintergrundfarbe1"
 
! Methode || Rückgabewert || Beschreibung || ab IES Version
 
! Methode || Rückgabewert || Beschreibung || ab IES Version
Zeile 10: Zeile 17:
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Millisekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 387 zurückgeliefert.
 
| Liefert die Millisekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 387 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>second([[Date]]&nbsp;x)</code>
 
| <code>second([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Sekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 20 zurückgeliefert.
 
| Liefert die Sekunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 20 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>minute([[Date]]&nbsp;x)</code>
 
| <code>minute([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Minuten von x. Bei einer Uhrzeit von 12:43:20.387 wird 43 zurückgeliefert.
 
| Liefert die Minuten von x. Bei einer Uhrzeit von 12:43:20.387 wird 43 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>hour([[Date]]&nbsp;x)</code>
 
| <code>hour([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Stunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 12 zurückgeliefert.
 
| Liefert die Stunden von x. Bei einer Uhrzeit von 12:43:20.387 wird 12 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
−
| <code>day([[Date]]&nbsp;x)</code>
+
| <code>day([[Date]]&nbsp;x)</code> bzw. <code>dayOfMonth([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Tage von x. Bei einen Datum von 3.11.2008 wird 3 zurückgeliefert.
 
| Liefert die Tage von x. Bei einen Datum von 3.11.2008 wird 3 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>dayOfWeek([[Date]]&nbsp;x)</code>
 
| <code>dayOfWeek([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert den Tag der Woche von x. Bei einen Datum von 3.11.2008 wird [[Constants|system.contants.MONDAY]] zurückgeliefert. Entsprechend den Werktagen wird eine der Konstanten [[Constants|system.contants.SUNDAY]], [[Constants|system.contants.MONDAY]], [[Constants|system.contants.TUESDAY]], [[Constants|system.contants.WEDNESDAY]], [[Constants|system.contants.THURSDAY]], [[Constants|system.contants.FRIDAY]] oder [[Constants|system.contants.SATURDAY]] zurückgeliefert.
 
| Liefert den Tag der Woche von x. Bei einen Datum von 3.11.2008 wird [[Constants|system.contants.MONDAY]] zurückgeliefert. Entsprechend den Werktagen wird eine der Konstanten [[Constants|system.contants.SUNDAY]], [[Constants|system.contants.MONDAY]], [[Constants|system.contants.TUESDAY]], [[Constants|system.contants.WEDNESDAY]], [[Constants|system.contants.THURSDAY]], [[Constants|system.contants.FRIDAY]] oder [[Constants|system.contants.SATURDAY]] zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>dayOfYear([[Date]]&nbsp;x)</code>
 
| <code>dayOfYear([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert den Tag des Jahres von x. Bei einen Datum von 3.11.2008 wird 308 zurückgeliefert.
 
| Liefert den Tag des Jahres von x. Bei einen Datum von 3.11.2008 wird 308 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
−
| <code>weekOfYear([[Date]]&nbsp;x)</code>
+
| <code>week([[Date]]&nbsp;x)</code> bzw. <code>weekOfYear([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert die Woche des Jahres von x. Bei einen Datum von 3.11.2008 wird 45 zurückgeliefert.
 
| Liefert die Woche des Jahres von x. Bei einen Datum von 3.11.2008 wird 45 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 +
|-
 +
| <code>weekOfMonth([[Date]]&nbsp;x)</code>
 +
| [[Number]]
 +
| Liefert die Woche des Monats von x. Bei einen Datum von 3.11.2008 wird 1 zurückgeliefert.
 +
| 2.0.4
 
|-
 
|-
 
| <code>month([[Date]]&nbsp;x)</code>
 
| <code>month([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
−
| Liefert den Monat von x. Bei einen Datum von 3.11.2008 wird 10 zurückgeliefert.
+
| Liefert den Monat von x. Bei einen Datum von 3.11.2008 wird [[Constants|system.contants.NOVEMBER]] zurückgeliefert. Entsprechend den Monaten wird eine der Konstanten [[Constants|system.contants.JANUARY]], [[Constants|system.contants.FEBRUARY]], [[Constants|system.contants.MARCH]], [[Constants|system.contants.APRIL]], [[Constants|system.contants.MAY]], [[Constants|system.contants.JUNE]], [[Constants|system.contants.JULY]], [[Constants|system.contants.AUGUST]], [[Constants|system.contants.SEPTEMBER]], [[Constants|system.contants.OCTOBER]], [[Constants|system.contants.NOVEMBER]] oder [[Constants|system.contants.DECEMBER]] zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|-
 
|-
 
| <code>year([[Date]]&nbsp;x)</code>
 
| <code>year([[Date]]&nbsp;x)</code>
 
| [[Number]]
 
| [[Number]]
 
| Liefert das Jahr von x. Bei einen Datum von 3.11.2008 wird 2008 zurückgeliefert.
 
| Liefert das Jahr von x. Bei einen Datum von 3.11.2008 wird 2008 zurückgeliefert.
−
| 2.0.3
+
| 2.0.4
 
|}
 
|}
  

Aktuelle Version vom 28. Mai 2009, 11:43 Uhr

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
Abgerufen von „https://wiki.sitepark.com/index.php?title=Kalender_Funktionen&oldid=3281“