O que é um ficheiro ICS?
Um ficheiro .ics é um ficheiro de calendário em texto simples, no formato iCalendar. Contém um ou mais eventos, com horas, locais e regras de repetição, para que o Calendário da Apple, o Google Calendar, o Outlook e qualquer outra app de calendário consigam ler o mesmo ficheiro.
Publicado a · Atualizado a · Equipa editorial do Photo2Calendar
O que é um ficheiro ICS
ICS vem de «iCalendar», a norma que define como se escrevem os dados de calendário. A norma está publicada como RFC 5545, os ficheiros terminam em .ics e o tipo MIME é text/calendar. Como o formato é uma norma pública, um ficheiro exportado de um calendário pode ser importado em qualquer outro.
Por dentro, um ficheiro .ics é texto comum: uma propriedade por linha, escrita como NOME:VALOR. Pode abri-lo em qualquer editor de texto e lê-lo. Isso facilita a verificação quando uma importação corre mal e permite escrevê-lo à mão ou por código quando precisa de um ficheiro sem usar uma app de calendário.
Um ficheiro pode descrever um único evento (um concerto, um voo), um calendário inteiro (todos os eventos do ano letivo) ou uma série que se repete (treino todas as terças-feiras). Também pode conter tarefas, informação de disponibilidade e entradas de diário, mas quase todos os .ics que encontra no dia a dia contêm eventos.
O que contém
Um ficheiro completo com um evento, usando o concerto escolar do nosso guia para extrair eventos de imagens (em inglês):
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Example//Winter Concert//EN
BEGIN:VEVENT
UID:winter-concert-2026@example.com
DTSTAMP:20261016T090000Z
DTSTART;TZID=America/New_York:20261210T173000
DTEND;TZID=America/New_York:20261210T193000
SUMMARY:Winter Concert – Grades 3 to 5
LOCATION:Maple Street Elementary, Main Hall
DESCRIPTION:Doors 5:30 pm\nBring a canned food donation.
BEGIN:VALARM
TRIGGER:-PT60M
ACTION:DISPLAY
DESCRIPTION:Winter Concert in one hour
END:VALARM
END:VEVENT
END:VCALENDAROs blocos começam com BEGIN e terminam com END. O bloco exterior VCALENDAR contém as linhas do ficheiro; cada VEVENT contém um evento. Estas são as linhas que vai ver com mais frequência:
| Linha | O que significa |
|---|---|
| BEGIN:VCALENDAR / END:VCALENDAR | Envolve o ficheiro inteiro. Tudo o resto fica lá dentro. |
| VERSION:2.0 | A versão do iCalendar. Sempre 2.0 nos ficheiros criados hoje. |
| PRODID | O programa que escreveu o ficheiro. Obrigatório, mas os calendários ignoram o valor. |
| BEGIN:VEVENT / END:VEVENT | Um evento. Um ficheiro pode conter um ou vários. |
| UID | Um identificador único do evento. Na maioria dos calendários, importar o mesmo UID duas vezes atualiza o evento em vez de o duplicar. |
| DTSTAMP | Quando esta cópia do evento foi escrita. Obrigatório em todos os eventos. |
| DTSTART / DTEND | Início e fim. A forma como estão escritos define o fuso horário (ver abaixo). Um evento de dia inteiro usa uma data sem hora. |
| SUMMARY | O título que aparece no calendário. |
| LOCATION | Texto livre. As apps de calendário tentam encontrá-lo no mapa, por isso uma morada completa funciona melhor. |
| DESCRIPTION | Notas. As quebras de linha escrevem-se como \n. |
| RRULE | Uma regra de repetição, por exemplo FREQ=WEEKLY;COUNT=10. |
| BEGIN:VALARM | Um lembrete, por exemplo 30 minutos antes do início. |
| BEGIN:VTIMEZONE | A definição de um fuso horário com nome usado por DTSTART, incluindo as regras da hora de verão. |
Há dois pormenores importantes quando escreve um ficheiro à mão: as linhas terminam com CRLF (retorno de carro mais mudança de linha), e uma linha com mais de 75 caracteres é «dobrada» para a linha seguinte, que começa então com um espaço. As apps de calendário tratam de ambos ao exportar; um editor de texto não.
Como se escrevem as horas e os fusos horários
A maioria dos problemas com horas erradas vem desta linha. DTSTART pode escrever-se de quatro formas, e cada uma significa algo diferente.
| Escrito como | Significado |
|---|---|
| DTSTART:20270115T203000Z | UTC. O Z no fim significa «tempo universal». Cada calendário converte-o para o fuso horário de quem vê o evento. A opção mais segura para voos e reuniões online. |
| DTSTART;TZID=America/New_York:20270115T203000 | Hora local num fuso horário com nome. A melhor opção para eventos presenciais: a hora fica 20:30 em Nova Iorque, esteja onde estiver quem vê o evento. |
| DTSTART:20270115T203000 | Hora «flutuante», sem fuso horário. Aparece como 20:30 no fuso horário em que a pessoa estiver. Serve para «almoço ao meio-dia», mas não para nada que atravesse fusos horários. |
| DTSTART;VALUE=DATE:20270115 | Evento de dia inteiro. Sem hora e sem fuso horário. DTEND é o dia a seguir ao último dia. |
Quando um ficheiro usa TZID, deve incluir também um bloco VTIMEZONE que defina esse fuso horário. Muitos calendários conhecem os nomes de fusos mais comuns e funcionam sem ele; um importador mais rigoroso pode não funcionar.
De onde vêm os ficheiros ICS
- Convites para reuniões
- O Outlook, o Google Calendar e o Calendário da Apple anexam um .ics (muitas vezes chamado invite.ics) aos e-mails de convite. A linha METHOD:REQUEST indica ao calendário que o recebe que deve mostrar as opções para aceitar e recusar.
- Confirmações de bilhetes e reservas
- Os sites de eventos e de viagens oferecem uma ligação «Adicionar ao calendário» que descarrega um .ics com um evento.
- Exportações de calendários
- O Calendário da Apple, o Google Calendar e o Outlook podem exportar um calendário inteiro como um só ficheiro com todos os eventos.
- Subscrições de calendários
- Uma ligação webcal:// ou https:// para um .ics que o seu calendário volta a descarregar periodicamente, como o calendário de jogos de uma equipa ou o calendário do ano letivo.
- Imagens convertidas
- Uma fotografia ou captura de ecrã de um horário, lida por uma app como o Photo2Calendar e exportada como .ics depois de rever os campos.
Como abrir um ficheiro ICS
- Calendário da Apple no iPhone: toque no ficheiro no Mail e adicione os eventos. A partir da app Ficheiros ou do Safari, depende da versão do iOS; veja como abrir um ficheiro ICS no iPhone.
- Calendário da Apple no Mac: faça duplo clique no ficheiro ou use Ficheiro > Importar. O guia de calendários da Apple explica as duas formas.
- Google Calendar: num computador, em Definições > Importar e exportar (passos da Google). A app para telemóvel não importa ficheiros; veja o guia do Google Calendar para as alternativas.
- Outlook: no Outlook na web, use a opção para adicionar um calendário e carregue-o a partir de um ficheiro. No Outlook para Windows, use o menu Ficheiro e a opção de importar e exportar.
- Só para ler: qualquer editor de texto. Notas no iPhone, TextEdit no Mac, Bloco de Notas no Windows.
ICS, iCal, .ical, .vcs, webcal
- iCalendar é o formato; .ics é a extensão do ficheiro.
- iCal era o nome da app de calendário da Apple até 2012. «Ficheiro iCal» e «formato iCal» significam um ficheiro .ics.
- .ical é uma extensão pouco comum para o mesmo conteúdo. Se um ficheiro não abrir, mude a extensão para .ics.
- .vcs é o vCalendar, o antecessor dos anos 90. Alguns calendários ainda o abrem; caso contrário, converta-o com uma app de calendário que importe .vcs e exporte .ics.
- webcal:// não é um ficheiro, mas uma ligação para um .ics num servidor. Os dispositivos Apple e alguns outros calendários tratam-na como «subscrever este calendário». A mesma ligação com https:// normalmente também funciona.
- .ifb contém apenas informação de disponibilidade, sem detalhes dos eventos.
Problemas comuns
- Hora errada depois de importar: hora flutuante, falta do bloco VTIMEZONE ou um fuso horário errado na app que exportou. Verifique a linha DTSTART.
- Duplicados: cada importação de um ficheiro com UID novos cria uma nova cópia. Importe uma só vez, ou para um calendário vazio que possa apagar.
- Repetições transformadas em eventos soltos: a app que exportou escreveu cada ocorrência como um VEVENT próprio. Não se perde nada, mas não há uma série para editar de uma só vez.
- Caracteres estranhos: o ficheiro não foi guardado em UTF-8. Exporte-o de novo ou volte a guardá-lo em UTF-8 num editor de texto.
- «Não foi possível ler o ficheiro»: normalmente falta uma linha END, um UID ou um DTSTAMP, ou há fins de linha de Windows e Unix misturados. Valide-o com um validador de iCalendar online antes de o corrigir à mão.
- O evento nunca é atualizado: importou uma cópia. Subscreva a ligação, se o organizador a disponibilizar.
Criar o seu próprio ficheiro
O nosso guia para criar um ficheiro ICS mostra quatro formas: exportar de um calendário que já usa, preencher um gerador online, escrever o ficheiro à mão ou partir de uma imagem. Para a última, o Photo2Calendar lê uma fotografia, uma captura de ecrã ou um horário em papel, mostra todos os campos para os rever e exporta os eventos revistos como .ics.
Aponte a câmara do iPhone ao código para abrir a App Store
Download gratuito com uma análise de teste. Depois, subscrição semanal, mensal ou anual; o preço na sua moeda aparece na App Store. Sem período de teste.
Perguntas frequentes
Um ficheiro ICS é o mesmo que iCal?
Quase. iCalendar é o formato, .ics é a extensão do ficheiro e iCal era o antigo nome da app Calendário da Apple. Muitas pessoas dizem «ficheiro iCal» para os três. A extensão .ical é rara; mudar o nome para .ics normalmente permite abri-lo.
Posso abrir um ficheiro ICS no iPhone?
Sim. Toque no ficheiro no Mail e a app Calendário propõe adicionar os eventos. A partir de outras apps depende da versão do iOS; o nosso guia para iPhone explica o Mail, a app Ficheiros, o Safari e as apps de mensagens.
Um ficheiro ICS atualiza-se sozinho?
Um ficheiro importado é uma cópia feita uma única vez. A ligação de um calendário subscrito volta a descarregar o ficheiro, por isso as alterações do organizador aparecem. Se precisa de atualizações, subscreva em vez de importar.
Porque é que o evento aparece à hora errada?
O ficheiro usou hora flutuante ou o fuso horário errado. Abra-o num editor de texto e veja a linha DTSTART: um Z no fim significa UTC, TZID indica um fuso horário e uma hora sem nenhum dos dois é flutuante. Corrija o evento depois de importar.
Um ficheiro ICS pode conter vários eventos ou um evento que se repete?
Sim, ambos. Um ficheiro pode conter qualquer número de blocos VEVENT, e um único evento pode ter uma RRULE para repetições semanais, mensais ou personalizadas. Algumas apps exportam cada repetição como um evento separado.
É seguro abrir um ficheiro ICS?
O ficheiro é texto simples e não pode executar código. Os riscos são os mesmos de qualquer e-mail: ligações na descrição e convites de spam que aparecem no seu calendário. Recuse convites desconhecidos em vez de clicar nas ligações.
Detalhes do formato segundo o RFC 5545. Para perguntas sobre a app, consulte as perguntas frequentes do Photo2Calendar.