Como criar um ficheiro ICS (4 formas, com um exemplo que funciona)

O que é um ficheiro ICS

Um ficheiro ICS é um ficheiro de texto simples no formato iCalendar, definido na RFC 5545. Começa com BEGIN:VCALENDAR, termina com END:VCALENDAR e contém um ou mais eventos, cada um entre BEGIN:VEVENT e END:VEVENT. Cada evento tem linhas como SUMMARY para o título, DTSTART e DTEND para as horas e LOCATION para o local. Como o formato é uma norma aberta e não pertence a nenhuma empresa, todas as grandes apps de calendário o conseguem ler. Ao importar um ficheiro, os eventos são copiados uma vez para o seu calendário; não ficam ligados à origem. Para ver o ficheiro linha a linha, incluindo a forma como os fusos horários são escritos, consulte O que é um ficheiro ICS?.

Forma 2: criar um ICS a partir de uma foto, captura de ecrã ou horário em papel

A maioria dos eventos não começa num calendário. Chega num folheto preso no frigorífico, numa captura de ecrã de um grupo de conversa ou num horário impresso. O Photo2Calendar lê a imagem, transforma o que encontra em rascunhos de eventos e deixa-o rever cada campo antes de guardar ou exportar um ficheiro .ics.

1. 1

   Tire uma foto ou captura de ecrã

   Fotografe o folheto, o convite ou o horário em papel, ou faça uma captura de ecrã do e-mail, da conversa ou da página web. Mantenha a data, a hora e o local dentro da imagem.

2. 2

   Abra-a no Photo2Calendar

   A app lê o texto visível e prepara um rascunho para cada evento que encontra, com título, data, hora de início e de fim e local.

3. 3

   Reveja cada campo

   Compare cada rascunho com a imagem. Verifique o ano, se a origem não o indicar, o início e o fim em intervalos como «10h–13h» e o fuso horário, se o evento decorrer noutro sítio.

4. 4

   Exporte o ficheiro .ics

   Exporte o evento revisto como ficheiro .ics e abra-o no Google Calendar, no Outlook ou noutra app de calendário. Também pode guardá-lo diretamente no calendário do iPhone.

Exemplo: um folheto sem ano

Um folheto fictício, aqui escrito em vez de uma captura de ecrã.

Há duas coisas que precisam sempre de um olhar humano: o ano, quando a origem o omite, e o fuso horário, quando o evento decorre noutro sítio que não aquele onde está. A página Converter imagem em ICS explica os tipos de imagem suportados, e a página Captura de ecrã para o calendário mostra como funciona com capturas de ecrã no iPhone.

Forma 4: escrever à mão ou em código

Um ficheiro .ics é texto, por isso pode escrevê-lo em qualquer editor de texto simples e guardá-lo com a extensão .ics. Este é um ficheiro mínimo, que funciona, para um evento:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Example//Hand-written ICS//EN
BEGIN:VEVENT
UID:2027-03-12-team-dinner@example.com
DTSTAMP:20261015T120000Z
DTSTART:20270313T000000Z
DTEND:20270313T020000Z
SUMMARY:Jantar de equipa
LOCATION:Main Street Bistro
END:VEVENT
END:VCALENDAR

• VERSION e PRODID são obrigatórios no cabeçalho do calendário. PRODID identifica o programa que criou o ficheiro.
• UID identifica o evento. Mantenha-o único e estável: se enviar uma atualização com o mesmo UID, as apps de calendário podem tratá-la como o mesmo evento.
• DTSTAMP é o momento em que o ficheiro foi criado, em UTC.
• DTSTART e DTEND são o início e o fim. Para um evento de dia inteiro, use DTSTART;VALUE=DATE:20270417 e o dia seguinte como DTEND.

Uma nota sobre fusos horários

O Z no fim de uma hora significa UTC. O exemplo é um jantar às 19:00 de sexta-feira, 12 de março de 2027, em Nova Iorque, o que corresponde às 00:00 UTC de 13 de março. É por isso que a data no ficheiro diz dia 13. Uma hora sem Z, como DTSTART:20270312T190000, é «flutuante»: aparece como 19:00 no fuso horário em que o calendário estiver. Para fixar um evento num fuso específico, use DTSTART;TZID=America/New_York:20270312T190000; a norma espera então um bloco VTIMEZONE correspondente, que as exportações de calendário acrescentam por si. Ao escrever à mão, UTC com Z é a opção mais segura.

Em rigor, as linhas devem terminar com CRLF e as linhas longas devem ser quebradas aos 75 bytes; a maioria das apps de calendário tolera pequenos deslizes, mas verifique o ficheiro no validador iCalendar antes de o partilhar. A ajuda da Google mostra o cabeçalho e o rodapé que espera. Em código, use uma biblioteca para a sua linguagem em vez de montar as linhas à mão; ela trata do escape das vírgulas e da quebra de linhas.

Perguntas frequentes

Outras perguntas sobre a app têm resposta nas perguntas frequentes sobre o Photo2Calendar.

Fontes: Apple, importar ou exportar calendários no Mac; Google, exportar eventos do Google Calendar; Microsoft, exportar um calendário do Outlook para o Google Calendar; RFC 5545. Verificado a 15 de outubro de 2026.