Un Timestamp rappresenta un punto nel tempo indipendente da qualsiasi fuso orario o calendario, rappresentato come secondi e frazioni di secondo con una risoluzione di nanosecondi nell'epoca UTC.
È codificato utilizzando il calendario gregoriano prolettico che estende il calendario gregoriano all'anno uno. Viene codificato presupponendo che tutti i minuti durino 60 secondi, ovvero i secondi intercalari vengono "spalmati" in modo che non sia necessaria alcuna tabella dei secondi intercalari per l'interpretazione. L'intervallo è compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59.999999999Z.
Per esempi e ulteriori specificazioni fare riferimento alla definizione Timestamp .
Firma:
export declare class Timestamp
Costruttori
| Costruttore | Modificatori | Descrizione |
|---|---|---|
| (costruttore)(secondi, nanosecondi) | Crea un nuovo timestamp. |
Proprietà
| Proprietà | Modificatori | Tipo | Descrizione |
|---|---|---|---|
| nanosecondi | numero | Le frazioni di secondo con risoluzione nanosecondo.* | |
| secondi | numero | Il numero di secondi dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. |
Metodi
| Metodo | Modificatori | Descrizione |
|---|---|---|
| daData(data) | static | Crea un nuovo timestamp dalla data specificata. |
| daMilli(millisecondi) | static | Crea un nuovo timestamp dal numero specificato di millisecondi. |
| èUguale(altro) | Restituisce vero se questo Timestamp è uguale a quello fornito. | |
| Ora() | static | Crea un nuovo timestamp con la data corrente, con precisione al millisecondo. |
| ad oggi() | Converte un Timestamp in un oggetto Date JavaScript. Questa conversione provoca una perdita di precisione poiché gli oggetti Date supportano solo la precisione al millisecondo. | |
| aJSON() | Restituisce una rappresentazione serializzabile JSON di questo Timestamp . | |
| aMillis() | Converte un Timestamp in un timestamp numerico (in millisecondi dall'epoca). Questa operazione provoca una perdita di precisione. | |
| accordare() | Restituisce una rappresentazione testuale di questo Timestamp . | |
| valore di() | Converte questo oggetto in una stringa primitiva, che consente il confronto degli oggetti Timestamp utilizzando gli operatori > , <= , >= e > . |
Timestamp.(costruttore)
Crea un nuovo timestamp.
Firma:
constructor(
seconds: number,
nanoseconds: number);
Parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| secondi | numero | Il numero di secondi dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z compreso. |
| nanosecondi | numero | Le frazioni non negative di secondo con risoluzione nanosecondo. I valori di secondo negativi con le frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi. |
Timestamp.nanosecondi
Le frazioni di secondo con risoluzione nanosecondo.*
Firma:
readonly nanoseconds: number;
Timestamp.secondi
Il numero di secondi di tempo UTC dall'epoca Unix 1970-01-01T00:00:00Z.
Firma:
readonly seconds: number;
Timestamp.fromDate()
Crea un nuovo timestamp dalla data specificata.
Firma:
static fromDate(date: Date): Timestamp;
Parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| data | Data | La data da cui inizializzare il Timestamp . |
Ritorna:
Un nuovo Timestamp che rappresenta lo stesso momento della data specificata.
Timestamp.fromMillis()
Crea un nuovo timestamp dal numero specificato di millisecondi.
Firma:
static fromMillis(milliseconds: number): Timestamp;
Parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| millisecondi | numero | Numero di millisecondi dall'epoca Unix 1970-01-01T00:00:00Z. |
Ritorna:
Un nuovo Timestamp che rappresenta lo stesso punto nel tempo del numero specificato di millisecondi.
Timestamp.isEqual()
Restituisce vero se questo Timestamp è uguale a quello fornito.
Firma:
isEqual(other: Timestamp): boolean;
Parametri
| Parametro | Tipo | Descrizione |
|---|---|---|
| altro | Timestamp | Il Timestamp con cui effettuare il confronto. |
Ritorna:
booleano
true se questo Timestamp è uguale a quello fornito.
Timestamp.now()
Crea un nuovo timestamp con la data corrente, con precisione al millisecondo.
Firma:
static now(): Timestamp;
Ritorna:
un nuovo timestamp che rappresenta la data corrente.
Timestamp.toDate()
Converte un Timestamp in un oggetto Date JavaScript. Questa conversione provoca una perdita di precisione poiché gli oggetti Date supportano solo la precisione al millisecondo.
Firma:
toDate(): Date;
Ritorna:
Data
Oggetto Date JavaScript che rappresenta lo stesso momento temporale di questo Timestamp , con precisione al millisecondo.
Timestamp.toJSON()
Restituisce una rappresentazione serializzabile JSON di questo Timestamp .
Firma:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Ritorna:
{ secondi: numero; nanosecondi: numero; }
Timestamp.toMillis()
Converte un Timestamp in un timestamp numerico (in millisecondi dall'epoca). Questa operazione provoca una perdita di precisione.
Firma:
toMillis(): number;
Ritorna:
numero
Il momento corrispondente a questo timestamp, rappresentato come il numero di millisecondi dall'epoca Unix 1970-01-01T00:00:00Z.
Timestamp.toString()
Restituisce una rappresentazione testuale di questo Timestamp .
Firma:
toString(): string;
Ritorna:
corda
Timestamp.valoreOf()
Converte questo oggetto in una stringa primitiva, che consente di confrontare gli oggetti Timestamp utilizzando > , <= , >= e > operatori.
Firma:
valueOf(): string;
Ritorna:
corda