» Projekte » gsCalendar » Dokumentation » Datum
gsCalendar: Datum
Datumsformat festlegen
setDateFormat(string format)
Diese Funktion legt das Datumsformat für den betreffenden Kalender fest.
Das vom Kalender verwendete Datumsformat kann aus folgenden Formatzeichen zusammengesetzt werden:
| Formatzeichen | Beschreibung | Beispiel |
|---|---|---|
| d | Tag des Monats ohne führende Nullen | 1 bis 31 |
| dd | Tag des Monats, 2-stellig mit führender Null | 01 bis 31 |
| m | Monat als Zahl ohne führenden Nullen | 1 bis 12 |
| mm | Monat als Zahl, mit führenden Nullen | 01 bis 12 |
| mmm | Monatsname mit drei Buchstaben | Jan bis Dez |
| mmmm | Monat als ganzes Wort | Januar bis Dezember |
| yyyy | Vierstellige Jahreszahl | Beispiel: 2004 oder 1999 |
Das Datumsformat muss immer aus drei Teilen (Tag, Monat, Jahr) bestehen, die Reihenfolge ist dabei egal. Folgende Trennzeichen sind zwischen den Formatzeichen erlaubt:
- Punkt (
.) - Bindestrich (
-) - Leerzeichen (
- Schrägstrich (
/)
Nach dem Formatzeichen für den Tag (d bzw. dd) ist auch ein Punkt gefolgt von einem Leerzeichen (. ) möglich.
Beispiele:
cal.setDateFormat('yyyy-mm-dd');
cal.setDateFormat('dd. mmmm yyyy');
cal.setDateFormat('d/m/yyyy');
cal.setDateFormat('dd mmm yyyy');
Das vorausgewählte Datum festlegen
setDate(int year, int month, int day)
Mit dieser Methode kann man das gewählte Datum des Kalenders ändern. Normalerweise wird der Kalender mit dem aktuellen Datum bzw. mit dem global festgelegten Datum initialisiert.
Beispiel:
// den Kalender mit dem gewünschten Datum
// initialisieren (hier auf mein Geburtsdatum)
cal.setDate(1983, 9, 26);
Das aktuelle Datum fix vorgeben
gscSetCurrentDate(int year, int month, int day)
Wer nicht darauf vertrauen möchte, dass der Benutzer auf seinem Computer das richtige Datum eingestellt hat und die Möglichkeit besitzt mittels Perl, PHP, SSI oder Ähnlichem die Seite dynamisch zu verändern, kann mit dieser Funktion das aktuelle Datum festlegen.
Der Aufruf dieser Funktion sollte vor dem Erstellen aller Kalender geschehen. Somit kann gewährleistet werden, dass jeder Kalender das mit dieser Funktion festgelegte Datum benutzt.
Beispiel:
// das Datum festlegen
gscSetCurrentDate(2004, 2, 29);
// jetzt können Kalender erstellt werden...