Evento iCalendar

Também chamado de: VEVENT, QR Code de agenda, evento ICS, evento de calendário

Definição

Um evento iCalendar é um bloco de texto padrão, aberto por BEGIN:VEVENT, que descreve uma reunião ou compromisso. Codificado num QR Code, permite que o celular adicione o evento à agenda.

Como é o texto do evento

Um evento iCalendar é um conjunto de linhas rotuladas entre BEGIN:VEVENT e END:VEVENT. O formato é definido na RFC 5545, publicada em 2009, e é o mesmo usado pelos arquivos de calendário .ics.

Um exemplo do tamanho de um QR Code: BEGIN:VEVENT, SUMMARY:Bread baking class, DTSTART:20261015T170000Z, DTEND:20261015T190000Z, LOCATION:Maple Street Bakery, Portland, END:VEVENT. Um arquivo de calendário completo envolve os eventos em BEGIN:VCALENDAR e acrescenta campos como UID e DTSTAMP, mas os QR Codes costumam carregar apenas o bloco do evento para economizar espaço.

  • SUMMARY: o título do evento
  • DTSTART e DTEND: início e fim, no formato AAAAMMDDTHHMMSS
  • LOCATION: local ou endereço
  • DESCRIPTION: observações mais longas
  • Um Z no final significa que o horário está em UTC

Acertando o horário

Escrever os horários em UTC, com um Z no final, é a forma mais simples de fazer o evento aparecer no horário local correto para todos. Um horário sem Z é tratado como horário local flutuante, que pode mudar para quem está em outros fusos, e um fuso nomeado exige dados extras que deixam o código maior.

Eventos de dia inteiro podem usar um valor só de data, como DTSTART;VALUE=DATE:20261015.

Suporte e alternativas

O suporte a códigos de evento nos apps de câmera nativos varia; alguns oferecem adicionar o evento diretamente, enquanto outros mostram o texto ou exigem um aplicativo leitor. Vale conferir nos celulares que seu público usa antes de imprimir.

Uma alternativa comum é um QR Code que leva a um arquivo .ics hospedado ou a uma página de evento com botões de adicionar à agenda. Um link também permite corrigir o horário ou o local depois que o código foi impresso.

Perguntas frequentes

Um QR Code pode adicionar um evento à minha agenda?

Sim. Codifique o evento como um bloco VEVENT do iCalendar, e os celulares compatíveis oferecerão adicioná-lo. O suporte varia, então um link para um arquivo .ics é uma alternativa confiável.

O que significa o Z no final de um horário de calendário?

Ele marca o horário como UTC. Os apps de agenda o convertem para o fuso local de cada pessoa.

Por que meu QR Code de agenda adicionou o evento no horário errado?

Provavelmente o horário foi escrito sem Z ou fuso, e foi lido como horário local do celular que escaneou. Escreva os horários em UTC com um Z no final.

Fontes e normas

Todos os termos