kotlinx-datetime/kotlinx.datetime.format/DateTimeComponents/Formats/ISO_DATE_TIME_OFFSET

ISO_DATE_TIME_OFFSET

val ISO_DATE_TIME_OFFSET: DateTimeFormat<DateTimeComponents>(source)

ISO 8601 extended format for dates and times with UTC offset.

For specifying the time zone offset, the format uses the UtcOffset.Formats.ISO format, except that during parsing, specifying the minutes is optional.

This format differs from LocalTime.Formats.ISO in its time part in that specifying the seconds is not optional.

Examples of instants in the ISO 8601 format:

  • 2020-08-30T18:43:00Z

  • 2020-08-30T18:43:00.50Z

  • 2020-08-30T18:43:00.123456789Z

  • 2020-08-30T18:40:00+03:00

  • 2020-08-30T18:40:00+03:30:20

  • 2020-01-01T23:59:59.123456789+01

  • +12020-01-31T23:59:59Z

This format uses the local date, local time, and UTC offset fields of DateTimeComponents.

See ISO-8601-1:2019, 5.4.2.1b), excluding the format without the offset.

Guaranteed to parse all strings that Instant.toString produces.