Um Timestamp representa um ponto no tempo independente de qualquer fuso horário ou calendário, representado como segundos e frações de segundos com 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 primeiro ano. Ele é codificado assumindo que todos os minutos têm 60 segundos de duração, ou seja, os segundos bissextos são "borrados" de modo que nenhuma tabela de segundos bissextos é 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 | Tipo | Descrição |
|---|---|---|---|
| nanossegundos | número | As frações de segundo com 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 |
|---|---|---|
| deData(data) | static | Cria um novo carimbo de data/hora a partir da data especificada. |
| fromMillis(milissegundos) | static | Cria um novo carimbo de data/hora a partir de um determinado número de milissegundos. |
| éIgual(outro) | Retorna verdadeiro se este Timestamp for igual ao fornecido. | |
| agora() | static | Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos. |
| a data() | Converte um Timestamp em um objeto JavaScript Date . Essa conversão causa uma perda de precisão, pois os objetos Date suportam apenas a precisão de milissegundos. | |
| paraJSON() | Retorna uma representação serializável JSON deste Timestamp . | |
| paraMillis() | Converte um Timestamp em um carimbo de data/hora numérico (em milissegundos desde a época). Esta operação causa perda de precisão. | |
| para sequenciar() | Retorna uma representação textual deste 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 | Tipo | 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 com 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. |
Carimbo de data/hora.nanossegundos
As frações de segundo com resolução de nanossegundos.*
Assinatura:
readonly nanoseconds: number;
Carimbo de data/hora.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 novo 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 de inicialização do Timestamp de data/hora. |
Retorna:
Um novo Timestamp representando o mesmo momento da data especificada.
Carimbo de data/hora.fromMillis()
Cria um novo carimbo de data/hora a partir de um determinado número de milissegundos.
Assinatura:
static fromMillis(milliseconds: number): Timestamp;
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| milissegundos | número | Número de milissegundos desde a época Unix 1970-01-01T00:00:00Z. |
Retorna:
Um novo Timestamp representando o mesmo momento que o número determinado de milissegundos.
Carimbo de data/hora.isEqual()
Retorna verdadeiro se este Timestamp for igual ao fornecido.
Assinatura:
isEqual(other: Timestamp): boolean;
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| outro | Carimbo de data e hora | O Timestamp com o qual comparar. |
Retorna:
boleano
true se este Timestamp for igual ao fornecido.
Carimbo de data e hora.agora()
Cria um novo carimbo de data/hora com a data atual, com precisão de milissegundos.
Assinatura:
static now(): Timestamp;
Retorna:
um novo carimbo de data/hora representando 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, pois os objetos Date suportam apenas a precisão de milissegundos.
Assinatura:
toDate(): Date;
Retorna:
Data
Objeto JavaScript Date que representa o mesmo momento que este Timestamp , com precisão de milissegundos.
Carimbo de data/hora.toJSON()
Retorna uma representação serializável JSON deste Timestamp .
Assinatura:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Retorna:
{ segundos: número; nanossegundos: número; }
Carimbo de data/hora.toMillis()
Converte um Timestamp em um carimbo de data/hora numérico (em milissegundos desde a época). Esta operação causa perda de precisão.
Assinatura:
toMillis(): number;
Retorna:
número
O momento 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 deste Timestamp .
Assinatura:
toString(): string;
Retorna:
corda
Carimbo de data/hora.valueOf()
Converte este objeto em uma string primitiva, que permite que objetos Timestamp sejam comparados usando o > , <= , >= e > operadores.
Assinatura:
valueOf(): string;
Retorna:
corda