Timestamp

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.

For examples and further specifications, refer to the Timestamp definition.

class Timestamp {

constructor(seconds: number, nanoseconds: number);

readonly nanoseconds: number;

readonly seconds: number;

isEqual(other: Timestamp): boolean;

toDate(): Date;

toJSON(): {

seconds: number;

nanoseconds: number;

type: string;

};

toMillis(): number;

toString(): string;

valueOf(): string;

static fromDate(date: Date): Timestamp;

static fromJSON(json: object): Timestamp;

static fromMillis(milliseconds: number): Timestamp;

static now(): Timestamp;

}

§Constructors

new Timestamp(seconds: number, nanoseconds: number)

[src]

Creates a new timestamp.

@param seconds

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.

@param nanoseconds

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.

§Properties

nanoseconds: number

[src]

The fractions of a second at nanosecond resolution.*

seconds: number

[src]

The number of seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z.

§Methods

isEqual(other: Timestamp): boolean

[src]

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

@param other

The Timestamp to compare against.

@return

true if this Timestamp is equal to the provided one.

toDate(): Date

[src]

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

@return

JavaScript Date object representing the same point in time as this Timestamp, with millisecond precision.

toJSON(): {

seconds: number;

nanoseconds: number;

type: string;

}

[src]

Returns a JSON-serializable representation of this Timestamp.

toMillis(): number

[src]

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