Tijdzones

#Twee soorten tijd

Momenten zijn wanneer iets gebeurde of gaat gebeuren: een registratie, een betaling, een check-in, het begin van een sessie. Ze zijn ISO 8601 in UTC, met milliseconden en een Z, en hun namen eindigen op Utc:

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

Plaatselijke tijden zijn wat iemand op de locatie in het programma leest. Sessies, diensten, kortingscodes en verkoopperiodes hebben ze naast het moment, in de eigen tijd van de locatie, zonder zone, en hun namen eindigen op Local:

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

Het evenement noemt de IANA-tijdzone van de locatie in timeZone. De startDate en endDate ervan zijn gewone datums op de locatie.

#Welke je gebruikt

• Om te vergelijken, sorteren, op te slaan of te rekenen: het moment, in UTC.
• Om iemand een tijd te tonen: de plaatselijke tijd zoals hij is, of het moment omgerekend naar de timeZone van het evenement. Nooit naar de zone van je server: een sessie om 09:30 in Amsterdam is om 09:30 voor iedereen die erheen gaat, waar hun laptop ook staat.
• De overgang naar zomer- of wintertijd zit er al in: een sessie op de laatste zondag van oktober heeft het juiste UTC-moment bij zijn plaatselijke tijd.

#Tijden versturen

Momenten die je verstuurt (salesEndUtc, endsUtc) worden als UTC gelezen, wat er ook staat: een offset zoals +01:00 wordt gerespecteerd, een tijd zonder offset is UTC, nooit de zone van de server. Voor updatedSince geldt hetzelfde.

Een nieuwe sessie kun je opgeven in plaatselijke tijd (startsLocal, endsLocal), dan rekent AttendBeacon die om met de tijdzone van het evenement, of in UTC (startsUtc, endsUtc). Meestal heb je de plaatselijke tijd: dat is wat de spreker heeft afgesproken.

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" })
});

#Dagen in overzichten

Waar de API per dag telt (het verkooptempo), zijn de dagen die van de locatie in haar tijdzone, dus een registratie om 00:30 in Amsterdam telt op die dag, niet op de dag ervoor in UTC.