Генератор QR-кода мероприятия

Полезная нагрузка iCalendar, в точности

Код несёт полный объект по RFC 5545, а не ссылку на него. Он открывается строкой BEGIN:VCALENDAR, несёт VERSION:2.0 и PRODID, опознающий этот генератор, оборачивает один VEVENT и закрывается END:VCALENDAR. Внутри события лежат UID и DTSTAMP, которых требует спецификация, рядом с DTSTART, DTEND, SUMMARY и теми из LOCATION, DESCRIPTION и URL, которые вы заполнили.

Каждая содержательная строка заканчивается возвратом каретки и переводом строки — именно в этом порядке. Парсеры строги к этому: объект с голыми переводами строки — это то, из-за чего в остальном корректное событие не импортируется. Строки длиннее 75 октетов сворачиваются вставкой CRLF и одного пробела, а читающая сторона склеивает их обратно перед разбором — поэтому длинное описание не ломает объект.

Поскольку всё событие живёт в узоре, телефону не нужна сеть, чтобы создать запись. Это же означает, что событие заморожено: смена площадки потом означает создание и печать нового кода, потому что обновлять нечего.

Плавающее местное время против UTC

В плавающем режиме DTSTART записывается как YYYYMMDDTHHMMSS, без завершающей Z и без параметра TZID. RFC 5545 называет это плавающим временем, и означает оно ровно то, что сказано: 19:00 — это 19:00 на том устройстве, которое его открыло, где бы это устройство ни находилось. Для концерта, рыночного прилавка или дня открытых дверей в школе почти всегда нужно именно это, потому что все, кто читает афишу, стоят в том же часовом поясе, что и площадка.

В режиме UTC то же свойство записывается как YYYYMMDDTHHMMSSZ, и завершающая Z фиксирует момент. Каждое устройство при импорте переводит его в местное время, поэтому событие, назначенное на 14:00 UTC, показывается как 15:00 в Берлине и 09:00 в Нью-Йорке. Для вебинара это верный выбор, для сельского праздника — неверный.

Именованная зона — DTSTART;TZID=Europe/London — это третья возможность в спецификации, и этот инструмент её не предлагает. Чтобы сделать это правильно, нужно встроить компонент VTIMEZONE с полным набором правил перехода на летнее время, а это добавляет несколько сотен байт к полезной нагрузке, которая обязана поместиться в один символ; объект же, ссылающийся на TZID, который он не определяет, некорректен. Плавающее время и UTC покрывают случаи печатной афиши без этой платы.

Экранирование, события на весь день и размер

Текстовые значения экранируются так, как требует спецификация, прежде чем попасть в полезную нагрузку. Сначала экранируются обратные косые черты, затем точки с запятой и запятые, затем переводы строки; в любом другом порядке дважды экранируются те обратные косые черты, которые вы только что ввели. Двоеточие внутри текстового значения не трогают — RFC 5545 прямо запрещает его экранировать, хотя более старый RFC 2445 этого требовал, отчего часть самодельных генераторов до сих пор делает это неверно.

Событие на весь день использует форму даты: DTSTART;VALUE=DATE:20260904. Его DTEND исключающий, поэтому один день 4 сентября записывается с DTEND;VALUE=DATE:20260905. Ошибка здесь и даёт событие, которое короче или длиннее на один день.

Практический предел здесь — размер. Символ QR вмещает не более 2953 байт на самом низком уровне коррекции, а одна только календарная обёртка тратит около двухсот, прежде чем начнётся ваш текст. Длинное описание поднимает символ на версию выше с более мелкими модулями, а это требует либо более крупной печати, либо более близкого сканирования. Предпросмотр показывает версию по мере набора — следите за ней.

• Обратная косая черта становится \\, точка с запятой — \;, запятая — \,
• Перевод строки становится двумя символами \n
• Двоеточия в текстовых значениях RFC 5545 не экранируются никогда