O que é um arquivo ICS?

ICS é um formato de texto puro que abre em qualquer editor. Ele é usado para mover dados entre programas.

A extensão é .ics e o nome por extenso é iCalendar. Os dois importam menos do que aquilo que o arquivo consegue carregar, e é disso que trata o resto desta página.

Ele remonta a 1998. A especificação é RFC 5545.

A um formato que se manteve legível por tanto tempo dá para confiar algo que você quer de volta daqui a dez anos.

Ela está publicada por inteiro, então dá para implementá-la a partir do documento em vez de por observação — é por isso que o formato aparece em tantos programas e por isso que arquivos escritos há vinte anos ainda abrem. Especificação publicada não é o mesmo que livre de royalties: quando o formato embrulha um codec, o licenciamento das patentes é uma questão à parte, que a norma não resolve.

ICS guarda o conteúdo exatamente. Salvar de novo não muda nada, então dá para abrir, editar e salvar quantas vezes você quiser sem acumular estrago — e é isso que faz dele um formato de trabalho e não de entrega.

Google Calendar, Apple Calendar e Microsoft Outlook leem esse formato, e a maioria dos programas do mesmo tipo também.

Quando um arquivo não abre, o formato raramente é o problema — mais comum é o programa ser mais antigo que ele. Converter para algo mais antigo é o caminho confiável, e é para isso que serve o resto deste site.

Nenhum navegador lê o formato.

Esse é de longe o motivo mais comum para convertê-lo: não que o formato seja ruim, mas que o lugar onde você quer mostrar o arquivo não consegue lê-lo.

ICS foi feito para ser aberto e alterado. Mantenha o arquivo nesse formato enquanto o trabalho estiver em andamento e exporte a partir dele sempre que precisar de uma cópia pronta.

Um arquivo ICS é um evento que te enviaram ou um calendário ao qual você se inscreve, e quase todo problema com o formato começa confundindo os dois.

O primeiro é o convite anexado a um e-mail: descreve um compromisso ou uma pequena série, feito para ser aberto uma vez e importado. O segundo é um feed num endereço web que um aplicativo de calendário busca repetidamente. É a mesma estrutura de arquivo nos dois casos, e a diferença de uso é total.

Texto simples, numa estrutura antiga o suficiente para parecer: uma propriedade por linha, tudo maiúsculo, quebrado a cada 75 caracteres com uma convenção de continuação que coloca um único espaço no início da linha seguinte.

O identificador único é a parte que se comporta de um jeito que as pessoas não esperam. É como um calendário reconhece uma atualização como pertencente a um compromisso existente em vez de um novo — reenviar um convite com o mesmo identificador move o original em vez de criar um duplicado.

Um evento pode registrar seu horário de três formas, e elas se comportam de modo diferente. Um horário local sem fuso significa "dez horas onde quer que você esteja", certo para um aniversário e errado para uma reunião.

Um compromisso que fica uma hora errado para alguns participantes e não para outros costuma ser exatamente isso: um evento escrito como horário local por um sistema que presumiu que todos estavam num país só.

A repetição é descrita por uma regra em vez de escrever cada ocorrência: toda segunda terça-feira, a última sexta do mês. É compacto e exato, e é o motivo de um ano de reuniões semanais serem poucas centenas de bytes.

O que torna isso complicado são exceções. Uma ocorrência cancelada e uma única reunião movida para outro dia são guardadas como emendas à série, e aplicativos diferem em quão completamente implementam isso.

Para um arquivo único, os três fazem a mesma coisa: uma importação que copia os eventos de uma vez. No Google Calendar fica em Configurações, Importar e exportar; no Outlook é Arquivo, Abrir e Exportar; no Mac é Arquivo, Importar.

Para um feed, use a opção de assinatura em vez disso, e forneça o endereço em vez de um arquivo baixado. O calendário então busca de novo na própria programação, o que o Google e o Outlook medem em horas.

Qualquer sistema que faz reservas — uma plataforma de venda de ingressos, um formulário de agendamento — em algum momento precisa anexar um ICS para o cliente colocar no calendário. Três detalhes separam um que funciona de um que gera chamados de suporte.

Use um fuso horário nomeado em vez de um horário local puro, ou um instante em UTC se o evento tem um momento fixo único. Mantenha o identificador único estável entre a confirmação, o lembrete e o aviso de mudança.

É texto, então qualquer editor abre, e para um evento único essa costuma ser a forma mais rápida de ver o que de fato está sendo dito ao calendário. A convenção de quebra de linha é a única coisa a respeitar.

Editar é razoável para um ajuste rápido — uma data errada, um erro de digitação no título. Para qualquer coisa estrutural, e especialmente para regras de recorrência, deixe um aplicativo de calendário escrever.