Timestamp class

Um Timestamp representa um ponto no tempo independente de qualquer fuso horário ou calendário, representado como segundos e frações de segundos na resolução de nanossegundos no horário UTC da época.

Ele é codificado usando o calendário gregoriano proléptico, que estende o calendário gregoriano de volta para o primeiro ano. Essa codificação supõe que todos os minutos tenham 60 segundos de duração, ou seja, segundos bissextos são "indistinguíveis", assim não é preciso ter uma tabela de segundos adicionais para interpretação. O intervalo varia de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59.999999999Z.

Para exemplos e outras especificações, consulte a Definição de carimbo de data/hora.

Assinatura:

export declare class Timestamp 

Construtores

Construtor Modificadores Descrição
(construtor)(segundos, nanossegundos) Cria um novo carimbo de data/hora.

Propriedades

Propriedade Modificadores Tipo Descrição
nanossegundos number As frações de segundo na resolução de nanossegundos.*
segundos number O número de segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z.

Métodos

Método Modificadores Descrição
fromDate(data) static Cria um carimbo de data/hora a partir da data especificada.
fromMillis(milissegundos) static Cria um novo carimbo de data/hora a partir do número fornecido de milissegundos.
isEqual(outro) Retorna "true" se esse Timestamp é igual ao fornecido.
now() (em inglês). static Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos.
toDate() (em inglês) Converte um Timestamp em um objeto JavaScript Date. Essa conversão causa uma perda de precisão, já que os objetos Date são compatíveis apenas com a precisão de milissegundos.
toJSON() (link em inglês) Retorna uma representação serializável do JSON desse Timestamp.
toMillis() (em inglês) Converte um Timestamp em um carimbo de data/hora numérico (em milissegundos desde a época). Essa operação causa uma perda de precisão.
toString(). Retorna uma representação textual desse Timestamp.
valueOf() (em inglês). Converte esse objeto em uma string primitiva, o que permite que objetos Timestamp sejam comparados usando os operadores >, <=, >= e >.

Timestamp.(construtor)

Cria um novo carimbo de data/hora.

Assinatura:

constructor(
    seconds: number, 
    nanoseconds: number);

Parâmetros

Parâmetro Tipo Descrição
segundos number O número de segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z.
nanossegundos number As frações não negativas de um segundo na resolução de nanossegundos. Valores de segundos negativos com frações ainda precisam ter valores de nanossegundos não negativos que contam progressivamente no tempo. O valor precisa ser de 0 a 999.999.999 (inclusive).

Timestamp.nanoseconds

As frações de segundo na resolução de nanossegundos.*

Assinatura:

readonly nanoseconds: number;

Carimbo de data/hora em segundos

O número de segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z.

Assinatura:

readonly seconds: number;

Carimbo de data/hora.fromDate()

Cria um carimbo de data/hora a partir da data especificada.

Assinatura:

static fromDate(date: Date): Timestamp;

Parâmetros

Parâmetro Tipo Descrição
data Data A data a partir da qual a Timestamp será inicializada.

Retorna:

Carimbo de data/hora

Uma nova Timestamp que representa o mesmo ponto no tempo da data especificada.

Carimbo de data/hora.fromMillis()

Cria um novo carimbo de data/hora a partir do número fornecido de milissegundos.

Assinatura:

static fromMillis(milliseconds: number): Timestamp;

Parâmetros

Parâmetro Tipo Descrição
milésimos de segundo number Número de milissegundos desde a época Unix 1970-01-01T00:00:00Z.

Retorna:

Carimbo de data/hora

Um novo Timestamp que representa o mesmo ponto no tempo que o número fornecido de milissegundos.

Timestamp.isEqual()

Retorna "true" se esse Timestamp é igual ao fornecido.

Assinatura:

isEqual(other: Timestamp): boolean;

Parâmetros

Parâmetro Tipo Descrição
outro Carimbo de data/hora O Timestamp para comparação.

Retorna:

booleano

verdadeiro se este Timestamp for igual ao fornecido.

Timestamp.now()

Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos.

Assinatura:

static now(): Timestamp;

Retorna:

Carimbo de data/hora

um novo carimbo de data/hora que representa a data atual.

Carimbo de data/hora.toDate()

Converte um Timestamp em um objeto JavaScript Date. Essa conversão causa uma perda de precisão, já que os objetos Date são compatíveis apenas com a precisão de milissegundos.

Assinatura:

toDate(): Date;

Retorna:

Data

Objeto JavaScript Date que representa o mesmo ponto no tempo que esse Timestamp, com precisão de milissegundos.

Carimbo de data/hora.toJSON()

Retorna uma representação serializável do JSON desse Timestamp.

Assinatura:

toJSON(): {
        seconds: number;
        nanoseconds: number;
    };

Retorna:

{ seconds: number; nanossegundos: número; }

Carimbo de data/hora.toMillis()

Converte um Timestamp em um carimbo de data/hora numérico (em milissegundos desde a época). Essa operação causa uma perda de precisão.

Assinatura:

toMillis(): number;

Retorna:

number

O ponto no tempo correspondente a esse carimbo de data/hora, representado como o número de milissegundos desde a época Unix 1970-01-01T00:00:00Z.

Carimbo de data/hora.toString()

Retorna uma representação textual desse Timestamp.

Assinatura:

toString(): string;

Retorna:

string

Carimbo de data/hora.valueOf()

Converte esse objeto em uma string primitiva, o que permite que objetos Timestamp sejam comparados usando os operadores >, <=, >= e >.

Assinatura:

valueOf(): string;

Retorna:

string