Planen wiederkehrender Termine als wiederkehrende Ereignisse in Outlook

Artikel
03/15/2023

Ereignisserien sind ein wichtiger Bestandteil der Kalenderfunktionen von Outlook. Ganz gleich, ob es sich um ein wöchentliches persönliches Treffen mit Ihrem Vorgesetzten oder um eine abteilungsweite Besprechung handelt, die jeden zweiten Dienstag im Monat stattfindet: Mit wiederkehrenden Ereignissen können Sie das Ereignis einmal erstellen und den Rest der Reihe vom Server ausfüllen lassen.

Die wichtigsten Informationen, mit denen Ereignisserien in einzelne Termine „erweitert“ werden können, die Serienregel. Die Regel gibt an, wie oft und wie lange sich ein Ereignis wiederholt. Die Outlook-REST-APIs modellieren Serienregeln in der Serien-Eigenschaft der Ereignisressource.

Jede Serie besteht aus zwei Teilen: dem Wiederholungsmuster (wie oft) und dem Wiederholungsbereich (wie lange).

Serienmuster

Der erste Teil einer Serie ist das Muster. Darin ist angegeben, wie oft das Ereignis wiederholt wird. Beispielsweise könnte ein Ereignis "alle 3 Tage", "jeden Donnerstag" oder "am 22. Juli jedes Jahr" wiederholt werden. Ein Muster wird in der API durch die Ressource recurrencePattern dargestellt.

Je nach Mustertyp sind bestimmte Felder des recurrencePattern obligatorisch, optional oder werden ignoriert.

Hinweis

Auch wenn Sie ein Feld ignoriert wird, wird es dennoch überprüft. Wenn ein Feld über eine festgelegte Liste möglicher Werte verfügt, führt ein Wert außerhalb der zulässigen Gruppe von Werten zu einem Fehler, selbst wenn das Feld ignoriert wird.

Werfen Sie einen Blick auf die einzelnen Arten möglicher Muster.

Täglich

Das tägliche Serienmuster bewirkt, dass ein Ereignis basierend auf einer Anzahl von Tagen zwischen zwei Vorkommen wiederholt wird.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
Intervall	Erforderlich	Gibt die Anzahl der Tage zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `daily` festgelegt werden.

Beispiele

Dieses Ereignis täglich wiederholen

  "pattern": {
    "type": "daily",
    "interval": 1
  }

Dieses Ereignis alle drei Tage wiederholen

  "pattern": {
    "type": "daily",
    "interval": 3
  }

Wöchentlich

Das wöchentliche Serienmuster bewirkt, dass ein Ereignis am gleichen Tag oder an den gleichen Tagen einer Woche basierend auf der Anzahl von Wochen zwischen zwei Vorkommen wiederholt wird.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
daysOfWeek	Erforderlich	Gibt an, an welchem/-n Tag/-en der Woche das Ereignis eintritt.
firstDayOfWeek	Optional	Gibt an, welcher Tag als erster Tag der Woche angesehen wird. Standardwert: `Sunday`.
Intervall	Erforderlich	Gibt die Anzahl der Wochen zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `weekly` festgelegt werden.

Beispiele

Dieses Ereignis jeden Donnerstag wiederholen

  "pattern": {
    "type": "weekly",
    "interval": 1,
    "daysOfWeek": [ "Thursday" ]
  }

Dieses Ereignis jeden Montag und Dienstag wiederholen

  "pattern": {
    "type": "weekly",
    "interval": 2,
    "daysOfWeek": [
      "Monday",
      "Tuesday"
    ]
  }

Absolut monatlich

Das absolute monatliche Muster bewirkt, dass ein Ereignis am gleichen Tag des Monats (z. B. dem 15.) basierend auf der Anzahl der Monate zwischen zwei Vorkommen stattfindet.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
dayOfMonth	Erforderlich	Gibt an, an welchem Tag des Monats das Ereignis eintritt.
Intervall	Erforderlich	Gibt die Anzahl der Monate zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `absoluteMonthly` festgelegt werden.

Beispiele

Dieses Ereignis jeden Monat am 15. wiederholen

  "pattern": {
    "type": "absoluteMonthly",
    "interval": 1,
    "dayOfMonth": 15
  }

Dieses Ereignis vierteljährlich (alle 3 Monate) am 7. wiederholen

  "pattern": {
    "type": "absoluteMonthly",
    "interval": 3,
    "dayOfMonth": 7
  }

Relativ monatlich

Das relative monatliche Muster bewirkt, dass ein Ereignis am gleichen Wochentag an der gleichen relativen Position des Monats basierend auf der Anzahl der Monate zwischen zwei Vorkommen stattfindet. Beispielsweise „jeden zweiten Mittwoch des Monats“.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
daysOfWeek	Erforderlich	Gibt an, an welchem/-n Tag/-en der Woche das Ereignis eintreten kann. Relative monatliche Ereignisse treten nur einmal pro Monat ein, wird also mehr als ein Wert angegeben, fällt das Ereignis auf den ersten Tag, der das Muster erfüllt.
Index	Optional	Gibt an, in welcher Instanz der zulässigen Tage, die unter daysOfsWeek angegeben sind, das Ereignis eintritt, ausgehend von der ersten Instanz des Monats gezählt. Mögliche Werte: `first`, `second`, `third`, `fourth` und `last`. Standardwert: `first`.
Intervall	Erforderlich	Gibt die Anzahl der Monate zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `relativeMonthly` festgelegt werden.

Beispiele

Dieses Ereignis jeden zweiten Mittwoch des Monats wiederholen

  "pattern": {
    "type": "relativeMonthly",
    "interval": 1,
    "daysOfWeek": [ "Wednesday" ],
    "index": "second"
  }

Dieses Ereignis jeden zweiten Mittwoch des Monats wiederholen

  "pattern": {
    "type": "relativeMonthly",
    "interval": 1,
    "daysOfWeek": [ "Thursday", "Friday" ],
    "index": "first"
  }

Absolut jährlich

Das absolut jährliche Muster bewirkt, dass ein Ereignis am gleichen Tag und im gleichen Monat (z. B. dem 15. April), basierend auf der Anzahl der Jahre zwischen zwei Vorkommen stattfindet.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
dayOfMonth	Erforderlich	Gibt an, an welchem Tag des Monats das Ereignis eintritt.
Monat	Erforderlich	Gibt an, in welchem Monat das Ereignis auftritt.
Intervall	Erforderlich	Gibt die Anzahl der Jahre zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `absoluteYearly` festgelegt werden.

Beispiel

Dieses Ereignis jedes Jahr am 15. April wiederholen

  "pattern": {
    "type": "absoluteYearly",
    "interval": 1,
    "dayOfMonth": 15,
    "month": 4
  }

Relativ jährlich

Das relative jährliche Muster bewirkt, dass ein Ereignis am gleichen Wochentag an der gleichen relativen Position eines bestimmten Monats basierend auf der Anzahl der Jahre zwischen zwei Vorkommen stattfindet. Beispielsweise „jeden letzten Mittwoch im November“.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
daysOfWeek	Erforderlich	Gibt an, an welchem/-n Tag/-en der Woche das Ereignis eintreten kann. Relative jährliche Ereignisse treten nur einmal pro Jahr ein, wird also mehr als ein Wert angegeben, fällt das Ereignis auf den ersten Tag, der das Muster erfüllt.
Index	Optional	Gibt an, in welcher Instanz der zulässigen Tage, die unter daysOfsWeek angegeben sind, das Ereignis eintritt, ausgehend von der ersten Instanz des Monats gezählt. Mögliche Werte: `first`, `second`, `third`, `fourth` und `last`. Standardwert: `first`.
Monat	Erforderlich	Gibt an, in welchem Monat das Ereignis auftritt.
Intervall	Erforderlich	Gibt die Anzahl der Jahre zwischen zwei Vorkommen an.
Typ	Erforderlich	Muss auf `relativeYearly` festgelegt werden.

Beispiele

Dieses Ereignis jedes Jahr am letzten Mittwoch im November wiederholen

  "pattern": {
    "type": "relativeYearly",
    "interval": 1,
    "daysOfWeek": [ "Wednesday" ],
    "index": "last",
    "month": 11
  }

Serienbereiche

Der zweite Teil einer Serie ist das Muster. Dies gibt an, wie lange das Muster wiederholt wird. Ein Ereignis könnte beispielsweise nach 10 Vorkommen an einem bestimmten Datum enden oder kein Ende haben. Ein Bereich wird in der API durch die recurrenceRange-Ressource dargestellt.

Je nach Bereichstyp sind bestimmte Felder der recurrenceRange obligatorisch oder werden ignoriert.

Hinweis

Werfen wir einen Blick auf die einzelnen Arten möglicher Bereiche.

Nummerierter Bereich

Der nummerierte Bereich bewirkt, dass ein Ereignis eine feste Anzahl von Vorkommen (basierend auf dem Muster) ab einem Startdatum auftritt.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
numberOfOccurrences	Erforderlich	Gibt die Anzahl von Vorkommen an. Das Vorkommen muss eine positive ganze Zahl sein.
recurrenceTimeZone	Optional	Gibt die Zeitzone für die StartDate-Eigenschaft an. Falls nicht angegeben, wird die Zeitzone des Ereignisses verwendet.
startDate	Erforderlich	Gibt das Datum des Starts des Anwendens des Musters an. Der Wert von StartDate MUSS dem Datumswert der Start-Eigenschaft der Ereignisressource entsprechen. Hinweis: Das erste Vorkommen der Besprechung kann nicht an diesem Datum stattfinden, wenn es nicht in das Muster passt.
Typ	Erforderlich	Muss auf `numbered` festgelegt werden.

Beispiele

Dieses Ereignis 10 Mal wiederholen

  "range": {
    "type": "numbered",
    "startDate": "2017-04-02",
    "numberOfOccurrences": 10
  }

Enddatumsbereich

Der Enddatumsbereich bewirkt, dass ein Ereignis an allen Tagen eintritt, die das entsprechende Muster zwischen einem Startdatum und einem Enddatum aufweisen.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
endDate	Erforderlich	Gibt das Datum zum Beenden des Anwendens des Musters an. Hinweis: Das letzte Vorkommen der Besprechung kann nicht an diesem Datum auftreten, wenn es nicht in das Muster passt.
recurrenceTimeZone	Optional	Gibt die Zeitzone für die startDate- und endDate-Eigenschaften an. Falls nicht angegeben, wird die Zeitzone des Ereignisses verwendet.
startDate	Erforderlich	Gibt das Datum des Starts des Anwendens des Musters an. Der Wert von StartDate MUSS dem Datumswert der Start-Eigenschaft der Ereignisressource entsprechen. Hinweis: Das erste Vorkommen der Besprechung kann nicht an diesem Datum stattfinden, wenn es nicht in das Muster passt.
Typ	Erforderlich	Muss auf EndDate festgelegt werden.

Beispiele

Dieses Ereignis vom 1. Juli 2017 bis zum 31. Juli 2017 wiederholen

  "range": {
    "type": "endDate",
    "startDate": "2017-07-01",
    "endDate": "2017-07-31"
  }

Kein Endbereich

Der Enddatumsbereich bewirkt, dass ein Ereignis an allen Tagen eintritt, die dem anwendbaren Muster nach einem Startdatum entsprechen.

Relevante Eigenschaften

Eigenschaft	Relevanz	Beschreibung
recurrenceTimeZone	Optional	Gibt die Zeitzone für die StartDate-Eigenschaft an. Falls nicht angegeben, wird die Zeitzone des Ereignisses verwendet.
startDate	Erforderlich	Gibt das Datum des Starts des Anwendens des Musters an. Der Wert von StartDate MUSS dem Datumswert der Start-Eigenschaft der Ereignisressource entsprechen. Hinweis: Das erste Vorkommen der Besprechung kann nicht an diesem Datum stattfinden, wenn es nicht in das Muster passt.
Typ	Erforderlich	Muss auf `noEnd` festgelegt werden.

Beispiele

Dieses Ereignis ab dem 15. Mai 2017 immer wiederholen

  "range": {
    "type": "noEnd",
    "startDate": "2017-05-15"
  }

Verwenden von Mustern und Bereichen zum Erstellen von Ereignisserien

Nachdem wir uns nun Muster und Bereiche separat angesehen haben, schauen wir uns nun deren Zusammenwirken und Interagieren mit den Start- und End-Eigenschaften zu dem Ereignis an.

Erstellen einer Serienregel

Um eine Serienregel zu erstellen, müssen Sie sowohl ein Muster als auch einen Bereich angeben. Jeder Mustertyp kann mit einem beliebigen Bereichstyp arbeiten. Im Anschluss finden Sie einige Beispiele:

Beispiele

Besprechung von 13:00-13:30 Uhr, jeden Montag ab dem 4. September 2017 bis zum Ende des Jahres
- Die Anforderung „jeden Montag“ wird ganz einfach durch den weekly-Serienmustertyp erfüllt.
- Die Anforderung „bis zum Ende des Jahres“ gibt einen endDate-Serienbereichstypen an.
```
  "recurrence": {
    "pattern": {
      "type": "weekly",
      "interval": 1,
      "daysOfWeek": [ "Monday" ]
    },
    "range": {
      "type": "endDate",
      "startDate": "2017-09-04",
      "endDate": "2017-12-31"
    }
  }
```
Da der 31. Dezember 2017 auf einen Sonntag fällt, ist das letzte Vorkommen in dieser Serie am Montag, den 25. Dezember.
Besprechung von 14:00-15:00 Uhr am ersten Donnerstag jeden zweiten Monat, ab dem 29. August 2017
- Die Anforderung „erster Donnerstag jeden zweiten Monat“ kann durch ein relatives monatliches Muster erfüllt werden. Der Teil „jeden zweiten Monats“ gibt an, dass das Intervall auf 2 festgelegt werden sollte.
- Da es keine Anforderung an ein Enddatum gibt, kann ein noEnd-Bereichstyp verwendet werden.
```
  "recurrence": {
    "pattern": {
      "type": "relativeMonthly",
      "interval": 2,
      "daysOfWeek": [ "Thursday" ],
      "index": "first"
    },
    "range": {
      "type": "noEnd",
      "startDate": "2017-08-29"
    }
  }
```
Da der Wert von startDate nach dem ersten Donnerstag im August liegt, ist das erste Vorkommen dieser Serie im September.

Erfahren Sie mehr zur Integration in Outlook-Kalender.
Weitere Beispiele für wiederkehrende Ereignisse finden Sie in der Kalender-API-Referenz:
- Erstellen eines wiederkehrenden Ereignisses, das einmal pro Woche stattfindet
- Erstellen eines täglichen wiederkehrenden Ereignisses

Planen wiederkehrender Termine als wiederkehrende Ereignisse in Outlook

Serienmuster

Täglich

Relevante Eigenschaften

Beispiele

Wöchentlich

Relevante Eigenschaften

Beispiele

Absolut monatlich

Relevante Eigenschaften

Beispiele

Relativ monatlich

Relevante Eigenschaften

Beispiele

Absolut jährlich

Relevante Eigenschaften

Beispiel

Relativ jährlich

Relevante Eigenschaften

Beispiele

Serienbereiche

Nummerierter Bereich

Relevante Eigenschaften

Beispiele

Enddatumsbereich

Relevante Eigenschaften

Beispiele

Kein Endbereich

Relevante Eigenschaften

Beispiele

Verwenden von Mustern und Bereichen zum Erstellen von Ereignisserien

Erstellen einer Serienregel

Beispiele

Feedback

Feedback

Zusätzliche Ressourcen

Planen wiederkehrender Termine als wiederkehrende Ereignisse in Outlook

Serienmuster

Täglich

Relevante Eigenschaften

Beispiele

Wöchentlich

Relevante Eigenschaften

Beispiele

Absolut monatlich

Relevante Eigenschaften

Beispiele

Relativ monatlich

Relevante Eigenschaften

Beispiele

Absolut jährlich

Relevante Eigenschaften

Beispiel

Relativ jährlich

Relevante Eigenschaften

Beispiele

Serienbereiche

Nummerierter Bereich

Relevante Eigenschaften

Beispiele

Enddatumsbereich

Relevante Eigenschaften

Beispiele

Kein Endbereich

Relevante Eigenschaften

Beispiele

Verwenden von Mustern und Bereichen zum Erstellen von Ereignisserien

Erstellen einer Serienregel

Beispiele

Verwandte Inhalte

Feedback

Feedback

Zusätzliche Ressourcen