Tidszoner

#Två sorters tid

Tidpunkter är när något hände eller kommer att hända: en anmälan, en betalning, en incheckning, starten på en session. De anges i ISO 8601 i UTC, med millisekunder och ett Z, och deras namn slutar på Utc:

"checkedInUtc": "2026-11-12T07:58:12.000Z"

Lokala tider är det som en person på plats läser i programmet. Sessioner, pass, rabattkoder och försäljningsperioder har dem bredvid tidpunkten, i lokalens egen tid, utan zon, och deras namn slutar på Local:

{
  "title": "Opening keynote: software that finds its way",
  "startsUtc": "2026-11-12T08:30:00.000Z",
  "startsLocal": "2026-11-12T09:30",
  "timeZone": "Europe/Amsterdam"
}

Evenemanget anger lokalens IANA-tidszon i timeZone. Dess startDate och endDate är vanliga datum på platsen.

#Vilken du ska använda

• För att jämföra, sortera, spara eller räkna: tidpunkten, i UTC.
• För att visa en tid för någon: den lokala tiden som den är, eller tidpunkten omräknad till evenemangets timeZone. Aldrig till din servers zon: en session kl. 09.30 i Amsterdam är kl. 09.30 för alla som går dit, var deras bärbara dator än befinner sig.
• Omställningar till och från sommartid är redan inräknade: en session den sista söndagen i oktober har rätt tidpunkt i UTC för sin lokala tid.

#Skicka tider

Tidpunkter som du skickar (salesEndUtc, endsUtc) tolkas som UTC oavsett vad de säger: en förskjutning som +01:00 respekteras, en tid utan förskjutning är UTC, aldrig serverns zon. Detsamma gäller updatedSince.

En ny session kan anges i lokal tid (startsLocal, endsLocal), och då räknar AttendBeacon om den med evenemangets tidszon, eller i UTC (startsUtc, endsUtc). Lokal tid är oftast det du har: det är vad talaren har gått med på.

curl -X POST "https://attendbeacon.com/api/v1/events/b3ac0000-0000-4000-8000-000000000001/sessions" \
  -H "Authorization: Bearer $ATTENDBEACON_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Closing keynote: what we learned", "kind": "keynote", "startsLocal": "2026-11-13T16:30", "endsLocal": "2026-11-13T17:15" }'

await fetch(`${base}/events/${eventId}/sessions`, {
  method: "POST",
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
  body: JSON.stringify({ title: "Closing keynote: what we learned", kind: "keynote", startsLocal: "2026-11-13T16:30", endsLocal: "2026-11-13T17:15" })
});

#Dagar i sammanfattningar

Där API:t räknar per dag (försäljningstakten) är dagarna lokalens dagar i dess tidszon, så en anmälan kl. 00.30 i Amsterdam räknas på den dagen, inte på dagen innan i UTC.