Absolute times topic

Unlike the local classes, these are tied to an absolute moment of time in UTC, and to a specific location or time zone. (In the case of Instant, that time zone is UTC itself).

Use them when the time zone is not obvious, when coordinating between different geographic locations, or whenever a local time would be ambiguous. For example:

• Video chat or conference call schedule
• Shared calendars
• Log timestamps (Instant in particular)

var instant = Instant.fromUnix(Timespan(seconds: 946872306));
instant.toString() == '2000-01-03T04:05:06Z';

var odt = OffsetDateTime(ZoneOffset(-1), 2000, 1, 3, 3, 5, 6);
odt.toString() == '2000-01-03T03:05:06-0100';
odt.asInstant == instant;

var zdt = ZonedDateTime.fromInstant(instant, 'America/Los_Angeles');
zdt.toString() == '2000-01-02T20:05:06-0800';
zdt.timeZone == 'PST';
zdt.offset == ZoneOffset(-8);
zdt.asInstant == instant;

Classes

HasInstant

Interface implemented by any class that is tied to a specific Instant in time.

Instant

Represents a single instant in time as a Timespan since January 1, 1970 UTC.

NamedZoneOffset

A ZoneOffset with an associated name.

OffsetDateTime

A date and time at a fixed offset from UTC.

ZonedDateTime

A date and time in a specific time zone.

ZoneOffset

A time zone offset from UTC.