Una Timestamp representa un punto en el tiempo independiente de cualquier zona horaria o calendario, representado como segundos y fracciones de segundos con una resolución de nanosegundos en la época UTC.
Está codificado utilizando el Calendario Gregoriano Proléptico que extiende el calendario gregoriano hacia atrás hasta el año uno. Se codifica asumiendo que todos los minutos tienen una duración de 60 segundos, es decir, los segundos intercalares están "borrados" de modo que no se necesita una tabla de segundos intercalares para la interpretación. El rango es de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59.999999999Z.
Para obtener ejemplos y especificaciones adicionales, consulte la definición de marca de tiempo. .
Firma:
export declare class Timestamp
Constructores
| Constructor | Modificadores | Descripción |
|---|---|---|
| (constructor)(segundos, nanosegundos) | Crea una nueva marca de tiempo. |
Propiedades
| Propiedad | Modificadores | Tipo | Descripción |
|---|---|---|---|
| nanosegundos | número | Las fracciones de segundo a una resolución de nanosegundos.* | |
| segundos | número | El número de segundos de hora UTC desde la época de Unix 1970-01-01T00:00:00Z. |
Métodos
| Método | Modificadores | Descripción |
|---|---|---|
| desde fecha (fecha) | static | Crea una nueva marca de tiempo a partir de la fecha indicada. |
| desdeMillis(milisegundos) | static | Crea una nueva marca de tiempo a partir del número dado de milisegundos. |
| es igual (otro) | Devuelve verdadero si esta Timestamp es igual a la proporcionada. | |
| ahora() | static | Crea una nueva marca de tiempo con la fecha actual, con precisión de milisegundos. |
| hasta la fecha() | Convierte una Timestamp en un objeto Date de JavaScript. Esta conversión provoca una pérdida de precisión ya que los objetos Date solo admiten precisión de milisegundos. | |
| a JSON() | Devuelve una representación serializable en JSON de esta Timestamp . | |
| aMillis() | Convierte una Timestamp en una marca de tiempo numérica (en milisegundos desde la época). Esta operación provoca una pérdida de precisión. | |
| Encadenar() | Devuelve una representación textual de esta Timestamp . | |
| valor de() | Convierte este objeto en una cadena primitiva, lo que permite comparar objetos Timestamp utilizando los operadores > , <= , >= y > . |
Marca de tiempo.(constructor)
Crea una nueva marca de tiempo.
Firma:
constructor(
seconds: number,
nanoseconds: number);
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| segundos | número | El número de segundos de hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe ser desde 0001-01-01T00:00:00Z hasta 9999-12-31T23:59:59Z inclusive. |
| nanosegundos | número | Las fracciones de segundo no negativas a una resolución de nanosegundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanosegundos no negativos que cuenten hacia adelante en el tiempo. Debe ser de 0 a 999.999.999 inclusive. |
Marca de tiempo.nanosegundos
Las fracciones de segundo a una resolución de nanosegundos.*
Firma:
readonly nanoseconds: number;
Marca de tiempo.segundos
El número de segundos de hora UTC desde la época de Unix 1970-01-01T00:00:00Z.
Firma:
readonly seconds: number;
Marca de tiempo.desde la fecha()
Crea una nueva marca de tiempo a partir de la fecha indicada.
Firma:
static fromDate(date: Date): Timestamp;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| fecha | Fecha | La fecha desde la que inicializar la Timestamp . |
Devoluciones:
Una nueva Timestamp que representa el mismo momento que la fecha indicada.
Marca de tiempo.deMillis()
Crea una nueva marca de tiempo a partir del número dado de milisegundos.
Firma:
static fromMillis(milliseconds: number): Timestamp;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| milisegundos | número | Número de milisegundos desde la época de Unix 1970-01-01T00:00:00Z. |
Devoluciones:
Una nueva Timestamp que representa el mismo momento que el número de milisegundos dado.
Marca de tiempo.isEqual()
Devuelve verdadero si esta Timestamp es igual a la proporcionada.
Firma:
isEqual(other: Timestamp): boolean;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| otro | Marca de tiempo | La Timestamp con la que comparar. |
Devoluciones:
booleano
Es cierto si esta Timestamp es igual a la proporcionada.
Marca de tiempo.ahora()
Crea una nueva marca de tiempo con la fecha actual, con precisión de milisegundos.
Firma:
static now(): Timestamp;
Devoluciones:
una nueva marca de tiempo que representa la fecha actual.
Marca de tiempo.toDate()
Convierte una Timestamp en un objeto Date de JavaScript. Esta conversión provoca una pérdida de precisión ya que los objetos Date solo admiten precisión de milisegundos.
Firma:
toDate(): Date;
Devoluciones:
Fecha
Objeto Date de JavaScript que representa el mismo momento que esta Timestamp , con precisión de milisegundos.
Marca de tiempo.toJSON()
Devuelve una representación serializable en JSON de esta Timestamp .
Firma:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Devoluciones:
{ segundos: número; nanosegundos: número; }
Marca de tiempo.toMillis()
Convierte una Timestamp en una marca de tiempo numérica (en milisegundos desde la época). Esta operación provoca una pérdida de precisión.
Firma:
toMillis(): number;
Devoluciones:
número
El momento correspondiente a esta marca de tiempo, representado como el número de milisegundos desde la época de Unix 1970-01-01T00:00:00Z.
Marca de tiempo.toString()
Devuelve una representación textual de esta Timestamp .
Firma:
toString(): string;
Devoluciones:
cadena
Marca de tiempo.valorDe()
Convierte este objeto en una cadena primitiva, que permite comparar objetos Timestamp usando > , <= , >= y > operadores.
Firma:
valueOf(): string;
Devoluciones:
cadena