TeamCalendar
Langue

Documentation

Qu’est-ce que le format de fichier ICS ?

Internet Calendaring and Scheduling

ICS est un format de fichier qui permet aux internautes de partager des événements d’agenda avec d’autres internautes, en échangeant des fichiers ou en envoyant des e-mails. Les fichiers ICS servent souvent à envoyer des invitations à des réunions, ou à s’abonner à des calendriers de jours fériés ou d’anniversaires. Ces fichiers peuvent être ouverts et importés par de nombreux logiciels d’agenda, dont Microsoft Outlook, Google Calendar et Apple Calendar.

Le format de fichier ICS est défini par la RFC 5545, Internet Calendaring and Scheduling Core Object Specification. Il s’appuie sur le format vCalendar antérieur, défini dans la RFC 2445.

Les fichiers ICS sont de simples fichiers texte qui contiennent des informations sur des événements d’agenda. Ils peuvent inclure des détails comme la description de l’événement, ses heures de début et de fin, son lieu et d’autres informations. Ils peuvent aussi décrire des événements récurrents, comme des réunions hebdomadaires ou des anniversaires, et, dans le cas de TeamCalendar.com, des calendriers sportifs.

Comme un fichier ics est un simple fichier texte, il est aussi assez facile à lire. Voici à quoi ressemble un exemple d’entrée ics. C’est ce que TeamCalendar transmet à votre application d’agenda.

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

Le fichier texte est assez facile à comprendre si vous le lisez de haut en bas.

  • BEGIN:VEVENT - Marque le début d’un nouvel événement
  • UID - Identifiant unique de l’événement
  • DTSTAMP - Date et heure de création de l’événement
  • SUMMARY - Titre de l’événement
  • DESCRIPTION - Description de l’événement
  • LOCATION - Lieu de l’événement
  • DTSTART - Date et heure de début de l’événement. Pour gérer les fuseaux horaires, TeamCalendar publie toutes les dates et heures en temps universel coordonné (UTC). Google ou Outlook les convertit ensuite dans votre fuseau horaire actuel. C’est très pratique, surtout en voyage, lorsque votre agenda change automatiquement de fuseau horaire.
  • DTEND - Date et heure de fin de l’événement. TeamCalendar ne connaît l’heure de fin d’un événement qu’une fois celui-ci terminé ; pour remplir votre agenda, nous utilisons donc par défaut la durée moyenne d’un match, selon la ligue du calendrier.
  • GEO - Géolocalisation de l’événement. Très utile pour obtenir un itinéraire sans adresse précise, notamment pour les événements à l’étranger où les adresses sont formatées différemment (ou absentes). Les applications d’itinéraire (Apple Maps, Google Maps, Waze, etc.) savent toutes naviguer à partir de coordonnées GPS.
  • X-APPLE-STRUCTURED-LOCATION - Lieu structuré de l’événement
  • CREATED - Date et heure de création de l’événement - utilisé en interne par TeamCalendar
  • LAST-MODIFIED - Date et heure de la dernière modification de l’événement - utilisé en interne par TeamCalendar. Nous le mettons à jour lorsque l’événement change, ce qui indique à Google, Microsoft ou Apple que l’événement a été modifié.
  • BEGIN:VALARM - Marque le début d’une nouvelle alarme
  • ACTION - Action de l’alarme
  • DESCRIPTION - Description de l’alarme
  • TRIGGER - Déclencheur de l’alarme
  • END:VALARM - Marque la fin de l’alarme
  • END:VEVENT - Marque la fin de l’événement

Autres articles