Подія iCalendar

Також відомо як: VEVENT, QR-код календаря, подія ICS, iCalendar event

Визначення

Подія iCalendar це стандартний текстовий блок, що відкривається BEGIN:VEVENT і описує зустріч чи захід. Закодований у QR-коді, він дозволяє телефону додати подію до календаря.

Як виглядає текст події

Подія iCalendar це набір позначених рядків між BEGIN:VEVENT і END:VEVENT. Формат визначено в RFC 5545, опублікованому в 2009 році, і це той самий формат, який використовують файли календаря .ics.

Приклад розміру для QR: BEGIN:VEVENT, SUMMARY:Bread baking class, DTSTART:20261015T170000Z, DTEND:20261015T190000Z, LOCATION:Maple Street Bakery, Portland, END:VEVENT. Повний файл календаря обгортає події в BEGIN:VCALENDAR і додає поля на кшталт UID і DTSTAMP, але QR-коди часто несуть лише блок події, щоб заощадити місце.

  • SUMMARY: назва події
  • DTSTART і DTEND: початок і кінець, у форматі YYYYMMDDTHHMMSS
  • LOCATION: місце чи адреса
  • DESCRIPTION: довші нотатки
  • Кінцева Z означає, що час у UTC

Як правильно вказати час

Запис часу в UTC із кінцевою Z це найпростіший спосіб зробити так, щоб подія з'являлася у правильний місцевий час для всіх. Час без Z вважається плаваючим місцевим часом, який може зсуватися для людей в інших часових поясах, а іменований часовий пояс потребує додаткових даних, що збільшують код.

Події на весь день можуть використовувати значення лише з датою, наприклад DTSTART;VALUE=DATE:20261015.

Підтримка та альтернативи

Підтримка кодів подій у вбудованих додатках камер різниться; одні пропонують додати подію напряму, а інші показують текст або потребують додатка-сканера. Варто перевірити на телефонах, якими користується ваша аудиторія, перед друком.

Поширена альтернатива це QR-код, що веде на розміщений файл .ics або сторінку події з кнопками додавання до календаря. Посилання також дозволяє виправити час чи місце після друку коду.

Поширені запитання

Чи може QR-код додати подію до мого календаря?

Так. Закодуйте подію як блок iCalendar VEVENT, і телефони, що це підтримують, запропонують її додати. Підтримка різниться, тож посилання на файл .ics це надійний запасний варіант.

Що означає Z наприкінці часу в календарі?

Вона позначає час як UTC. Календарні додатки потім переводять його в місцевий часовий пояс кожної людини.

Чому мій QR-код календаря додав подію в неправильний час?

Імовірно, час записано без Z чи часового поясу, тож його прочитано як місцевий час телефона, що сканує. Записуйте час у UTC із кінцевою Z.

Джерела та стандарти

Усі терміни