Conversor online gratuito de ICS para CSV

Planilhas, bancos de dados e sistemas de geração de relatórios geralmente exigem CSV quando um aplicativo de calendário fornece apenas uma exportação ICS. A conversão do arquivo cria uma linha por evento para filtragem, edição, arquivamento ou importação em software que não oferece suporte a iCalendar.

O que é o formato ICS

ICS é a extensão de arquivo comum do iCalendar, um formato de calendário estruturado em texto simples definido pela RFC 5545. Microsoft Outlook, Apple Calendar, Google Calendar, Mozilla Thunderbird e sistemas de agendamento podem criá-lo ou importá-lo.

Os arquivos ICS geralmente contêm registros VEVENT com assuntos, horários de início e término, locais, descrições, participantes, organizadores, alarmes, fusos horários, regras de recorrência e identificadores exclusivos. Eles também podem conter tarefas VTODO ou entradas VJOURNAL. A maioria das exportações de calendários contém principalmente eventos.

O que é o formato CSV

CSV é uma tabela de texto delimitada: cada linha representa um registro e cada coluna representa um campo. Microsoft Excel, LibreOffice Calc, Google Sheets, ferramentas de banco de dados e software de análise de dados podem abrir arquivos CSV.

O CSV facilita a classificação, a filtragem, a remoção de duplicatas, a edição em lote e o uso dos dados de eventos em relatórios. Ele não preserva o modelo de dados completo do iCalendar. As colunas comuns incluem Subject, Start, End, Location, Description, UID, RRULE e TimeZone.

Como converter um arquivo ICS para CSV

Para uma conversão única sem instalar software, carregue o arquivo .ics no conversor gratuito do 101convert.com e baixe o arquivo .csv resultante. Abra o resultado em uma planilha e verifique as datas, os horários, as descrições e os delimitadores antes de importá-lo para outro local.

Para conversões privadas, repetíveis ou personalizadas, Python e o pacote icalendar oferecem controle sobre os campos de saída:

1. Instale Python e o pacote de análise:

python -m pip install icalendar

2. Salve este script como ics_to_csv.py:

import csv
import sys
from datetime import date, datetime
from icalendar import Calendar


def text(component, name):
    item = component.get(name)
    if item is None:
        return ""
    value = item.dt if hasattr(item, "dt") else item
    if isinstance(value, (datetime, date)):
        return value.isoformat()
    return str(value).replace("\r", " ").replace("\n", " ")


def timezone(component, name):
    item = component.get(name)
    return str(item.params.get("TZID", "")) if item is not None else ""


with open(sys.argv[1], "rb") as source:
    calendar = Calendar.from_ical(source.read())

fields = [
    "Subject", "Start", "End", "Location", "Description",
    "UID", "RRULE", "TimeZone"
]

with open(sys.argv[2], "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(target, fieldnames=fields)
    writer.writeheader()
    for event in calendar.walk("VEVENT"):
        writer.writerow({
            "Subject": text(event, "SUMMARY"),
            "Start": text(event, "DTSTART"),
            "End": text(event, "DTEND"),
            "Location": text(event, "LOCATION"),
            "Description": text(event, "DESCRIPTION"),
            "UID": text(event, "UID"),
            "RRULE": text(event, "RRULE"),
            "TimeZone": timezone(event, "DTSTART"),
        })

3. Execute o script com os nomes dos arquivos de entrada e saída:

python ics_to_csv.py calendar.ics calendar.csv

Abra calendar.csv no LibreOffice Calc usando File → Open. Se solicitado, selecione a codificação UTF-8 e a separação por vírgulas. O Excel pode usar o separador de lista do sistema operacional em vez de uma vírgula; portanto, selecione o delimitador manualmente quando as colunas aparecerem em um único campo.

Limitações de qualidade e compatibilidade

• Eventos recorrentes: O script exporta a regra de recorrência, mas não a expande em ocorrências separadas. Use as opções de exportação de um aplicativo de calendário ou um código com suporte a recorrência quando cada ocorrência precisar se tornar sua própria linha.
• Fusos horários: O ICS oferece suporte a UTC, fusos horários nomeados e horários locais flutuantes. O CSV não tem um tipo padrão de fuso horário; mantenha o deslocamento UTC e, quando disponível, uma coluna TimeZone separada.
• Eventos de dia inteiro: Normalmente, eles usam datas em vez de carimbos de data e hora. Uma data de término do iCalendar geralmente é exclusiva; portanto, não a trate automaticamente como um dia adicional do calendário.
• Vários valores e registros relacionados: Participantes, categorias, alarmes, exceções de recorrência e outras propriedades podem ser simplificados ou omitidos por uma exportação simples em tabela. Adicione colunas dedicadas ou preserve o ICS original junto ao CSV.
• Perda de dados: O CSV não pode manter comportamentos de calendário, como alarmes, convites, lógica de recorrência e relações entre exceções. Mantenha o ICS original como a cópia de calendário oficial.
• Privacidade: Descrições, endereços dos participantes, informações do organizador e URLs de reuniões podem aparecer no CSV. Remova as colunas confidenciais antes de compartilhá-lo.