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.

Timestamps are encoded using the Proleptic Gregorian Calendar, which extends the Gregorian calendar backwards to year one. Timestamps assume all minutes are 60 seconds long, i.e. leap seconds are 'smeared' so that no leap second table is needed for interpretation. Possible timestamp values range from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.

Implemented types

Comparable<Timestamp>

Available extensions

TekartikSembastTimestampExt

Constructors

Timestamp(int seconds, int nanoseconds): seconds is the number of seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive.
Timestamp.fromDateTime(DateTime dateTime): Creates a new Timestamp instance from the given date.
factory
Timestamp.fromMicrosecondsSinceEpoch(int microsecondsSinceEpoch): Constructs a new Timestamp instance with the given microsecondsSinceEpoch.
factory
Timestamp.fromMillisecondsSinceEpoch(int millisecondsSinceEpoch): Constructs a new Timestamp instance with the given millisecondsSinceEpoch.
factory
Timestamp.now(): Constructs a Timestamp instance with current date and time.
factory

Properties

hashCode → int: The hash code for this object.
no setteroverride
microsecondsSinceEpoch → int: The number of microseconds since the 'Unix epoch' 1970-01-01T00:00:00Z (UTC).
no setter
millisecondsSinceEpoch → int: The number of milliseconds since the 'Unix epoch' 1970-01-01T00:00:00Z (UTC).
no setter
nanoseconds → int: nanoseconds is the non-negative fractions of a second at nanosecond resolution.
final
runtimeType → Type: A representation of the runtime type of the object.
no setterinherited
seconds → int: seconds is the number of seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z.
final

Methods

addDuration(Duration duration) → Timestamp: Available on Timestamp, provided by the TekartikSembastTimestampExt extension
Add a duration to a timestamp
compareTo(Timestamp other) → int: Compares this object to another object.
override
difference(Timestamp other) → Duration: Available on Timestamp, provided by the TekartikSembastTimestampExt extension
Returns a Duration with the difference when subtracting other from this DateTime.
noSuchMethod(Invocation invocation) → dynamic: Invoked when a nonexistent method or property is accessed.
inherited
substractDuration(Duration duration) → Timestamp: Available on Timestamp, provided by the TekartikSembastTimestampExt extension
Substract a duration to a timestamp
toDateTime({bool? isUtc}) → DateTime: Convert a Timestamp to a DateTime object. This conversion causes a loss of precision and support millisecond precision.
toIso8601String() → String: Returns an ISO-8601 full-precision extended format representation. The format is yyyy-MM-ddTHH:mm:ss.mmmuuunnnZ nanoseconds and microseconds are omitted if null
toString() → String: A string representation of this object.
override

Operators

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

Static Properties

zero → Timestamp: The minimum representable Timestamp
final

Static Methods

parse(String text) → Timestamp: The function parses a subset of ISO 8601 which includes the subset accepted by RFC 3339.
tryAnyAsTimestamp(dynamic any) → Timestamp?: Try to get a Timestamp from either a DateTime, a Timestamp, a text or an int (ms since epoch)
tryParse(String? text) → Timestamp?: parse or returns null