Zeitzonen, Ganztag und Serien

Ein Zeitpunkt braucht einen Offset

Verwende in API-Zeitstempeln ein explizites UTC-Z oder einen numerischen Offset: 2026-10-25T10:00:00+01:00. Eine IANA-Zone wie Europe/Berlin beschreibt Ortszeitregeln; sie ersetzt den Offset im Zeitstempel nicht. Vermeide mehrdeutige Kürzel wie „CST“.

Ganztag ist ein lokales Datum

Ein Ganztagstermin umfasst nicht immer 24 vergangene Stunden. Der 25. Oktober 2026 dauert in Europe/Berlin wegen des Endes der Sommerzeit 25 Stunden. Erhalte das lokale Datum und berücksichtige die gewünschte Kalenderzeitzone beim Vergleich belegter Intervalle.

CalDAV-Live-Abfragen akzeptieren timeZone in MCP beziehungsweise time_zone in REST. Liefert der Kalender keine nutzbare Zone, verlangt Ridian eine ausdrückliche IANA-Zone, statt still UTC anzunehmen. Ist die Zeitzone unbekannt, frage den Nutzer.

Ganztagstermin anlegen

Alvin und das MCP-Werkzeug create_event legen echte Ganztagstermine in Google-, Microsoft- und CalDAV-Kalendern an, auch in Apple iCloud. Setze allDay auf true und gib Daten statt Uhrzeiten an:

Feld	Bedeutung
startDate	Erster Tag, JJJJ-MM-TT
endDate	Letzter Tag, JJJJ-MM-TT, zählt mit. Für einen eintägigen Termin weglassen
timeZone	Deine IANA-Zone. Sie verschiebt die Daten nie

Beispiel: Eine Messe vom 27. bis 29. Oktober 2026 ist "allDay": true, "startDate": "2026-10-27", "endDate": "2026-10-29". Der Termin steht in jeder Kalender-App an genau diesen drei Tagen. Ein Ganztagstermin umfasst bis zu 366 Tage; eine ganztägige Serie legst du in der Kalender-App an. list_events liefert solche Termine mit showWithoutTime: true.

Titel, Beschreibung, Ort und Verfügbarkeit eines Ganztagstermins lassen sich mit update_event ändern. Für ein anderes Datum nutze die Kalender-App; Ridian lässt einen Ganztagstermin ganztägig.

Eine Serie ist keine Sammlung unabhängiger Termine

Eine wiederkehrende Serie hat Regeln und gegebenenfalls verschobene oder abgesagte Instanzen. Zeitraumabfragen müssen diese Ausnahmen beachten. Viele einzelne wöchentliche Termine anzulegen erzeugt keine native Serie.

Serien mit Alvin und MCP

Aktion	Google und Microsoft	Apple iCloud / CalDAV
Bestehende Serien einschließlich Ausnahmen lesen	Unterstützt	Unterstützt
Begrenzte Wochenserie ohne Gäste anlegen	Unterstützt	In der Kalender-App
Tägliche, monatliche, jährliche oder frei definierte Serie anlegen	In der Kalender-App	In der Kalender-App
Ein Vorkommen einer eigenen Serie ohne Gäste ändern, verschieben oder löschen	Unterstützt	Unterstützt
Ganze Serie umbenennen oder Beschreibung oder Ort ändern	Unterstützt	Unterstützt
Zeitplan einer ganzen Serie ändern oder sie löschen	In der Kalender-App	In der Kalender-App
Diesen und alle folgenden Termine ändern	In der Kalender-App	In der Kalender-App

Bei der Anlage einer Wochenserie bestimmen Beginn und IANA-Zeitzone den einen Wochentag und die lokale Uhrzeit. Die Wiederholung erfolgt jede Woche oder alle N Wochen. Erlaubt sind 2–104 Vorkommen einschließlich des ersten; das letzte liegt höchstens 104 Wochen nach dem ersten. Gib die Gesamtanzahl ausdrücklich an. Beginn und Ende des ersten Termins liegen am selben lokalen Tag; mehrdeutige Uhrzeiten und Termine über einen Uhrwechsel sind für die Anlage ausgeschlossen.

Beispiel: „Lege im Google-Arbeitskalender ab dem 15. Oktober 2026 jeden zweiten Donnerstag von 10 bis 11 Uhr acht Fokusblöcke als Serie ohne Gäste an, Zeitzone Europe/Berlin.“ Bei Alvins Modus Vor Änderungen fragen prüfst und bestätigst du die Angaben vor der Anlage; Automatisch ausführen erledigt erlaubte Aufträge direkt. Beim MCP beschreiben recurrence.frequency=weekly, interval=2 und count=8 diese Wiederholung; das vollständige Schema steht bei create_event.

Für ein einzelnes Vorkommen nennst du es genau, zum Beispiel: „Verschiebe das Team-Meeting am nächsten Dienstag auf 14 Uhr, nur diesen Termin.“ Der Assistent liest zuerst die Serie und ändert nur das gefundene Vorkommen; MCP-Clients übergeben dafür die occurrenceId aus list_events an update_event oder delete_event. Zum Umbenennen der ganzen Serie ändert editScope: "series" Titel, Beschreibung oder Ort aller Vorkommen; einzeln geänderte Vorkommen können ihre eigenen Werte behalten, der Zeitplan bleibt gleich. Wurde die Serie inzwischen geändert, wird nichts übernommen; lies die Serie erneut und wiederhole die Anfrage.

Mehrere Wochentage, etwa Montag bis Freitag, Enddatum statt Anzahl, unbegrenzte Wiederholungen und frei eingegebene Wiederholungsregeln werden in der Kalender-App angelegt. Der Umfang für Kalender-Sync ist davon getrennt.

Serien im Kalender-Sync

Zwischen Google und Microsoft überträgt Ridian Änderungen und Absagen einzelner Vorkommen einer nativen Serie. Uhrzeiten folgen der Zeitzone der Serie auch über die Zeitumstellung; Ganztage behalten ihr Datum. Die Inhaltsrichtlinie gilt auch für Ausnahmen: Bei „Nur Belegtzeiten“ werden keine Beschreibung oder Ortsangaben übertragen.

Pro Serie werden höchstens 1.000 Ausnahmen verarbeitet. Microsoft kann eine Verschiebung über benachbarte Vorkommen hinaus ablehnen. Solche Grenzen führen zu einem Sync-Fehler; eine unvollständige Serie wird nicht als erfolgreich übertragen bestätigt. Prüfe bei einer Abweichung den Status der Verbindung und folge der Sync-Fehlerbehebung.

Zeitfenster begrenzen

Termin- und Verfügbarkeitsabfragen sind auf 20 Kalender und 744 verstrichene Stunden (31 × 24 Stunden) begrenzt. Durch die Umstellung auf Winterzeit können 31 lokale Kalendertage 745 Stunden umfassen. Teile längere Zeiträume in direkt aufeinanderfolgende Fenster; das Ende jedes Fensters ist exklusiv. Frage die tatsächlich gewünschten Stunden ab; eine volle Woche enthält auch Nächte. Nutze bei dichten Kalendern kleinere Fenster, statt ein Teilergebnis für vollständig zu halten. Termine, die das Fenster überschneiden, kommen mit echtem Beginn und echter Dauer zurück, auch wenn sie früher begonnen haben. Kann ein Kalender oder ein Teil des Fensters nicht gelesen werden, liefern list_events und search_events die übrigen Termine trotzdem, und warnings nennt je betroffenem Kalender die fehlenden UTC-Zeiträume oder die Zahl übersprungener Termine; das Ergebnis deckt diese nicht ab.