Hoe de afspraaktekst eruitziet
Een iCalendar-afspraak is een reeks regels met labels tussen BEGIN:VEVENT en END:VEVENT. Het formaat is gedefinieerd in RFC 5545, gepubliceerd in 2009, en is hetzelfde als dat van .ics-agendabestanden.
Een voorbeeld op QR-formaat: BEGIN:VEVENT, SUMMARY:Bread baking class, DTSTART:20261015T170000Z, DTEND:20261015T190000Z, LOCATION:Maple Street Bakery, Portland, END:VEVENT. Een volledig agendabestand verpakt afspraken in BEGIN:VCALENDAR en voegt velden toe zoals UID en DTSTAMP, maar QR-codes bevatten vaak alleen het afspraakblok om ruimte te besparen.
- SUMMARY: de titel van de afspraak
- DTSTART en DTEND: begin en einde, als YYYYMMDDTHHMMSS
- LOCATION: plaats of adres
- DESCRIPTION: langere notities
- Een afsluitende Z betekent dat de tijd in UTC is
De tijd goed krijgen
Tijden in UTC met een afsluitende Z schrijven is de eenvoudigste manier om een afspraak voor iedereen op de juiste lokale tijd te laten verschijnen. Een tijd zonder Z wordt behandeld als zwevende lokale tijd, die kan verschuiven voor mensen in andere tijdzones, en een benoemde tijdzone vraagt extra gegevens waardoor de code groter wordt.
Afspraken van een hele dag kunnen een waarde met alleen een datum gebruiken, zoals DTSTART;VALUE=DATE:20261015.
Ondersteuning en alternatieven
De ondersteuning voor afspraakcodes in ingebouwde camera-apps verschilt; sommige bieden aan de afspraak direct toe te voegen, terwijl andere de tekst tonen of een scanner-app nodig hebben. Controleren op de telefoons die je publiek gebruikt is de moeite waard voor je print.
Een gangbaar alternatief is een QR-code die linkt naar een gehost .ics-bestand of een afspraakpagina met knoppen om aan de agenda toe te voegen. Met een link kunnen tijd of plaats ook worden gecorrigeerd nadat de code is gedrukt.