Tidssoner

#To slags tid

Tidspunkter er når noe skjedde eller skal skje: en påmelding, en betaling, en innsjekking, starten på en økt. De er ISO 8601 i UTC, med millisekunder og en Z, og navnene deres slutter på Utc:

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

Lokal tid er det et menneske på stedet leser i programmet. Økter, vakter, rabattkoder og salgsperioder har den ved siden av tidspunktet, i stedets egen tid, uten sone, og navnene deres slutter 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"
}

Arrangementet oppgir stedets IANA-tidssone i timeZone. startDate og endDate er vanlige datoer på stedet.

#Hva du skal bruke

• For å sammenligne, sortere, lagre eller beregne: tidspunktet, i UTC.
• For å vise et klokkeslett til noen: den lokale tiden slik den er, eller tidspunktet omregnet til arrangementets timeZone. Aldri til serverens sone: en økt kl. 09.30 i Amsterdam er kl. 09.30 for alle som deltar, uansett hvor de har den bærbare datamaskinen sin.
• Overganger mellom sommer- og vintertid er allerede tatt med: en økt den siste søndagen i oktober har riktig UTC-tidspunkt for sin lokale tid.

#Slik sender du tider

Tidspunkter du sender (salesEndUtc, endsUtc), leses som UTC uansett hva de sier: en forskyvning som +01:00 respekteres, en tid uten forskyvning er UTC, aldri serverens sone. Det samme gjelder updatedSince.

En ny økt kan oppgis i lokal tid (startsLocal, endsLocal), og AttendBeacon regner den om med arrangementets tidssone, eller i UTC (startsUtc, endsUtc). Lokal tid er vanligvis det du har: det er det foredragsholderen har avtalt.

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

#Dager i oversikter

Der API-et teller per dag (salgstempoet), er dagene stedets dager i stedets tidssone, så en påmelding kl. 00.30 i Amsterdam telles på den dagen, ikke på dagen før i UTC.