Um carimbo de data/ Timestamp
representa um ponto no tempo independente de qualquer fuso horário ou calendário, representado como segundos e frações de segundos em resolução de nanossegundos no horário UTC Epoch.
É codificado usando o calendário gregoriano proléptico que estende o calendário gregoriano para trás até o ano um. Ele é codificado assumindo que todos os minutos têm 60 segundos de duração, ou seja, os segundos bissextos são "manchados" para que nenhuma tabela de segundos bissextos seja necessária para interpretação. O intervalo é de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59.999999999Z.
Para exemplos e especificações adicionais, 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 | Modelo | Descrição |
---|---|---|---|
nanossegundos | número | As frações de segundo em resolução de nanossegundos.* | |
segundos | número | 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 novo carimbo de data/hora a partir da data especificada. |
fromMilis(milissegundos) | static | Cria um novo carimbo de data/hora a partir do número de milissegundos fornecido. |
éigual(outro) | Retorna verdadeiro se este carimbo de data/ Timestamp for igual ao fornecido. | |
agora() | static | Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos. |
Até a presente data() | Converte um carimbo de data/ Timestamp em um objeto de Date JavaScript. Essa conversão causa uma perda de precisão, pois os objetos Date suportam apenas a precisão de milissegundos. | |
toJSON() | Retorna uma representação serializável em JSON deste carimbo de data/ Timestamp . | |
paraMillis() | Converte um carimbo de data/ Timestamp em um carimbo de data/hora numérico (em milissegundos desde a época). Esta operação causa uma perda de precisão. | |
para sequenciar() | Retorna uma representação textual deste carimbo de Timestamp . | |
valor de() | Converte este objeto em uma string primitiva, que permite que objetos Timestamp sejam comparados usando os operadores > , <= , >= e > . |
Carimbo de data/hora. (construtor)
Cria um novo carimbo de data/hora.
Assinatura:
constructor(
seconds: number,
nanoseconds: number);
Parâmetros
Parâmetro | Modelo | Descrição |
---|---|---|
segundos | número | O número de segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Deve ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z inclusive. |
nanossegundos | número | As frações não negativas de um segundo na resolução de nanossegundos. Valores de segundos negativos com frações ainda devem ter valores de nanossegundos não negativos que contam para frente no tempo. Deve ser de 0 a 999.999.999 inclusive. |
Timestamp.nanossegundos
As frações de segundo em resolução de nanossegundos.*
Assinatura:
readonly nanoseconds: number;
Timestamp.seconds
O número de segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z.
Assinatura:
readonly seconds: number;
Timestamp.fromDate()
Cria um novo carimbo de data/hora a partir da data especificada.
Assinatura:
static fromDate(date: Date): Timestamp;
Parâmetros
Parâmetro | Modelo | Descrição |
---|---|---|
encontro | Encontro | A data a partir da qual inicializar o carimbo de Timestamp . |
Devoluções:
Um novo carimbo de Timestamp
representando o mesmo momento que a data especificada.
Timestamp.fromMillis()
Cria um novo carimbo de data/hora a partir do número de milissegundos fornecido.
Assinatura:
static fromMillis(milliseconds: number): Timestamp;
Parâmetros
Parâmetro | Modelo | Descrição |
---|---|---|
milissegundos | número | Número de milissegundos desde a época Unix 1970-01-01T00:00:00Z. |
Devoluções:
Um novo carimbo de Timestamp
representando o mesmo ponto no tempo que o número de milissegundos fornecido.
Timestamp.isEqual()
Retorna verdadeiro se este carimbo de data/ Timestamp
for igual ao fornecido.
Assinatura:
isEqual(other: Timestamp): boolean;
Parâmetros
Parâmetro | Modelo | Descrição |
---|---|---|
outro | Carimbo de data e hora | O carimbo de Timestamp para comparar. |
Devoluções:
boleano
true se este carimbo de data/ Timestamp
for igual ao fornecido.
Carimbo de data/hora.agora()
Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos.
Assinatura:
static now(): Timestamp;
Devoluções:
um novo carimbo de data/hora representando a data atual.
Timestamp.toDate()
Converte um carimbo de data/ Timestamp
em um objeto de Date
JavaScript. Essa conversão causa uma perda de precisão, pois os objetos Date
suportam apenas a precisão de milissegundos.
Assinatura:
toDate(): Date;
Devoluções:
Encontro
Objeto JavaScript Date
representando o mesmo ponto no tempo que este carimbo de Timestamp
, com precisão de milissegundos.
Timestamp.toJSON()
Retorna uma representação serializável em JSON deste carimbo de data/ Timestamp
.
Assinatura:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Devoluções:
{ segundos: número; nanossegundos: número; }
Timestamp.toMillis()
Converte um carimbo de data/ Timestamp
em um carimbo de data/hora numérico (em milissegundos desde a época). Esta operação causa uma perda de precisão.
Assinatura:
toMillis(): number;
Devoluções:
número
O ponto no tempo correspondente a este carimbo de data/hora, representado como o número de milissegundos desde a época Unix 1970-01-01T00:00:00Z.
Timestamp.toString()
Retorna uma representação textual deste carimbo de Timestamp
.
Assinatura:
toString(): string;
Devoluções:
corda
Timestamp.valueOf()
Converte este objeto em uma string primitiva, que permite que objetos Timestamp
sejam comparados usando o >
, <=
, >=
e >
operadores.
Assinatura:
valueOf(): string;
Devoluções:
corda