» Projekte » gsCalendar » Dokumentation » Datumsbereich einschränken
gsCalendar: Datumsbereich einschränken
Datumsbereich einschränken
addAllowedDates(string fromDate [, toDate])
addAllowedDates(Date fromDate [, toDate])
addForbiddenDates(string fromDate [, toDate])
addForbiddenDates(Date fromDate [, toDate])
Der auswählbare Datumsbereich kann auf drei verschiedene Arten eingeschränkt werden:
- Es ist jedes Datum verboten, dass nicht ausdrücklich erlaubt wurde
- Es ist jedes Datum erlaubt, dass nicht ausdrücklich verboten wurde
- Die Auswahl aller in der Vergangenheit oder Zukunft liegenden Daten verbieten.
Ersteres ist mit dem Aufruf der Funktion addAllowedDates() und zweiteres mit dem Aufruf der Funktion addForbiddenDates() möglich.
Beide Funktionen haben die gleichen Parameter, wobei entweder nur ein Datum verboten bzw. erlaubt werden kann (nur der erste Parameter ist nötig) oder auch ein Datumsbereich angegeben werden kann. Die übergebenen Daten können entweder vom Typ Date oder vom Typ string sein. Wenn das Datum als Text übergeben wird, muss das Datumsformat mit dem des Kalenders übereinstimmen.
Sie können diese Funktionen auch mehrmals aufrufen, um so verschiedene Datumsbereiche einschränken zu können.
Beispiele für addAllowedDates():
cal.setDateFormat('yyyy-mm-dd');
// den Bereich zwischen dem 01.02.2004 und dem 29.02.2004 erlauben
cal.addAllowedDates('2004-02-01', '2004-02-29');
// den 01. März 2004 erlauben
cal.addAllowedDates(new Date(2004, 2, 1));
Beispiele für addForbiddenDates():
cal.setDateFormat('yyyy-mm-dd');
// den Bereich zwischen dem 25.12.2004 und dem 31.12.2004 verbieten
cal.addForbiddenDates('2004-12-25', '2004-12-31');
// den 06. Januar 2005 verbieten
cal.addForbiddenDates(new Date(2005, 1, 6));
Achtung: Es kann für jeden Kalender nur eine der beiden Funktionen verwendet werden!
Datumsauswahl auf die Vergangenheit/Zukunft beschränken
disableFuture([boolean disableToday = false])
disablePast([boolean disableToday = false])
Die Funktion disableFuture() verbietet die Auswahl jeglichen in der Zukunft liegenden Datums. Der Aufruf disablePast() bewirkt natürlich genau das Gegenteil.
Mit dem Parameter disableToday kann gesteuert werden, ob die Auswahl des aktuellen Datums ebenfalls verboten (disableToday = true) oder erlaubt (disableToday = false) werden soll. Der Standardwert von disableToday ist false.
Beispiele:
// verbietet die Auswahl eines in der Zukunft liegenden
// Datums und des aktuellen Datums
cal.disableFuture();
// verbietet die Auswahl eines in der Vergangenheit
// liegenden Datums, erlaubt jedoch die Auswahl
// des aktuellen Datums
cal.disablePast(true);
Achtung: Wenn eine der beiden Funktionen verwendet wird, ist die Benutzung von addAllowedDates() leider nicht möglich. Die Funktion addForbiddenDates() kann jedoch problemlos verwendet werden.