Ein Timestamp
stellt einen Zeitpunkt unabhängig von einer Zeitzone oder einem Kalender dar und wird als Sekunden und Bruchteile von Sekunden mit einer Auflösung von Nanosekunden in der UTC-Epochenzeit dargestellt.
Es wird mit dem Proleptischen Gregorianischen Kalender kodiert, der den Gregorianischen Kalender rückwärts bis zum ersten Jahr erweitert. Die Codierung erfolgt unter der Annahme, dass alle Minuten 60 Sekunden lang sind, dh Schaltsekunden werden „verschmiert“, sodass für die Interpretation keine Schaltsekundentabelle erforderlich ist. Der Bereich reicht von 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59.999999999Z.
Beispiele und weitere Spezifikationen finden Sie in der Timestamp-Definition .
Unterschrift:
export declare class Timestamp
Konstrukteure
Konstrukteur | Modifikatoren | Beschreibung |
---|---|---|
(Konstruktor)(Sekunden, Nanosekunden) | Erstellt einen neuen Zeitstempel. |
Eigenschaften
Eigentum | Modifikatoren | Typ | Beschreibung |
---|---|---|---|
Nanosekunden | Nummer | Die Bruchteile einer Sekunde in Nanosekunden-Auflösung.* | |
Sekunden | Nummer | Die Anzahl der Sekunden der UTC-Zeit seit der Unix-Epoche 1970-01-01T00:00:00Z. |
Methoden
Methode | Modifikatoren | Beschreibung |
---|---|---|
fromDate(Datum) | static | Erstellt einen neuen Zeitstempel ab dem angegebenen Datum. |
fromMillis(Millisekunden) | static | Erstellt einen neuen Zeitstempel aus der angegebenen Anzahl von Millisekunden. |
isEqual(andere) | Gibt „true“ zurück, wenn dieser Timestamp mit dem angegebenen übereinstimmt. | |
Jetzt() | static | Erstellt einen neuen Zeitstempel mit dem aktuellen Datum, mit Millisekundengenauigkeit. |
miteinander ausgehen() | Konvertiert einen Timestamp in ein JavaScript- Date . Diese Konvertierung führt zu einem Präzisionsverlust, da Date nur eine Präzision im Millisekundenbereich unterstützen. | |
toJSON() | Gibt eine JSON-serialisierbare Darstellung dieses Timestamp zurück. | |
toMillis() | Konvertiert einen Timestamp in einen numerischen Zeitstempel (in Millisekunden seit der Epoche). Dieser Vorgang führt zu einem Präzisionsverlust. | |
toString() | Gibt eine Textdarstellung dieses Timestamp zurück. | |
Wert von() | Konvertiert dieses Objekt in eine primitive Zeichenfolge, die den Vergleich von Timestamp mit den Operatoren > , <= , >= und > ermöglicht. |
Zeitstempel.(Konstruktor)
Erstellt einen neuen Zeitstempel.
Unterschrift:
constructor(
seconds: number,
nanoseconds: number);
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Sekunden | Nummer | Die Anzahl der Sekunden der UTC-Zeit seit der Unix-Epoche 1970-01-01T00:00:00Z. Muss zwischen 0001-01-01T00:00:00Z und 9999-12-31T23:59:59Z liegen. |
Nanosekunden | Nummer | Die nichtnegativen Bruchteile einer Sekunde mit Nanosekundenauflösung. Negative Sekundenwerte mit Brüchen müssen weiterhin nicht negative Nanosekundenwerte haben, die zeitlich vorwärts zählen. Muss zwischen 0 und 999.999.999 liegen. |
Zeitstempel.Nanosekunden
Die Bruchteile einer Sekunde in Nanosekunden-Auflösung.*
Unterschrift:
readonly nanoseconds: number;
Zeitstempel.Sekunden
Die Anzahl der Sekunden der UTC-Zeit seit der Unix-Epoche 1970-01-01T00:00:00Z.
Unterschrift:
readonly seconds: number;
Timestamp.fromDate()
Erstellt einen neuen Zeitstempel ab dem angegebenen Datum.
Unterschrift:
static fromDate(date: Date): Timestamp;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Datum | Datum | Das Datum, ab dem der Timestamp initialisiert werden soll. |
Kehrt zurück:
Ein neuer Timestamp
der denselben Zeitpunkt wie das angegebene Datum darstellt.
Timestamp.fromMillis()
Erstellt einen neuen Zeitstempel aus der angegebenen Anzahl von Millisekunden.
Unterschrift:
static fromMillis(milliseconds: number): Timestamp;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Millisekunden | Nummer | Anzahl der Millisekunden seit der Unix-Epoche 1970-01-01T00:00:00Z. |
Kehrt zurück:
Ein neuer Timestamp
, der denselben Zeitpunkt wie die angegebene Anzahl von Millisekunden darstellt.
Timestamp.isEqual()
Gibt „true“ zurück, wenn dieser Timestamp
mit dem angegebenen übereinstimmt.
Unterschrift:
isEqual(other: Timestamp): boolean;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
andere | Zeitstempel | Der Timestamp , mit dem verglichen werden soll. |
Kehrt zurück:
Boolescher Wert
true, wenn dieser Timestamp
mit dem angegebenen übereinstimmt.
Timestamp.now()
Erstellt einen neuen Zeitstempel mit dem aktuellen Datum, mit Millisekundengenauigkeit.
Unterschrift:
static now(): Timestamp;
Kehrt zurück:
ein neuer Zeitstempel, der das aktuelle Datum darstellt.
Timestamp.toDate()
Konvertiert einen Timestamp
in ein JavaScript- Date
. Diese Konvertierung führt zu einem Präzisionsverlust, da Date
nur eine Präzision im Millisekundenbereich unterstützen.
Unterschrift:
toDate(): Date;
Kehrt zurück:
Datum
JavaScript- Date
, das denselben Zeitpunkt wie dieser Timestamp
darstellt , mit Millisekundengenauigkeit.
Timestamp.toJSON()
Gibt eine JSON-serialisierbare Darstellung dieses Timestamp
zurück .
Unterschrift:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Kehrt zurück:
{ Sekunden: Zahl; Nanosekunden: Zahl; }
Timestamp.toMillis()
Konvertiert einen Timestamp
in einen numerischen Zeitstempel (in Millisekunden seit der Epoche). Dieser Vorgang führt zu einem Präzisionsverlust.
Unterschrift:
toMillis(): number;
Kehrt zurück:
Nummer
Der diesem Zeitstempel entsprechende Zeitpunkt, dargestellt als Anzahl der Millisekunden seit der Unix-Epoche 1970-01-01T00:00:00Z.
Timestamp.toString()
Gibt eine Textdarstellung dieses Timestamp
zurück .
Unterschrift:
toString(): string;
Kehrt zurück:
Zeichenfolge
Timestamp.valueOf()
Konvertiert dieses Objekt in eine primitive Zeichenfolge, die den Vergleich von Timestamp
mit >
ermöglicht , <=
, >=
und >
Operatoren.
Unterschrift:
valueOf(): string;
Kehrt zurück:
Zeichenfolge