Constructor

Timestamp

new Timestamp(seconds, nanoseconds)

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.

Parameter

seconds

number

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.

nanoseconds

number

The non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanoseconds values that count forward in time. Must be from 0 to 999,999,999 inclusive.

See also
https://github.com/google/protobuf/blob/master/src/google/protobuf/timestamp.proto

Methods

fromDate

static

fromDate(date) returns firebase.firestore.Timestamp

Creates a new timestamp from the given date.

Parameter

date

Date

The date to initialize the Timestamp from.

Value must not be null.

Returns

non-null firebase.firestore.Timestamp A new Timestamp representing the same point in time as the given date.

fromMillis

static

fromMillis(milliseconds) returns firebase.firestore.Timestamp

Creates a new timestamp from the given number of milliseconds.

Parameter

milliseconds

number

Number of milliseconds since Unix epoch 1970-01-01T00:00:00Z.

Returns

non-null firebase.firestore.Timestamp A new Timestamp representing the same point in time as the given number of milliseconds.

now

static

now() returns firebase.firestore.Timestamp

Get the current time as a Timestamp object.

Returns

non-null firebase.firestore.Timestamp a new Timestamp.

toDate

toDate() returns Date

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

Returns

non-null Date a JavaScript date object.

toMillis

toMillis() returns number

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

Returns

non-null number a numeric timestamp.