Timestamp class final

A Timestamp represents a point in time independent of any time zone or calendar, represented as seconds and fractions of seconds at nanosecond resolution in UTC Epoch time. It is encoded using the Proleptic Gregorian Calendar which extends the Gregorian calendar backwards to year one. It is encoded assuming all minutes are 60 seconds long, i.e. leap seconds are "smeared" so that no leap second table is needed for interpretation. Range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

For more information, see the reference timestamp definition

Annotations
  • @immutable

Constructors

Timestamp({required int seconds, required int nanoseconds})
Timestamp.fromDate(DateTime date)
Creates a new timestamp from the given date.
factory
Timestamp.fromMicros(int microseconds)
Creates a new timestamp from the given number of microseconds.
factory
Timestamp.fromMillis(int milliseconds)
Creates a new timestamp from the given number of milliseconds.
factory
Timestamp.now()
Creates a new timestamp with the current date, with millisecond precision.
factory

Properties

hashCode int
The hash code for this object.
no setteroverride
nanoseconds int
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
seconds int
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
override

Operators

operator ==(Object other) bool
The equality operator.
override