Tidszoner

#To slags tid

Tidspunkter er, hvornår noget skete eller vil ske: en tilmelding, en betaling, en indtjekning, starten på en session. De er ISO 8601 i UTC med millisekunder og et Z, og deres navne ender på Utc:

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

Lokale klokkeslæt er det, en person på stedet læser i programmet. Sessioner, vagter, rabatkoder og salgsperioder har dem ved siden af tidspunktet, i stedets egen tid, uden zone, og deres navne ender 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"
}

Eventet angiver stedets IANA-tidszone i timeZone. Dets startDate og endDate er almindelige datoer på stedet.

#Hvad du skal bruge

• Til at sammenligne, sortere, gemme eller regne: tidspunktet i UTC.
• Til at vise et klokkeslæt til en person: det lokale klokkeslæt, som det er, eller tidspunktet omregnet til eventets timeZone. Aldrig til din servers zone: en session kl. 09.30 i Amsterdam er kl. 09.30 for alle, der deltager, uanset hvor deres bærbare er.
• Skift mellem sommer- og vintertid er allerede regnet med: en session den sidste søndag i oktober har det rigtige UTC-tidspunkt for sit lokale klokkeslæt.

#Når du sender tidspunkter

Tidspunkter, du sender (salesEndUtc, endsUtc), læses som UTC, uanset hvad de siger: en forskydning som +01:00 respekteres, et tidspunkt uden forskydning er UTC, aldrig serverens zone. Det samme gælder updatedSince.

En ny session kan angives i lokal tid (startsLocal, endsLocal), som AttendBeacon omregner med eventets tidszone, eller i UTC (startsUtc, endsUtc). Lokal tid er som regel det, du har: det er det, oplægsholderen har sagt ja til.

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

#Dage i opsummeringer

Hvor API'et tæller pr. dag (salgstempoet), er dagene stedets dage i dets tidszone, så en tilmelding kl. 00.30 i Amsterdam tæller på den dag, ikke på dagen før i UTC.