getEvents

gibt eine Sammlung von Ereignissen zurück, die innerhalb des angegebenen Zeitraums stattfinden

array getEvents( [Date from,Date to] );
fromDatedas Startdatum des Zeitraums
toDatedas Enddatum des Zeitraums
arrayein Array von Event-Objekten

Example

const evs = scheduler.getEvents(new Date(2024,1,10),new Date(2024,2,10)); 
evs.forEach((e) => console.log(e.text));
// oder
const evs = scheduler.getEvents();// gibt alle Ereignisse zurück

Related samples

Details

Wenn die Unterstützung für recurring events aktiviert ist, variiert das Verhalten der getEvents-Methode je nachdem, ob die "from-to"-Parameter angegeben sind.

Verwendung von getEvents mit Recurring Events

  • Wenn from-to-Parameter angegeben sind, gibt die Methode alle Einzelereignisse, Vorkommen aus wiederkehrenden Serien und alle modifizierten Instanzen innerhalb dieses Zeitraums zurück:
const today = scheduler.date.day_start(new Date());
const nextWeek = scheduler.date.add(today, 1, "week");
const events = scheduler.getEvents(today, nextWeek);
  • Werden die from-to-Parameter weggelassen, gibt die Methode alle Einzelereignisse, wiederkehrende Serien als Einträge (nicht einzelne Vorkommen) sowie alle modifizierten oder gelöschten Instanzen zurück. Allerdings sind dabei die konkreten Daten der wiederkehrenden Vorkommen nicht enthalten.

In Versionen vor v7.1.2 erforderte die getEvents-Methode "from-to"-Parameter, wenn wiederkehrende Ereignisse aktiv waren. Ohne diese Parameter wurde ein leeres Array zurückgegeben, da die Recurring-Extension unendliche Ereignisfolgen erzeugen konnte, was es unpraktisch machte, alle Vorkommen zurückzugeben.

Sind wiederkehrende Ereignisse deaktiviert, verhält sich die Methode unabhängig davon, ob Parameter angegeben sind, gleich. Werden keine Parameter übergeben, gibt sie einfach alle Ereignisse zurück.

Change log

aktualisiert in v7.1.2

Nach oben