Eventjet GraphQL API documentation

ZonedDateTime

Scalar

Zoned date-time string in IXDTF (RFC 9557) format.

Represents a local wall-clock date and time tagged with an IANA time zone. The server always emits:

  • seconds precision (no fractional seconds),
  • a numeric UTC offset, and
  • a bracketed IANA zone name.

Example (Vienna in winter): 2025-03-10T19:30:00+01:00[Europe/Vienna]

Use this when you need "what’s on the poster" semantics (the time as seen at the venue), while still being unambiguous and round-trippable.

Parsing rules:

  • If both offset and zone are present, they must match; otherwise treat as an error.
  • Input that includes a zone but omits the offset may be accepted; the server will resolve the correct offset for that zone and local time (be careful near DST gaps/folds). Emitted values will always include both.

Relation to other scalars:

  • Instant: absolute time in UTC (...Z) - storage/ordering.
  • Date: RFC 3339 date-time with numeric offset - absolute time without a named zone.

More on the format: RFC 9557 (IXDTF) extends RFC 3339 to allow a bracketed IANA time zone, e.g. ...+01:00[Europe/Vienna].

In JavaScript, you can use Temporal.ZonedDateTime.from() to parse this.