iCalendar-händelse

Kallas också: VEVENT, kalender-QR-kod, ICS-händelse, iCalendar event

Definition

En iCalendar-händelse är ett standardiserat textblock, inlett med BEGIN:VEVENT, som beskriver ett möte eller en bokning. Kodad i en QR-kod låter den en telefon lägga till händelsen i en kalender.

Hur händelsetexten ser ut

En iCalendar-händelse är en uppsättning märkta rader mellan BEGIN:VEVENT och END:VEVENT. Formatet definieras i RFC 5545, publicerad 2009, och är detsamma som används i .ics-kalenderfiler.

Ett exempel i QR-storlek: BEGIN:VEVENT, SUMMARY:Bread baking class, DTSTART:20261015T170000Z, DTEND:20261015T190000Z, LOCATION:Maple Street Bakery, Portland, END:VEVENT. En fullständig kalenderfil omsluter händelser i BEGIN:VCALENDAR och lägger till fält som UID och DTSTAMP, men QR-koder bär ofta bara händelseblocket för att spara utrymme.

  • SUMMARY: händelsens rubrik
  • DTSTART och DTEND: start och slut, som ÅÅÅÅMMDDTTIMMSS (YYYYMMDDTHHMMSS)
  • LOCATION: plats eller adress
  • DESCRIPTION: längre anteckningar
  • Ett avslutande Z betyder att tiden är i UTC

Att få tiden rätt

Att skriva tider i UTC med ett avslutande Z är det enklaste sättet att få en händelse att visas vid rätt lokal tid för alla. En tid utan Z behandlas som flytande lokal tid, vilket kan förskjutas för människor i andra tidszoner, och en namngiven tidszon kräver extra data som gör koden större.

Heldagshändelser kan använda ett värde med bara datum, som DTSTART;VALUE=DATE:20261015.

Stöd och alternativ

Stödet för händelsekoder i inbyggda kameraappar varierar; vissa erbjuder att lägga till händelsen direkt, medan andra visar texten eller kräver en skannerapp. Det är värt att kontrollera på de telefoner din publik använder före tryck.

Ett vanligt alternativ är en QR-kod som länkar till en hostad .ics-fil eller en evenemangssida med knappar för att lägga till i kalendern. En länk gör det också möjligt att rätta tid eller plats efter att koden tryckts.

Vanliga frågor

Kan en QR-kod lägga till en händelse i min kalender?

Ja. Koda händelsen som ett iCalendar VEVENT-block, så erbjuder telefoner som stöder det att lägga till den. Stödet varierar, så en länk till en .ics-fil är en pålitlig reservlösning.

Vad betyder Z i slutet av en kalendertid?

Det markerar tiden som UTC. Kalenderappar omvandlar den sedan till var och ens lokala tidszon.

Varför lade min kalender-QR-kod till händelsen vid fel tid?

Tiden skrevs förmodligen utan Z eller tidszon och lästes därför som lokal tid på den skannande telefonen. Skriv tider i UTC med ett avslutande Z.

Källor och standarder

Alla begrepp