Jump to top

Timestamp

interface

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.

Properties

nanoseconds

</>

The number of nanoseconds of this Timestamp;

nanoseconds: number;

seconds

</>

The number of seconds of this Timestamp.

seconds: number;

Methods

isEqual

</>

Returns true if this Timestamp is equal to the provided one.

isEqual(other: Timestamp): boolean;

toDate

</>

Convert a Timestamp to a JavaScript Date object. This conversion causes a loss of precision since Date objects only support millisecond precision.

toDate(): Date;

toMillis

</>

Convert a timestamp to a numeric timestamp (in milliseconds since epoch). This operation causes a loss of precision.

toMillis(): number;

fromDate

</>

Creates a new timestamp from the given JavaScript Date.

fromDate(date: Date): Timestamp;

fromMillis

</>

Creates a new timestamp from the given number of milliseconds.

fromMillis(milliseconds: number): Timestamp;

now

</>

Creates a new timestamp with the current date, with millisecond precision.

now(): Timestamp;