Un Timestamp
représente un instant indépendant de tout fuseau horaire ou calendrier, représenté sous forme de secondes et de fractions de secondes à une résolution nanoseconde en heure UTC Epoch.
Il est codé à l'aide du calendrier grégorien proleptique qui étend le calendrier grégorien en arrière jusqu'à la première année. Il est codé en supposant que toutes les minutes durent 60 secondes, c'est-à-dire que les secondes intercalaires sont "étalées" de sorte qu'aucune table de secondes intercalaires n'est nécessaire pour l'interprétation. La plage va de 0001-01-01T00:00:00Z à 9999-12-31T23:59:59.999999999Z.
Pour des exemples et des spécifications supplémentaires, reportez-vous à la définition de l'horodatage. .
Signature:
export declare class Timestamp
Constructeurs
Constructeur | Modificateurs | Description |
---|---|---|
(constructeur)(secondes, nanosecondes) | Crée un nouvel horodatage. |
Propriétés
Propriété | Modificateurs | Taper | Description |
---|---|---|---|
nanosecondes | nombre | Les fractions de seconde à une résolution nanoseconde.* | |
secondes | nombre | Le nombre de secondes d'heure UTC depuis l'époque Unix 1970-01-01T00:00:00Z. |
Méthodes
Méthode | Modificateurs | Description |
---|---|---|
deDate(date) | static | Crée un nouvel horodatage à partir de la date donnée. |
deMillis(millisecondes) | static | Crée un nouvel horodatage à partir du nombre de millisecondes donné. |
est égal (autre) | Renvoie vrai si cet Timestamp est égal à celui fourni. | |
maintenant() | static | Crée un nouvel horodatage avec la date actuelle, avec une précision à la milliseconde. |
à ce jour() | Convertit un Timestamp en un objet Date JavaScript. Cette conversion entraîne une perte de précision puisque les objets Date ne prennent en charge qu'une précision en millisecondes. | |
versJSON() | Renvoie une représentation sérialisable JSON de ce Timestamp . | |
àMillis() | Convertit un Timestamp en un horodatage numérique (en millisecondes depuis l'époque). Cette opération entraîne une perte de précision. | |
àChaîne() | Renvoie une représentation textuelle de ce Timestamp . | |
valeur de() | Convertit cet objet en une chaîne primitive, ce qui permet de comparer les objets Timestamp à l'aide des opérateurs > , <= , >= et > . |
Horodatage. (constructeur)
Crée un nouvel horodatage.
Signature:
constructor(
seconds: number,
nanoseconds: number);
Paramètres
Paramètre | Taper | Description |
---|---|---|
secondes | nombre | Le nombre de secondes d'heure UTC depuis l'époque Unix 1970-01-01T00:00:00Z. Doit être du 0001-01-01T00:00:00Z au 9999-12-31T23:59:59Z inclus. |
nanosecondes | nombre | Les fractions non négatives d'une seconde à une résolution nanoseconde. Les valeurs de secondes négatives avec des fractions doivent toujours avoir des valeurs de nanosecondes non négatives qui comptent dans le temps. Doit être compris entre 0 et 999 999 999 inclus. |
Horodatage.nanosecondes
Les fractions de seconde à une résolution nanoseconde.*
Signature:
readonly nanoseconds: number;
Horodatage.secondes
Le nombre de secondes d'heure UTC depuis l'époque Unix 1970-01-01T00:00:00Z.
Signature:
readonly seconds: number;
Horodatage.fromDate()
Crée un nouvel horodatage à partir de la date donnée.
Signature:
static fromDate(date: Date): Timestamp;
Paramètres
Paramètre | Taper | Description |
---|---|---|
date | Date | La date à partir de laquelle initialiser l’ Timestamp . |
Retour:
Un nouvel Timestamp
représentant le même instant que la date donnée.
Horodatage.fromMillis()
Crée un nouvel horodatage à partir du nombre de millisecondes donné.
Signature:
static fromMillis(milliseconds: number): Timestamp;
Paramètres
Paramètre | Taper | Description |
---|---|---|
millisecondes | nombre | Nombre de millisecondes depuis l'époque Unix 1970-01-01T00:00:00Z. |
Retour:
Un nouvel Timestamp
représentant le même instant dans le temps que le nombre de millisecondes donné.
Horodatage.isEqual()
Renvoie vrai si cet Timestamp
est égal à celui fourni.
Signature:
isEqual(other: Timestamp): boolean;
Paramètres
Paramètre | Taper | Description |
---|---|---|
autre | Horodatage | L' Timestamp à comparer. |
Retour:
booléen
true si cet Timestamp
est égal à celui fourni.
Horodatage.now()
Crée un nouvel horodatage avec la date actuelle, avec une précision à la milliseconde.
Signature:
static now(): Timestamp;
Retour:
un nouvel horodatage représentant la date actuelle.
Horodatage.toDate()
Convertit un Timestamp
en un objet Date
JavaScript. Cette conversion entraîne une perte de précision puisque les objets Date
ne prennent en charge qu'une précision en millisecondes.
Signature:
toDate(): Date;
Retour:
Date
Objet Date
JavaScript représentant le même moment dans le temps que cet Timestamp
, avec une précision de la milliseconde.
Horodatage.toJSON()
Renvoie une représentation sérialisable JSON de cet Timestamp
.
Signature:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Retour:
{ secondes : nombre ; nanosecondes : nombre ; }
Horodatage.toMillis()
Convertit un Timestamp
en un horodatage numérique (en millisecondes depuis l'époque). Cette opération entraîne une perte de précision.
Signature:
toMillis(): number;
Retour:
nombre
Le moment correspondant à cet horodatage, représenté par le nombre de millisecondes depuis l'époque Unix 1970-01-01T00:00:00Z.
Horodatage.toString()
Renvoie une représentation textuelle de cet Timestamp
.
Signature:
toString(): string;
Retour:
chaîne
Horodatage.valueOf()
Convertit cet objet en une chaîne primitive, ce qui permet de comparer les objets Timestamp
à l'aide du >
, <=
, >=
et >
opérateurs.
Signature:
valueOf(): string;
Retour:
chaîne