TeamCalendar
Sprache

Dokumentation

Was ist das ICS-Dateiformat?

Internet Calendaring and Scheduling

ICS ist ein Dateiformat, mit dem Internetnutzer Kalendertermine mit anderen teilen können, indem sie Dateien weitergeben oder E-Mails senden. ICS-Dateien werden oft genutzt, um Besprechungsanfragen zu verschicken oder um Feiertags- oder Geburtstagskalender zu abonnieren. Die Dateien lassen sich von verschiedenen Kalenderprogrammen öffnen und importieren, darunter Microsoft Outlook, Google Calendar und Apple Calendar.

Das ICS-Dateiformat ist in RFC 5545 festgelegt, der Internet Calendaring and Scheduling Core Object Specification. Das Format basiert auf dem älteren vCalendar-Format, das in RFC 2445 festgelegt wurde.

ICS-Dateien sind einfache Textdateien mit Informationen zu Kalenderterminen. Sie können Details wie Terminbeschreibungen, Start- und Endzeiten, Orte und weitere Angaben enthalten. Außerdem können sie Informationen zu wiederkehrenden Terminen enthalten, etwa wöchentlichen Besprechungen oder monatlichen Geburtstagen – und bei TeamCalendar.com Spielpläne von Sportteams.

Weil ICS eine einfache Textdatei ist, lässt sie sich auch ziemlich leicht lesen. So sieht ein Beispieleintrag aus. Genau das liefert TeamCalendar an deine Kalender-App.

BEGIN:VEVENT
                    UID:9b950757-21e5-4443-afde-8faafdc58101@TeamCalendar.com
                    DTSTAMP:20240317T024915Z
                    SUMMARY:⚾️ Arizona Diamondbacks host St. Louis Cardinals
                    DESCRIPTION:\nhttps://TeamCalendar.com/app/T9qgt4MERu Use this link to Add or Remove team schedules from your TeamCalendar.\n\nThank you for using Te amCalendar.com! If you like our calendar service\, please consider sharing with your friends.
                    LOCATION:Chase Field: Phoenix\, AZ USA
                    DTSTART:20240413T014000Z
                    DTEND:20240413T044000Z
                    GEO:33.445278;-112.066944
                    X-APPLE-STRUCTURED-LOCATION;VALUE=URI;
                    X-ADDRESS=Chase Field: Phoenix\, AZ USA;
                    X-APPLE-RADIUS=72;
                    X-TITLE=Chase Field:geo:33.445278,-112.066944
                    CREATED:20240317T024915Z
                    LAST-MODIFIED:20240331T182349Z
                    BEGIN:VALARM
                    ACTION:DISPLAY
                    DESCRIPTION:⚾️ Diamondbacks host St. Louis Cardinals starts in one hour
                    TRIGGER:-PT60M
                    END:VALARM
                    END:VEVENT

Die Textdatei ist ziemlich leicht zu verstehen, wenn du sie von oben nach unten liest.

  • BEGIN:VEVENT - Hier beginnt ein neuer Termin
  • UID - Eine eindeutige Kennung für den Termin
  • DTSTAMP - Datum und Uhrzeit, zu denen der Termin erstellt wurde
  • SUMMARY - Der Titel des Termins
  • DESCRIPTION - Eine Beschreibung des Termins
  • LOCATION - Der Ort des Termins
  • DTSTART - Startdatum und -uhrzeit des Termins. Für die Zeitzonen-Unterstützung veröffentlicht TeamCalendar alle Daten und Uhrzeiten in koordinierter Weltzeit (auch UTC genannt). Google oder Outlook rechnet das dann in deine aktuelle Zeitzone um. Das ist sehr praktisch, besonders auf Reisen, wenn dein Kalender die Zeitzone automatisch wechselt.
  • DTEND - Enddatum und -uhrzeit des Termins. TeamCalendar kennt das Ende eines Spiels erst, wenn es vorbei ist. Damit dein Kalender trotzdem gefüllt ist, setzen wir standardmäßig die durchschnittliche Spieldauer der jeweiligen Liga an.
  • GEO - Die Geoposition des Termins. Sehr hilfreich für die Wegbeschreibung, wenn keine genaue Straßenadresse vorliegt. Praktisch bei internationalen Events, bei denen Adressen anders formatiert sind (oder fehlen). Navigations-Apps (Apple Maps, Google Maps, Waze usw.) können alle anhand von GPS-Koordinaten navigieren.
  • X-APPLE-STRUCTURED-LOCATION - Der strukturierte Ort des Termins
  • CREATED - Datum und Uhrzeit, zu denen der Termin erstellt wurde – intern von TeamCalendar genutzt
  • LAST-MODIFIED - Datum und Uhrzeit der letzten Änderung des Termins – intern von TeamCalendar genutzt. Wir aktualisieren diesen Wert, wenn sich der Termin ändert. So wissen Google/Microsoft/Apple, dass der Termin aktualisiert wurde.
  • BEGIN:VALARM - Hier beginnt eine neue Erinnerung
  • ACTION - Die Aktion der Erinnerung
  • DESCRIPTION - Die Beschreibung der Erinnerung
  • TRIGGER - Der Auslöser der Erinnerung
  • END:VALARM - Hier endet die Erinnerung
  • END:VEVENT - Hier endet der Termin

Weitere Artikel