Convertir ICS en CSV

Le format iCalendar (RFC 5545) décrit un calendrier complet, avec des événements (VEVENT), des tâches (VTODO), des entrées de journal (VJOURNAL), des alarmes (VALARM), des fuseaux horaires (VTIMEZONE), des règles de récurrence (RRULE) et des exceptions (EXDATE, RDATE), sans parler des propriétés `X-` propres à chaque logiciel. Notre convertisseur ne lit que les VEVENT et ignore tout le reste. Le CSV produit a une ligne par événement, sans aucun des autres composants.

Pour un calendrier Google ou Apple exporté depuis l’interface, cela couvre l’essentiel des cas. Pour un agenda d’équipe qui utilise VTODO pour les tâches, ou un calendrier qui porte des alarmes, ces informations sont perdues sans avertissement. Le CSV est un export partiel, et c’est explicite dans le code source : la conversion privilégie la simplicité de la table de sortie, pas la fidélité au format source.

L’ICS représente un événement récurrent par un VEVENT avec une règle RRULE, et toutes les occurrences ne sont pas stockées individuellement. Notre convertisseur ne déplie pas les récurrences : un hebdomadaire « tous les lundis à 14h00 pendant 12 semaines » devient exactement une ligne dans le CSV, et les 12 occurrences n’y sont pas. Le destinataire qui ouvre le CSV dans Excel voit un seul rendez-vous, pas douze.

C’est la limite la plus visible de cette conversion, et c’est explicite dans le code source. Pour déplier les occurrences, il faut un outil qui interprète RRULE, RDATE et EXDATE, et c’est un travail de calcul de calendrier qui sort du cadre d’un convertisseur de fichier. Si le calendrier exporté a beaucoup de récurrences, et si le CSV doit contenir toutes les dates, le bon outil est un tableur avec un add-in de calendrier, pas un convertisseur de format.

Un VEVENT peut préciser un fuseau horaire (TZID), et ce fuseau est utilisé pour interpréter l’heure de début. Notre convertisseur écrit l’heure telle qu’elle est stockée dans le fichier ICS, sans la convertir. Si l’événement est à 14h00 Europe/Paris et que vous lisez le CSV depuis un fuseau différent, l’heure affichée est 14h00, pas 17h00 ou 08h00 selon votre localisation.

Le TZID lui-même est ignoré, ce qui veut dire que la colonne « heure de début » montre une heure nue, sans indication de fuseau. Pour un calendrier local d’une équipe dans un seul fuseau, c’est sans problème. Pour un calendrier international ou un vol, c’est ambigu, et il faut interpréter l’heure manuellement. La conversion n’invente pas un fuseau, parce que deviner UTC déplacerait tous les rendez-vous d’une ou deux heures, et un rendez-vous mal interprété est pire qu’un rendez-vous clairement noté en heure locale.

Le CSV produit a exactement neuf colonnes : titre, début, fin, lieu, description, organisateur, statut, classé, et UID. Tout ce qui n’est pas dans cette liste n’est pas dans le CSV. Les catégories, les pièces jointes, les coordonnées GPS, les URL associées, les participants, les commentaires, les codes d’accès : tout est laissé de côté. C’est explicite dans le code source, et c’est la conséquence directe de l’objectif « table simple ».

Pour un export vers un tableur, neuf colonnes est un bon compromis. Pour un export qui doit préserver tous les détails d’un calendrier, c’est insuffisant. Si le calendrier contient beaucoup de participants, beaucoup de pièces jointes, ou des champs personnalisés, le CSV est une perte nette. Le bon outil est un export vers un autre format ICS (par exemple, d’un fournisseur à un autre), pas vers un CSV.

L’ICS peut porter une description multi-ligne en utilisant le mécanisme de line folding : une ligne trop longue est coupée par un retour chariot et un espace blanc, et le lecteur doit la reconstituer. Notre convertisseur implémente le dépliage, et c’est explicite dans le code source. Sans dépliage, chaque ligne longue serait silencieusement tronquée, et les adresses, les notes, les biographies d’événement seraient coupées à 75 octets.

C’est un détail de spécification, mais c’est un point où beaucoup d’exportateurs se trompent. Le test passe sur l’ICS issu de Google Calendar, Apple Calendar et Microsoft Outlook, parce que tous trois utilisent le line folding pour leurs descriptions. Le CSV produit a les descriptions complètes, ce qui est le minimum que l’on puisse attendre d’une conversion de calendrier.

Le séparateur est la virgule, l’échappement des guillemets est standard CSV, l’encodage est UTF-8 sans BOM. Excel et LibreOffice ouvrent le fichier directement. Les colonnes de date sont au format ISO 8601 (par exemple « 2026-08-15 » pour la date seule, et « 2026-08-15T14h00Z » pour la date et l’heure), ce qui est lisible par un humain et trié par un tableur. Les colonnes de texte peuvent contenir des virgules et des sauts de ligne, qui sont échappés par des guillemets.

Pour un usage dans un script Python ou R, le fichier s’analyse avec n’importe quel parseur CSV standard. Pour un usage dans Excel qui doit comprendre la colonne début comme une date, il faut la formater après ouverture. Le CSV est un fichier texte simple, sans fioritures, et c’est explicite dans le code source.

Le calendrier source peut contenir des participants (ATTENDEE), avec leur statut de réponse, et cette information n’est pas dans le CSV. Pour un événement d’équipe où la question est « qui a confirmé », le CSV ne répond pas. Le calendrier source peut contenir des pièces jointes, et ces pièces jointes ne sont pas exportées. Pour un événement de type « ordre du jour avec PDF », le PDF est perdu.

Le calendrier source peut contenir des catégories, des couleurs, des icônes, et ces éléments ne sont pas dans le CSV. Pour un calendrier d’équipe qui distingue « projet A » et « projet B » par couleur, le CSV ne distingue rien. Le calendrier source peut contenir des alarmes, et ces alarmes sont perdues. C’est explicite dans la liste des champs non exportés, et c’est la conséquence directe du choix de neuf colonnes.

L’ICS source n’est pas uploadé, le CSV produit n’est jamais transmis. La conversion se fait dans l’onglet, en mémoire, par un module JavaScript natif sans dépendance réseau. C’est important pour un calendrier d’équipe qui peut contenir des informations confidentielles : titres de réunions, noms de clients, dates de rendez-vous médicaux, tout reste sur l’appareil.

Les fichiers jusqu’à 100 Mo sont pris en charge, ce qui est très large pour un calendrier d’une vie entière, et l’ensemble du calcul est client pour cette paire. C’est la seule forme sous laquelle la phrase « privé » signifie quelque chose : aucune requête vers l’extérieur pendant que la conversion tourne, et l’assertion se vérifie dans l’onglet réseau des outils de développement.