Timestamp class

Un Timestamp representa un punto en el tiempo independiente de cualquier zona horaria o calendario, representado como segundos y fracciones de segundos a una resolución de nanosegundos en tiempo de época UTC.

Se codifica mediante el calendario gregoriano proléptico, que extiende el calendario gregoriano hasta el año uno. Se codifica mediante la suposición de que todos los minutos duran 60 segundos, es decir, los segundos bisiestos se “extienden” a fin de que no se necesite una segunda tabla bisiesta 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, consulta la definición de marca de tiempo.

Firma:

export declare class Timestamp 

Constructores

Constructor Teclas modificadoras Descripción
(constructor)(segundos, nanosegundos) Crea una marca de tiempo nueva.

Propiedades

Propiedad Teclas modificadoras Tipo Descripción
nanosegundos número Las fracciones de un segundo a una resolución de nanosegundos.*
segundos número El número de segundos de la hora UTC desde la época Unix 1970-01-01T00:00:00Z.

Métodos

Método Teclas modificadoras Descripción
desdeFecha(fecha) static Crea una marca de tiempo nueva a partir de la fecha especificada.
fromMillis(milisegundos) static Crea una marca de tiempo nueva a partir de la cantidad de milisegundos especificada.
esIgual(otro) Muestra true si este Timestamp es igual al proporcionado.
now() static Crea una marca de tiempo nueva con la fecha actual, con precisión de milisegundos.
toDate() Convierte un Timestamp en un objeto Date de JavaScript. Esta conversión causa una pérdida de precisión, ya que los objetos Date solo admiten precisión en milisegundos.
toJSON() Muestra una representación JSON serializable de este Timestamp.
toMillis() Convierte un elemento Timestamp en una marca de tiempo numérica (en milisegundos desde el ciclo de entrenamiento). Esta operación provoca una pérdida de precisión.
toString(). Muestra una representación textual de este Timestamp.
valueOf() Convierte este objeto en una cadena básica, lo que permite comparar objetos Timestamp con los operadores >, <=, >= y >.

Marca de tiempo.(constructor)

Crea una marca de tiempo nueva.

Firma:

constructor(
    seconds: number, 
    nanoseconds: number);

Parámetros

Parámetro Tipo Descripción
segundos número El número de segundos de la hora UTC desde la época Unix 1970-01-01T00:00:00Z. Debe ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z inclusive.
nanosegundos número Fracciones no negativas de un segundo a una resolución de nanosegundos. Los valores de segundos negativos con fracciones deben tener valores de nanosegundos no negativos que cuenten a futuro en el tiempo. Debe ser de 0 a 999,999,999 inclusive.

Marca de tiempo.nanosegundos

Las fracciones de un segundo a una resolución de nanosegundos.*

Firma:

readonly nanoseconds: number;

Segundos de marca de tiempo

El número de segundos de la hora UTC desde la época Unix 1970-01-01T00:00:00Z.

Firma:

readonly seconds: number;

Marca de tiempo.desdeFecha()

Crea una marca de tiempo nueva a partir de la fecha especificada.

Firma:

static fromDate(date: Date): Timestamp;

Parámetros

Parámetro Tipo Descripción
fecha Fecha Es la fecha desde la que se inicializa Timestamp.

Muestra:

Marca de tiempo

Una Timestamp nueva que representa la misma hora que la fecha especificada

Marca de tiempo.deMillis()

Crea una marca de tiempo nueva a partir de la cantidad de milisegundos especificada.

Firma:

static fromMillis(milliseconds: number): Timestamp;

Parámetros

Parámetro Tipo Descripción
milésimas de segundo número Cantidad de milisegundos desde la época Unix 1970-01-01T00:00:00Z.

Muestra:

Marca de tiempo

Una nueva Timestamp que representa el mismo momento que la cantidad determinada de milisegundos

Marca de tiempo.isEqual()

Muestra true si este Timestamp es igual al proporcionado.

Firma:

isEqual(other: Timestamp): boolean;

Parámetros

Parámetro Tipo Descripción
otro Marca de tiempo El objeto Timestamp con el que se comparará.

Muestra:

booleano

true si este Timestamp es igual al proporcionado.

Marca de tiempo.now()

Crea una marca de tiempo nueva con la fecha actual, con precisión de milisegundos.

Firma:

static now(): Timestamp;

Muestra:

Marca de tiempo

una nueva marca de tiempo que representa la fecha actual.

Marca de tiempo.toDate()

Convierte un Timestamp en un objeto Date de JavaScript. Esta conversión causa una pérdida de precisión, ya que los objetos Date solo admiten precisión en milisegundos.

Firma:

toDate(): Date;

Muestra:

Fecha

El objeto Date de JavaScript que representa el mismo momento que este Timestamp, con precisión de milisegundos.

Marca de tiempo.toJSON()

Muestra una representación JSON serializable de este Timestamp.

Firma:

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

Muestra:

{ segundos: número; nanosegundos: número; }.

Marca de tiempo.toMillis()

Convierte un elemento Timestamp en una marca de tiempo numérica (en milisegundos desde el ciclo de entrenamiento). Esta operación provoca una pérdida de precisión.

Firma:

toMillis(): number;

Muestra:

número

El punto en el tiempo que corresponde a esta marca de tiempo, representado como el número de milisegundos desde el tiempo Unix 1970-01-01T00:00:00Z.

Marca de tiempo.toString()

Muestra una representación textual de este Timestamp.

Firma:

toString(): string;

Muestra:

string

Timestamp.valueOf()

Convierte este objeto en una cadena básica, lo que permite comparar objetos Timestamp con los operadores >, <=, >= y >.

Firma:

valueOf(): string;

Muestra:

string