Una Timestamp de tiempo 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 suponiendo que todos los minutos tienen una duración de 60 segundos, es decir, los segundos intercalares están "difuminados" 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 ver ejemplos y más especificaciones, 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 | Escribe | Descripción |
|---|---|---|---|
| nanosegundos | número | Las fracciones de segundo a resolución de nanosegundos.* | |
| segundos | número | El número de segundos de tiempo UTC desde la época de Unix 1970-01-01T00:00:00Z. |
Métodos
| Método | modificadores | Descripción |
|---|---|---|
| fromDate(fecha) | static | Crea una nueva marca de tiempo a partir de la fecha dada. |
| fromMillis(milisegundos) | static | Crea una nueva marca de tiempo a partir del número dado de milisegundos. |
| esIgual(otro) | Devuelve verdadero si esta Timestamp de tiempo 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 de tiempo en un objeto de Date de JavaScript. Esta conversión provoca una pérdida de precisión, ya que los objetos de Date solo admiten una precisión de milisegundos. | |
| aJSON() | Devuelve una representación JSON serializable de esta Timestamp de tiempo. | |
| toMillis() | Convierte una Timestamp de tiempo 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 de tiempo. | |
| valor de() | Convierte este objeto en una cadena primitiva, lo que permite Timestamp objetos de marca de tiempo mediante los operadores > , <= , >= y > . |
Marca de tiempo.(constructor)
Crea una nueva marca de tiempo.
Firma:
constructor(
seconds: number,
nanoseconds: number);
Parámetros
| Parámetro | Escribe | Descripción |
|---|---|---|
| segundos | número | El número de segundos de tiempo 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 no negativas de un segundo a 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 resolución de nanosegundos.*
Firma:
readonly nanoseconds: number;
Marca de tiempo.segundos
El número de segundos de tiempo UTC desde la época de Unix 1970-01-01T00:00:00Z.
Firma:
readonly seconds: number;
Marca de tiempo.fromDate()
Crea una nueva marca de tiempo a partir de la fecha dada.
Firma:
static fromDate(date: Date): Timestamp;
Parámetros
| Parámetro | Escribe | Descripción |
|---|---|---|
| fecha | Fecha | La fecha desde la que inicializar la Timestamp de tiempo. |
Devoluciones:
Una nueva Timestamp de tiempo que representa el mismo punto en el tiempo que la fecha dada.
Marca de tiempo.fromMillis()
Crea una nueva marca de tiempo a partir del número dado de milisegundos.
Firma:
static fromMillis(milliseconds: number): Timestamp;
Parámetros
| Parámetro | Escribe | Descripción |
|---|---|---|
| milisegundos | número | Número de milisegundos desde la época de Unix 1970-01-01T00:00:00Z. |
Devoluciones:
Una nueva Timestamp de tiempo que representa el mismo punto en el tiempo que el número dado de milisegundos.
Marca de tiempo.isEqual()
Devuelve verdadero si esta Timestamp de tiempo es igual a la proporcionada.
Firma:
isEqual(other: Timestamp): boolean;
Parámetros
| Parámetro | Escribe | Descripción |
|---|---|---|
| otro | marca de tiempo | La Timestamp de tiempo con la que comparar. |
Devoluciones:
booleano
true si esta Timestamp de tiempo 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 de tiempo en un objeto de Date de JavaScript. Esta conversión provoca una pérdida de precisión, ya que los objetos de Date solo admiten una precisión de milisegundos.
Firma:
toDate(): Date;
Devoluciones:
Fecha
Objeto de Date de JavaScript que representa el mismo punto en el tiempo que esta Timestamp de tiempo , con precisión de milisegundos.
Marca de tiempo.toJSON()
Devuelve una representación JSON serializable de esta Timestamp de tiempo .
Firma:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Devoluciones:
{ segundos: número; nanosegundos: número; }
Marca de tiempo.toMillis()
Convierte una Timestamp de tiempo 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 punto en el tiempo 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 de tiempo .
Firma:
toString(): string;
Devoluciones:
cuerda
Marca de tiempo.valueOf()
Convierte este objeto en una cadena primitiva, lo que permite que los objetos de Timestamp de tiempo se comparen usando el > , <= , >= y > operadores.
Firma:
valueOf(): string;
Devoluciones:
cuerda