Adicionar ao calendário (arquivo .ics)

Um arquivo .ics não é um calendário: é o envelope

Quando alguém manda uma data para você dentro de uma mensagem, essa data não vai para lugar nenhum: fica ali parada, e quem recebe precisa copiá-la à mão. O arquivo .ics é o formato que todo calendário entende, desde 1998: você o anexa a um e-mail, joga num chat, coloca num site, e quem o abre encontra o evento já dentro do seu próprio calendário, com o local, as observações e o lembrete. Funciona no iPhone, no Android, no Outlook, no Google Agenda e no Thunderbird, porque nenhum deles tem um formato próprio que os outros não consigam ler.

Aqui o arquivo é escrito dentro do seu navegador e não vai a lugar nenhum: a página não tem servidor para onde enviá-lo, então o seu endereço, o nome do cliente ou a hora da consulta não passam por ninguém. Se você precisa do caminho contrário, ver um arquivo que o seu celular já conhece sem importá-lo por engano para os seus contatos, a ferramenta certa é Abrir agenda .vcf.

O erro que faz um evento de um dia ocupar dois

É a armadilha mais famosa deste formato, e só aparece depois, no celular de quem recebe. Em um evento de dia inteiro a data final é exclusiva: não é o último dia do evento, é o dia seguinte. Um evento no dia 4 de setembro se escreve «começa no dia 4, termina no dia 5», e quem escreve «começa no dia 4, termina no dia 4» acaba, conforme o programa, com um evento de dois dias ou com um evento que nem aparece.

Aqui a página faz essa conta por você: você escreve o primeiro e o último dia como diria em voz alta, e o dia seguinte é o que vai para o arquivo. É também uma das coisas que o teste confere, lendo o arquivo pronto com programas escritos por outras pessoas, porque numa regra assim um deslize não aparece na tela: aparece três semanas depois, quando alguém chega no dia errado.

Por que o fuso horário é escrito por extenso dentro do arquivo

«Às três» não quer dizer nada se quem lê está em Londres ou em Nova York. Um arquivo bem feito não escreve só a hora: escreve também a que fuso essa hora pertence e como funciona o horário de verão nesse fuso, com as datas exatas das duas mudanças. Um arquivo que cita o fuso sem explicá-lo é o defeito típico: cada programa se vira do seu jeito, e o compromisso cai uma hora depois para metade dos convidados.

As regras não vêm de uma tabela escrita aqui dentro, que ficaria velha: elas são pedidas ao navegador, que traz o banco de dados de fusos horários atualizado junto com o sistema. Há um caso que vale a pena conhecer, o das duas noites em que os relógios mudam: duas e meia da madrugada na noite da mudança de primavera não existe, e duas e meia da madrugada na noite de outono acontece duas vezes. Se você escolher uma hora assim, a página avisa em vez de escrever uma data que cada um vai ler do seu jeito.

Vinte prazos de uma planilha, e o que não se faz aqui

A segunda aba no alto é a que compensa: você cola as linhas de uma planilha, uma por evento, e sai um único arquivo com todos os eventos dentro. O formato é data, hora, título, local, e a hora pode ficar de fora: uma linha sem hora vira um evento de dia inteiro, que é exatamente o que um prazo pede. Ao copiar do Excel, as colunas vêm separadas por tabulações e são reconhecidas automaticamente; as linhas que não dá para entender não somem em silêncio, são listadas.

O que não se faz aqui são três coisas, e cada uma tem a sua página. Nenhuma data é calculada: se você precisa saber em que dia cai um prazo de noventa dias, existe a ferramenta Somar dias a uma data, se quer ver um mês inteiro, o Calendário mensal, e se o que você quer é a contagem regressiva para o grande dia, a Contagem regressiva para evento. Datas escritas em texto corrido, como «quinta que vem às três», não são lidas, porque errar ao adivinhar é pior do que não tentar. E convites com lista de convidados não são enviados: este é um arquivo que você abre, não uma convocação. Se você trabalha em turnos e as suas datas já estão numa tabela, o melhor é começar pelo Calendário de turnos.