Timestamp class

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

Implemented types

Constructors

Timestamp(int seconds, int nanoseconds)
Creates a Timestamp
Timestamp.fromMicrosecondsSinceEpoch(int microsecondsSinceEpoch)
Create a Timestamp fromMicrosecondsSinceEpoch
factory
Timestamp.fromMillisecondsSinceEpoch(int millisecondsSinceEpoch)
Create a Timestamp fromMillisecondsSinceEpoch
factory
Timestamp.now()
Create a Timestamp from DateTime.now
factory
Timestamp.utc(int year, [int month = 1, int day = 1, int hour = 0, int minute = 0, int second = 0, int millisecond = 0, int microsecond = 0])
Create a Timestamp from DateTime.utc
factory

Properties

date DateTime
Converts Timestamp to DateTime
no setter
hashCode int
The hash code for this object.
no setteroverride
microsecondsSinceEpoch int
no setter
millisecondsSinceEpoch int
no setter
nanoseconds int
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
seconds int
final

Methods

compareTo(Timestamp other) int
Compares this object to another object.
override
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

Static Methods

parse(String formattedString) Timestamp
Create a Timestamp from DateTime.parse
tryParse(String formattedString) Timestamp?
Create a Timestamp from DateTime.tryParse