Wydarzenie iCalendar

Inne nazwy: VEVENT, kod QR kalendarza, wydarzenie ICS, iCalendar event

Definicja

Wydarzenie iCalendar to standardowy blok tekstu, otwierany przez BEGIN:VEVENT, opisujący spotkanie lub termin. Zakodowany w kodzie QR pozwala telefonowi dodać wydarzenie do kalendarza.

Jak wygląda tekst wydarzenia

Wydarzenie iCalendar to zestaw oznaczonych wierszy między BEGIN:VEVENT i END:VEVENT. Format zdefiniowano w RFC 5545, opublikowanym w 2009 roku, i jest to ten sam format, którego używają pliki kalendarza .ics.

Przykład o rozmiarze mieszczącym się w kodzie QR: BEGIN:VEVENT, SUMMARY:Bread baking class, DTSTART:20261015T170000Z, DTEND:20261015T190000Z, LOCATION:Maple Street Bakery, Portland, END:VEVENT. Pełny plik kalendarza owija wydarzenia w BEGIN:VCALENDAR i dodaje pola takie jak UID i DTSTAMP, ale kody QR często niosą tylko blok wydarzenia, żeby oszczędzić miejsce.

  • SUMMARY: tytuł wydarzenia
  • DTSTART i DTEND: początek i koniec, w postaci RRRRMMDDTGGMMSS
  • LOCATION: miejsce lub adres
  • DESCRIPTION: dłuższe notatki
  • Końcowe Z oznacza, że czas jest podany w UTC

Jak poprawnie zapisać czas

Zapisanie czasu w UTC z końcowym Z to najprostszy sposób, żeby wydarzenie pojawiło się o właściwej lokalnej godzinie dla każdego. Czas bez Z jest traktowany jako pływający czas lokalny, który może się przesuwać dla osób w innych strefach czasowych, a nazwana strefa czasowa wymaga dodatkowych danych, które powiększają kod.

Wydarzenia całodniowe mogą używać wartości tylko z datą, na przykład DTSTART;VALUE=DATE:20261015.

Obsługa i alternatywy

Obsługa kodów wydarzeń we wbudowanych aplikacjach aparatu jest różna; niektóre proponują bezpośrednie dodanie wydarzenia, a inne pokazują tekst albo wymagają aplikacji skanującej. Warto sprawdzić to na telefonach, których używa Twoja publiczność, przed drukiem.

Częstą alternatywą jest kod QR prowadzący do hostowanego pliku .ics albo strony wydarzenia z przyciskami dodania do kalendarza. Link pozwala też poprawić czas lub miejsce po wydrukowaniu kodu.

Najczęstsze pytania

Czy kod QR może dodać wydarzenie do mojego kalendarza?

Tak. Zakoduj wydarzenie jako blok iCalendar VEVENT, a telefony, które to obsługują, zaproponują jego dodanie. Obsługa jest różna, więc pewną opcją awaryjną jest link do pliku .ics.

Co oznacza Z na końcu czasu w kalendarzu?

Oznacza, że czas jest podany w UTC. Aplikacje kalendarza przeliczają go wtedy na lokalną strefę czasową każdej osoby.

Dlaczego mój kod QR kalendarza dodał wydarzenie o złej godzinie?

Czas prawdopodobnie zapisano bez Z ani strefy czasowej, więc telefon skanujący odczytał go jako czas lokalny. Zapisuj czas w UTC z końcowym Z.

Źródła i normy

Wszystkie hasła