iCalendar : dé­fi­ni­tion et ex­pli­ca­tion du format d’échange de données

Avec iCalendar, chacun peut regrouper ses rendez-vous issus de dif­fé­rents pro­grammes dans un format unique. Ces évé­ne­ments peuvent ensuite être gérés et modifiés sous forme de fichiers dans un format stan­dar­disé. Étant un standard largement répandu, le format iCalendar, souvent utilisé sous forme de fichiers ICS, peut être manipulé par pra­ti­que­ment tout le monde, quel que soit le logiciel ou l’appareil utilisé.

Qu’est-ce que le format iCal ?

iCalendar est un format d’échange de ca­len­drier pour la diffusion d’éléments de ca­len­drier, normalisé dans le RFC 5545. Il permet de regrouper, gérer et partager les rendez-vous issus de dif­fé­rentes ap­pli­ca­tions sur PC et smart­phone dans un seul ca­len­drier. Le format est l’évolution du vCalendar, un format de ca­len­drier élec­tro­nique antérieur. Avec le format iCal, il est donc possible de gérer et partager de manière pratique tous les rendez-vous de dif­fé­rentes fonctions de ca­len­drier dans un format clair en temps réel.

Qu’est-ce que l’iCal ?

Selon le système d’ex­ploi­ta­tion, les fichiers iCalendar ont une abré­via­tion dif­fé­rente et beaucoup de gens se demandent, lors d’une recherche, ce que iCAL, ICS ou iFBF signifie. Il s’agit en fait toujours d’ex­ten­sions de fichiers iCalendar. .ics, .ifb, .ical et .ifbf désignent toujours des fichiers au format iCal, mais pré­sen­tent certaines dif­fé­rences.

• ical : extension de nom pour macOS
• ics : extension de nom de fichier pour tous les autres systèmes d’ex­ploi­ta­tion
• ifbf : contient des in­for­ma­tions sur la dis­po­ni­bi­lité pour macOS
• ifb : contient des in­for­ma­tions sur la dis­po­ni­bi­lité pour les autres systèmes d’ex­ploi­ta­tion

Si vous souhaitez envoyer une entrée de rendez-vous, vous devez sé­lec­tion­ner le type de fichier du format iCalendar pour l’en­re­gis­trer et l’envoyer. Créer un fichier .ics est souvent le meilleur choix, car la structure ou le format ICS est com­pa­tible avec la plupart des systèmes d’ex­ploi­ta­tion. Lorsque la personne des­ti­na­taire ouvre le fichier, elle peut ensuite décider elle-même d’accepter ou non le rendez-vous reçu.

Quels sont les avantages de l’iCalendar ?

iCalendar n’est pas limité à l’échange de fichiers. Le format des entrées iCalendar est étroi­te­ment lié au standard des emails et suit l’extension Mul­ti­pur­pose Internet Mail (MIME), plus pré­ci­sé­ment le type « text/calendar ». Grâce à cette con­cep­tion ouverte, les entrées de ca­len­drier peuvent être utilisées presque partout et même intégrées dans des sites Web. Il est ainsi possible de partager des évé­ne­ments ou de publier des rendez-vous im­por­tants. Avec les serveurs WebDAV, utilisés pour fournir des fichiers sur Internet, les rendez-vous peuvent être syn­chro­ni­sés à tout moment.

Le format permet également d’échanger des rendez-vous di­rec­te­ment via Bluetooth ou via un réseau personnel entre appareils mobiles. Lors d’une réunion pro­fes­sion­nelle, il devient par exemple très simple de trans­mettre un nouveau rendez-vous à tous les par­ti­ci­pants. De plus, iCalendar permet d’utiliser les in­for­ma­tions en­re­gis­trées dans plusieurs ap­pli­ca­tions et de les syn­chro­ni­ser en temps réel grâce au format.

Le format iCalendar est accepté par les pro­grammes de ca­len­drier courants qui intègrent les données Web du ca­len­drier :

• Google Agenda
• Ca­len­drier Android
• Microsoft Outlook
• Ca­len­drier Black­Berry
• Ca­len­drier macOS/iOS

Que signifie la nor­ma­li­sa­tion par RFC 5545 ?

La RFC 5545 détermine comment les in­for­ma­tions de ca­len­drier doivent être struc­tu­rées et codées afin qu’elles puissent être lues et traitées cor­rec­te­ment par dif­fé­rentes ap­pli­ca­tions utilisant le format iCalendar. Cette nor­ma­li­sa­tion garantit ainsi une in­ter­pré­ta­tion cohérente du format ICS, quel que soit le logiciel ou le système.

L’élément central est la structure de données unifiée basée sur des com­po­sants de ca­len­drier appelés VEVENT, VTODO, VJOURNAL ou VTIMEZONE. Chacun de ces com­po­sants suit une structure clai­re­ment définie avec des champs obli­ga­toires et op­tion­nels, contenant des pro­prié­tés comme le début, la fin, le lieu ou la des­crip­tion d’un rendez-vous. Cette approche assure la cohérence de l’ensemble des fichiers créés au format iCalendar, qu’il s’agisse d’un simple fichier ICS ou d’un échange au­to­ma­tisé via Apple iCalendar.

En outre, la RFC 5545 règle également les pro­prié­tés suivantes :

• La syntaxe (format de texte UTF-8, longueur des lignes, sauts de ligne)
• Les formats de date et d’heure (y compris les in­di­ca­tions de fuseaux horaires)
• Le codage des évé­ne­ments ré­cur­rents, par exemple avec la propriété RRULE

Cela garantit qu’un fichier .ics créé une fois peut être in­ter­prété de la même manière, quel que soit le programme ou le système d’ex­ploi­ta­tion utilisé, et assure ainsi la com­pa­ti­bi­lité durable du format iCalendar.

Comment créer un fichier iCalendar ?

Créer un rendez-vous fonc­tionne comme suit :

1. Ouvrez un nouveau document dans un éditeur de texte de votre choix. Avec la bonne ap­pli­ca­tion, cela fonc­tionne aussi sur un smart­phone.
2. Rem­plis­sez ensuite le fichier selon la structure ha­bi­tuelle du format iCalendar, que nous ex­pli­quons plus en détail à l’étape suivante.
3. Après avoir cor­rec­te­ment complété le document, exportez-le au format iCal. Pour cela, en­re­gis­trez le fichier avec l’extension .ics.
4. Ouvrez un programme de ca­len­drier de votre choix et importez le fichier .ics en tant que rendez-vous. Un simple clic dans le menu cor­res­pon­dant suffit pour charger au­to­ma­ti­que­ment l’entrée.
5. Le rendez-vous apparaît alors comme une nouvelle entrée dans votre ca­len­drier.

Pour que le partage fonc­tionne cor­rec­te­ment et que la personne des­ti­na­taire puisse importer le rendez-vous dans son propre ca­len­drier, il est né­ces­saire de trans­mettre les in­for­ma­tions selon un format prédéfini. Chaque ligne cor­res­pond à un élément précis du format iCalendar :

Les in­di­ca­tions tem­po­relles suivent également un format stan­dar­disé :

• Les quatre premiers chiffres cor­res­pon­dent à l’année (AAAA) : 2019
• Les deux suivants indiquent le mois (MM) : 201910
• Les deux derniers dé­fi­nis­sent le jour (JJ) : 20191027
• La lettre T sépare la date de l’heure : 20191027T

L’heure est composée de 6 chiffres :

• Deux pour l’heure : 20191027T15
• Deux pour la minute : 20191027T1559
• Deux pour la seconde : 20191027T155954
• Un Z clôture l’entrée de la date : 20191027T155954Z

Dans l’exemple suivant, toutes les lignes sont cor­rec­te­ment remplies.

BEGIN:VCALENDAR
VERSION:2.0
PRODID:Cal_App//Daily@Planet
METHOD:PUBLISH
BEGIN:VEVENT
UID:123456789@example.com
LOCATION:Metropolis
SUMMARY:Meeting
DESCRIPTION:Kick-off Meeting
CLASS:PUBLIC
DTSTART:20191101T100000Z
DTEND:20191101T120000Z
DTSTAMP:20191027T155954Z
END:VEVENT
END:VCALENDAR

Chaque des­ti­na­taire du rendez-vous peut désormais, en ouvrant le fichier, ajouter l’événement à son ca­len­drier et ainsi recevoir toutes les in­for­ma­tions per­ti­nentes, de la nature du rendez-vous aux heures de début et de fin, tout au­to­ma­ti­que­ment. Le format iCalendar permet ainsi un gain de temps notable, surtout dans la vie pro­fes­sion­nelle.

Comment intégrer iCalendar dans le frontend ?

Au lieu de créer un fichier .ics, vous pouvez rediriger les uti­li­sa­teurs via des URL spéciales di­rec­te­ment vers un four­nis­seur de ca­len­drier en ligne tel que Google Agenda, Outlook.com ou Yahoo Agenda. Ces liens ouvrent une nouvelle fenêtre « Ajouter un événement » dans le na­vi­ga­teur du service concerné, déjà pré­rem­plie avec les in­for­ma­tions liées au titre, au lieu, à la des­crip­tion et aux horaires de début et de fin.

<a href="https://calendar.google.com/calendar/render?action=TEMPLATE
&amp;text=Release%20Meeting
&amp;details=Status-Update%20%26%20Milestones
&amp;location=Remote%20(Google%20Meet)
&amp;dates=20251010T080000Z/20251010T090000Z
&amp;ctz=Europe/Berlin"
target="_blank" rel="noopener">
Ajouter à Google Agenda
</a>

Comment générer des fichiers ICS par code ?

Vous trouverez ci-dessous des exemples de code pratiques montrant comment générer des fichiers .ics avec quelques lignes de code. Tous les exemples créent un rendez-vous « Réunion de lancement » le 15/10/2025, de 10:00 à 11:00 Europe/Paris, avec des fins de ligne correctes (CRLF) et un trai­te­ment approprié des ca­rac­tères spéciaux.

Exemple PHP

Dans l’exemple PHP suivant, la fonction uti­li­taire ics_escape() est d’abord définie. Cette fonction permet de masquer cor­rec­te­ment les ca­rac­tères spéciaux tels que les virgules, points-virgules, barres obliques inverses ou sauts de ligne. Ensuite, la structure du fichier .ics est définie dans un tableau. Chaque ligne re­pré­sente un attribut spé­ci­fique de l’entrée de ca­len­drier, comme le titre (SUMMARY), la des­crip­tion (DESCRIPTION) ou la période (DTSTART, DTEND). implode("\r\n", [...]) rassemble les lignes in­di­vi­duelles en un bloc de texte.

Ensuite, deux commandes header() suivent pour indiquer au na­vi­ga­teur comment le fichier doit être traité :

• Content-Type: text/calendar; charset=utf-8 indique qu’il s’agit d’un fichier de ca­len­drier au format iCalendar.
• Content-Disposition: attachment; filename="event.ics" indique au na­vi­ga­teur de ne pas afficher le fichier dans la fenêtre, mais de le té­lé­char­ger au­to­ma­ti­que­ment sous le nom spécifié.

Enfin, avec echo $ics, le texte final assemblé est affiché. Dès que le script PHP (par exemple event.php) est appelé dans le na­vi­ga­teur, le té­lé­char­ge­ment du fichier event.ics démarre et peut être im­mé­dia­te­ment importé dans Outlook, Google Calendar ou Apple Calendar.

function ics_escape($s) {
    return str_replace(
        ["\\",    ";",    ",",    "\n"],
        ["\\\\","\\;", "\\,", "\\n"],
        $s
    );
}
$ics = implode("\r\n", [
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-php//FR",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@example.com",
    "DTSTAMP:20251010T080000Z",
    "DTSTART;TZID=Europe/Paris:20251015T100000",
    "DTEND;TZID=Europe/Paris:20251015T110000",
    "SUMMARY:" . ics_escape("Réunion de lancement"),
    "DESCRIPTION:" . ics_escape("Mise à jour du statut et jalons"),
    "LOCATION:" . ics_escape("À distance (Google Meet)"),
    "END:VEVENT",
    "END:VCALENDAR",
    ""
]);
header('Content-Type: text/calendar; charset=utf-8');                // Indique au navigateur : il s’agit d’un fichier .ics
header('Content-Disposition: attachment; filename="event.ics"'); // Déclenche le téléchargement
echo $ics; // Envoie le contenu au navigateur

Exemple Python

Ici, la fonction ics_escape() permet également de s’assurer que les ca­rac­tères spéciaux comme les virgules, points-virgules ou sauts de ligne sont cor­rec­te­ment masqués. Avec datetime.now(timezone.utc), un ho­ro­da­tage actuel (DTSTAMP) au format UTC est créé au­to­ma­ti­que­ment. Les dif­fé­rentes lignes de l’événement, comme le titre (SUMMARY), sont ensuite combinées en un bloc de texte avec "\r\n".join([...]). Les sauts de ligne CRLF (\r\n) sont toujours obli­ga­toires dans le format ICS.

La commande Path("event-python.ics").write_text(ics, encoding="utf-8", newline="") écrit ensuite le contenu en tant que fichier UTF-8 dans le ré­per­toire actuel. Après l’exécution du script, le fichier final event-python.ics est prêt et peut être im­mé­dia­te­ment importé dans Outlook, Google Calendar ou Apple Calendar.

from datetime import datetime, timezone
from pathlib import Path
def ics_escape(s: str) -> str:
    return s.replace("\\", "\\\\").replace(";", "\\;").replace(",", "\\,").replace("\n", "\\n")
ics = "\r\n".join([
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-python//FR",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@example.com",
    f"DTSTAMP:{datetime.now(timezone.utc):%Y%m%dT%H%M%SZ}",
    "DTSTART;TZID=Europe/Paris:20251015T100000",
    "DTEND;TZID=Europe/Paris:20251015T110000",
    f"SUMMARY:{ics_escape('Réunion de lancement')}",
    f"DESCRIPTION:{ics_escape('Mise à jour du statut et jalons')}",
    f"LOCATION:{ics_escape('À distance (Google Meet)')}",
    "END:VEVENT",
    "END:VCALENDAR",
    ""
])
Path("event-python.ics").write_text(ics, encoding="utf-8", newline="")
print("écrit : event-python.ics")

Exemple Ja­vaS­cript

Le code Ja­vaS­cript suivant génère le contenu du ca­len­drier di­rec­te­ment dans le na­vi­ga­teur. Dans un premier temps, le texte iCalendar est assemblé dans la variable ics. La fonction icsEscape() garantit de nouveau que les ca­rac­tères spéciaux comme les virgules ou les sauts de ligne sont cor­rec­te­ment masqués. Avec Blob(), un fichier virtuel est créé en mémoire à partir de ce texte. URL.createObjectURL() génère ensuite une URL de té­lé­char­ge­ment tem­po­raire que le na­vi­ga­teur traite comme un véritable fichier.

Un élément <a> invisible avec l’attribut download est généré dy­na­mi­que­ment, puis déclenché au­to­ma­ti­que­ment par a.click(). Cela lance le té­lé­char­ge­ment du fichier event-browser.ics, sans qu’aucune connexion au serveur ne soit né­ces­saire.

<button id="dl">Télécharger .ics</button>
<script>
function icsEscape(s){
    return s
        .replace(/\\/g,"\\\\")
        .replace(/;/g,"\\;")
        .replace(/,/g,"\\,")
        .replace(/\n/g,"\\n");
}
const ics = [
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-browser//FR",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@example.com",
    "DTSTAMP:20251010T080000Z",
    "DTSTART;TZID=Europe/Paris:20251015T100000",
    "DTEND;TZID=Europe/Paris:20251015T110000",
    "SUMMARY:" + icsEscape("Réunion de lancement"),
    "DESCRIPTION:" + icsEscape("Mise à jour du statut et jalons"),
    "LOCATION:" + icsEscape("À distance (Google Meet)"),
    "END:VEVENT",
    "END:VCALENDAR",
    ""
].join("\r\n");
document.getElementById("dl").addEventListener("click", () => {
    const blob = new Blob([ics], { type: "text/calendar;charset=utf-8" }); 
    const url = URL.createObjectURL(blob);
    const a = document.createElement("a");
    a.href = url;
    a.download = "event-browser.ics";
    document.body.appendChild(a);
    a.click();
    a.remove();
    URL.revokeObjectURL(url);
});
</script>

Exemple Node.js

Ce code lance un petit serveur Web Express qui fournit un fichier .ics di­rec­te­ment via le na­vi­ga­teur. Lorsqu’une personne accède à http://localhost:3000/event.ics, le texte iCalendar est généré dans le ges­tion­naire app.get(...) et envoyé au client. La fonction icsEscape() garantit, comme dans les autres exemples, que les ca­rac­tères spéciaux sont cor­rec­te­ment masqués. Avec res.setHeader("Content-Type", "text/calendar; charset=utf-8"), le serveur indique au na­vi­ga­teur qu’il s’agit d’un fichier de ca­len­drier. L’en-tête Cache-Control: public, max-age=300 permet aux clients de mettre le fichier en cache pendant 5 minutes.

res.send(ics) envoie ensuite le fichier final di­rec­te­ment au na­vi­ga­teur, qui le té­lé­charge au­to­ma­ti­que­ment ou l’ouvre avec l’ap­pli­ca­tion de ca­len­drier. Le serveur fonc­tionne ensuite lo­ca­le­ment sous http://localhost:3000/event.ics.

import express from "express";
const app = express();
function icsEscape(s){
    return s
        .replace(/\\/g,"\\\\")
        .replace(/;/g,"\\;")
        .replace(/,/g,"\\,")
        .replace(/\n/g,"\\n");
}
app.get("/event.ics", (req, res) => {
    const ics = [
        "BEGIN:VCALENDAR",
        "PRODID:-//example.com//ics-node//FR",
        "VERSION:2.0",
        "CALSCALE:GREGORIAN",
        "METHOD:PUBLISH",
        "BEGIN:VEVENT",
        "UID:event-123@example.com",
        "DTSTAMP:20251010T080000Z",
        "DTSTART;TZID=Europe/Paris:20251015T100000",
        "DTEND;TZID=Europe/Paris:20251015T110000",
        "SUMMARY:" + icsEscape("Réunion de lancement"),
        "DESCRIPTION:" + icsEscape("Mise à jour du statut et jalons"),
        "LOCATION:" + icsEscape("À distance (Google Meet)"),
        "END:VEVENT",
        "END:VCALENDAR",
        ""
    ].join("\r\n");
    res.setHeader("Content-Type", "text/calendar; charset=utf-8"); // Le navigateur reconnaît le type MIME
    res.setHeader("Cache-Control", "public, max-age=300");                    // Mise en cache (5 minutes)
    res.send(ics); // Envoi de la réponse
});
app.listen(3000, () => console.log("http://localhost/event.ics"));

Les fichiers ICS dans dif­fé­rents clients de ca­len­drier

Bien que l’iCalendar soit une norme ouverte, chaque ap­pli­ca­tion de ca­len­drier in­ter­prète les fichiers .ics à sa manière. Selon l’en­vi­ron­ne­ment, il existe des dif­fé­rences dans la façon dont les évé­ne­ments sont importés, syn­chro­ni­sés et mis à jour.

Google Agenda

Dans Google Agenda, les uti­li­sa­teurs peuvent soit importer ma­nuel­le­ment des fichiers .ics, soit s’abonner à un flux de ca­len­drier via une URL.

Lors de l’im­por­ta­tion, les évé­ne­ments contenus sont intégrés une seule fois dans le ca­len­drier choisi. Les mo­di­fi­ca­tions ul­té­rieures apportées au fichier sur votre serveur ne sont pas prises en compte au­to­ma­ti­que­ment. Google traite donc cette option comme un ins­tan­tané.

La sous­crip­tion par URL fonc­tionne dif­fé­rem­ment et n’est dis­po­nible que dans la version Web de Google Agenda. On sé­lec­tionne « Autres ca­len­driers » > « Ajouter par URL » et l’on saisit l’adresse d’un fichier .ics, comme https://example.com/calendar.ics. Google récupère ensuite ce fichier ré­gu­liè­re­ment, gé­né­ra­le­ment toutes les 12 à 24 heures, et met à jour au­to­ma­ti­que­ment les évé­ne­ments en cas de mo­di­fi­ca­tion. Il est important de noter que Google n’accepte pas les liens webcal://. Si vous souhaitez proposer un lien d’abon­ne­ment sur votre site, vous devriez donc utiliser une URL en HTTPS.

Apple Ca­len­drier

Apple Ca­len­drier prend très bien en charge le format iCalendar (.ics). Lorsque les uti­li­sa­teurs té­lé­char­gent ou ouvrent un fichier ICS par email, le système le reconnaît au­to­ma­ti­que­ment et demande dans quel ca­len­drier les évé­ne­ments doivent être importés. Comme pour Google Agenda, il s’agit d’un import unique, sans mise à jour au­to­ma­tique.

En revanche, la fonction d’abon­ne­ment est nettement plus per­for­mante, car Apple prend en charge le schéma webcal:// de manière native. Si vous proposez un lien de type webcal://example.com/calendar.ics, un clic ouvre au­to­ma­ti­que­ment le dialogue per­met­tant de s’abonner. Le ca­len­drier abonné est ensuite syn­chro­nisé au­to­ma­ti­que­ment, par défaut toutes les quelques heures. Les mo­di­fi­ca­tions des évé­ne­ments existants (même UID, nouveau DTSTAMP) sont prises en compte, tandis que les évé­ne­ments supprimés dis­pa­rais­sent lors de la prochaine syn­chro­ni­sa­tion.

Outlook

Microsoft Outlook peut lui aussi importer une fois ou s’abonner à un fichier .ics. Lorsqu’un fichier est ouvert ou importé ma­nuel­le­ment, Outlook ajoute sim­ple­ment les évé­ne­ments au ca­len­drier choisi. Ces évé­ne­ments restent statiques, sans mise à jour ul­té­rieure.

Lors d’un abon­ne­ment, Outlook fonc­tionne de manière similaire à Apple Ca­len­drier. Les uti­li­sa­teurs peuvent saisir l’URL du flux sous « Ouvrir le ca­len­drier » > « À partir d’Internet » (par exemple https://example.com/calendar.ics ou webcal://...). Outlook s’abonne alors au ca­len­drier et le syn­chro­nise au­to­ma­ti­que­ment à in­ter­valles réguliers, gé­né­ra­le­ment entre 30 minutes et 3 heures.

Outlook.com, la version Web, fonc­tionne de manière com­pa­rable, mais peut être plus lent au niveau des mises à jour que l’ap­pli­ca­tion de bureau.