Skip to main content

Dates and times

Loop conforms to the W3C date and time nomenclature and uses the following types.

UtcTimestamp​

  • A point in incremental time with millisecond resolution.
  • Example: "2022-05-23T23:12:05.123Z"
  • Always includes the Z at the end, indicating UTC offset of 0.
  • Use cases: system-generated past dates like createdAt and sentAt.

FloatingDate​

  • A floating date (that is, without a time zone or offset).
  • Example: "2022-04-23"
  • Use cases: domain dates such as invoice issue dates and public tariff expiration dates.

FloatingDateTime​

  • A floating date and time with millisecond resolution.
  • Example: "2022-05-23T06:00:00.123"
  • Use cases: domain dates such as pick up and delivery times when the corresponding time zone is unclear.

WallDate​

  • A wall time date (that is, with a time zone).
  • Example: "2022-04-23|America/Chicago"
  • UTC offset can be computed with an IANA table lookup.
  • Use case: domain dates anchored to a specific place, such as delivery and pickup dates.

WallDateTime​

  • A point in wall time with millisecond resolution.
  • Example: "2022-05-23T06:00:00.000|America/Chicago"
  • Use case: domain date and time values anchored to a specific place, such as delivery and pickup date times.