Ir para o conteúdo
OneKitly

O mesmo ficheiro .ics pode designar cinco horas diferentes

Publicado a 07/09/2026 · 4 min de leitura · Ferramentas de ficheiros

Daniel Okonkwo

Daniel Okonkwo — Programador front-end e redator de Tecnologia na OneKitly

Desempenho web · Formatos de ficheiro

Verificado a partir de 3 fontes

Ver perfil →
Em resumo

Uma linha DTSTART tem três formas. DTSTART:20260908T080000Z acaba em Z: é um instante em UTC — o mesmo momento para toda a gente, e a única forma que nada pode ler mal. DTSTART;TZID=Europe/Paris:20260907T140000 é uma hora de relógio acompanhada do nome do fuso a que pertence, o que só é correto se quem a lê conhecer esse fuso. DTSTART:20260907T140000, sem Z nem TZID, é uma hora flutuante: duas da tarde onde quer que estejas, o que se quer para uma contagem decrescente de Ano Novo e quase nunca para uma reunião. O caso perigoso é o segundo tratado sem cuidado: tira o TZID, guarda os algarismos, e a hora de relógio reancora-se na máquina que lê. O visualizador indica-te aqui qual das três tens à frente antes de qualquer conversão, e os conversores transmitem o fuso intacto em vez de adivinhar.

Publicidade

O iCalendar escreve uma hora de início de três maneiras, e só uma é inequívoca. Uma reunião escrita com um fuso nomeado, convertida em máquinas de Paris, Nova Iorque e Honolulu, abrangeu dezanove horas e mudou de dia.

Porque é que o ficheiro nomeia um fuso em vez de um desvio

Escrever +02:00 fixaria a reunião a um número que deixa de ser verdadeiro duas vezes por ano. Um compromisso semanal às 14:00 em Paris é +02:00 em setembro e +01:00 em novembro, e a graça de um evento recorrente é que fica às duas da tarde dos dois lados da mudança. Nomear Europe/Paris diz que regulamento aplicar; o desvio consulta-se depois, data a data, numa base de fusos atualizada sempre que um país mexe nos relógios.

É também por isso que converter uma hora TZID para UTC não é uma subtração que se faça de cabeça, e por isso uma ferramenta sem base de fusos não o deve tentar. Guardar o nome e os algarismos de relógio exatamente como o ficheiro os escreveu não perde nada; substituí-los por um instante calculado a partir do fuso errado perde, e é o tipo de erro que parece normal no ecrã até alguém entrar numa videochamada uma hora atrasado.

O evento de dia inteiro, que não é uma hora

Um aniversário, um feriado ou um dia de folga escreve-se DTSTART;VALUE=DATE:20261225 — oito algarismos, sem hora, e o parâmetro que o diz. Significa todo o 25 de dezembro onde quer que o leitor esteja, o que é exatamente certo para o Natal e seria falso como instante. Reescreve-o como data-hora e torna-se meia-noite UTC, que ainda é dia 25 na Europa e já é 24 a oeste de Greenwich. O marcador VALUE=DATE é transmitido aqui tal e qual, em vez de resolvido numa hora.

O que verificar antes de confiar num calendário importado

Abre o ficheiro no visualizador e olha para um evento de que conheças a hora real. Se estiver certa aí, o ficheiro está certo, e qualquer desacordo posterior vem da aplicação para onde importaste. Três hábitos cobrem quase tudo: prefere a forma Z quando publicares um calendário a que outros se subscrevam, guarda o TZID quando moveres o teu próprio calendário entre aplicações, e nunca edites uma hora de início à mão num editor de texto sem ver em qual das três formas a linha está escrita.

Uma reunião escrita TZID=Europe/Paris, reancorada à máquina que lê
Máquina que lê o ficheiroEm que se torna as 14:00Desvio
Europe/Paris20260907T120000Zcorreto
UTC20260907T140000Z+2 h
America/New_York20260907T180000Z+6 h
Asia/Tokyo20260907T050000Z-7 h
Pacific/Honolulu20260908T000000Z+12 h, no dia seguinte
Visualizador de ICSAbre um convite ou exportação de calendário e lê os eventos antes de importares.Experimentar a ferramenta →
Publicidade

Perguntas frequentes

Os meus eventos importados estão todos desfasados uma ou duas horas. O que aconteceu?
Um desvio constante em todos os eventos é a assinatura de um fuso retirado e substituído. Abre o .ics original no visualizador: se as horas de início parecerem certas aí, o ficheiro guardou o seu fuso e é a aplicação de importação que aplica outro — verifica a sua definição de fuso do calendário, distinta da do sistema. Um desvio que varia de evento para evento é outro problema, normalmente uma mistura de horas Z e flutuantes no mesmo ficheiro.
Que forma devo usar quando publico um calendário?
Z para tudo o que tenha um instante fixo — um webinar, um jogo, um prazo — porque nada o pode ler mal e não é precisa base de fusos do outro lado. TZID para um calendário que as pessoas vivem localmente, como um horário escolar ou o de um escritório, onde é a hora de relógio que tem de ficar no lugar na mudança de hora. VALUE=DATE para dias inteiros. Horas flutuantes só quando queres mesmo dizer hora local em todo o lado, o que na prática se resume ao Ano Novo e a pouco mais.
O visualizador modifica o meu ficheiro?
Não. Lê o ficheiro no teu navegador e mostra o que ele contém; o ficheiro em disco não é tocado, e nada é enviado para lado nenhum. É esse o sentido de olhar antes de converter: podes resolver uma discussão sobre uma hora de início sem te comprometeres com nada.

Artigos que podem interessar-lhe

Todos os guias →
TutorialConstruir um calendário a partir de um horário que já tens numa folha de cálculoHorários de aulas, calendários de jogos, escalas de turnos e programas de conferência começam todos por ser uma tabela. Quatro colunas bastam para transformar um deles num ficheiro que qualquer aplicação de calendário sabe importar.ComparaçãoA exportação JSON guarda três coisas para as quais o CSV não tem colunaMesmo ficheiro, mesmo analisador, duas saídas. A folha de cálculo recebe oito colunas; o JSON recebe ainda o fuso nomeado, o indicador de dia inteiro e a regra de recorrência.ExplicaçãoUm evento recorrente é uma linha do CSV, não dozeUm ficheiro .ics guarda uma reunião semanal uma só vez, com uma regra anexa. Ao exportar para CSV obténs uma linha para toda a série — é o ficheiro a ser honesto, não o conversor a perder linhas.TutorialNão tens de renomear as tuas colunas para inglêsA linha de cabeçalho é reconhecida em seis línguas: prénom, apellidos, Vorname e cognome são todos entendidos. Um cabeçalho é mesmo ambíguo — nome — e é a coluna ao lado que decide.TutorialJuntar calendários e livros de endereços acrescenta — não remove duplicadosAs ferramentas de junção põem cada ficha de cada ficheiro numa só saída, pela ordem em que os deste. É o comportamento certo por omissão e a única coisa a saber antes de lá meteres duas exportações da mesma conta.ComparaçãoDois e-mails numa célula, ou duas cadeias num arrayUm contacto pode ter vários números e vários endereços. O CSV junta-os com um ponto médio numa só célula; o JSON guarda-os como lista, que é a diferença entre um script que funciona e outro que divide a olho.

Ferramentas relacionadas

Fontes

Detetaste um erro neste artigo?