Timestamp
タイムゾーンやカレンダーに依存しない時点を表し、UTC エポック時間のナノ秒の解像度で秒および秒の端数として表されます。
これは、グレゴリオ暦を 1 年目まで逆方向に拡張する Proletic グレゴリオ暦を使用してエンコードされます。これは、すべての分が 60 秒の長さであることを前提としてエンコードされます。つまり、うるう秒は「不鮮明」であるため、解釈にうるう秒テーブルは必要ありません。範囲は 0001-01-01T00:00:00Z ~ 9999-12-31T23:59:59.999999999Z です。
例と詳細な仕様については、タイムスタンプの定義を参照してください。 。
サイン:
export declare class Timestamp
コンストラクター
コンストラクタ | 修飾子 | 説明 |
---|---|---|
(コンストラクター)(秒、ナノ秒) | 新しいタイムスタンプを作成します。 |
プロパティ
財産 | 修飾子 | タイプ | 説明 |
---|---|---|---|
ナノ秒 | 番号 | ナノ秒の分解能での 1 秒の端数。* | |
秒 | 番号 | Unix エポック 1970-01-01T00:00:00Z からの UTC 時間の秒数。 |
メソッド
方法 | 修飾子 | 説明 |
---|---|---|
fromDate(日付) | static | 指定された日付から新しいタイムスタンプを作成します。 |
fromミリス(ミリ秒) | static | 指定されたミリ秒数から新しいタイムスタンプを作成します。 |
isEqual(その他) | このTimestamp が指定されたタイムスタンプと等しい場合は true を返します。 | |
今() | static | 現在の日付をミリ秒精度で含む新しいタイムスタンプを作成します。 |
現在まで() | Timestamp JavaScript Date オブジェクトに変換します。 Date オブジェクトはミリ秒の精度のみをサポートするため、この変換により精度が失われます。 | |
toJSON() | このTimestamp の JSON シリアル化可能な表現を返します。 | |
toミリス() | Timestamp 数値タイムスタンプ (エポックからのミリ秒単位) に変換します。この操作により精度が失われます。 | |
toString() | このTimestamp のテキスト表現を返します。 | |
値の() | このオブジェクトをプリミティブ文字列に変換します。これにより、 > 、 <= 、 >= 、および> 演算子を使用してTimestamp オブジェクトを比較できるようになります。 |
タイムスタンプ(コンストラクター)
新しいタイムスタンプを作成します。
サイン:
constructor(
seconds: number,
nanoseconds: number);
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
秒 | 番号 | Unix エポック 1970-01-01T00:00:00Z からの UTC 時間の秒数。 0001-01-01T00:00:00Z から 9999-12-31T23:59:59Z までである必要があります。 |
ナノ秒 | 番号 | ナノ秒分解能での 1 秒の非負の小数部分。小数を含む負の秒値には、時間の経過とともにカウントされる負でないナノ秒値が必要です。 0 ~ 999,999,999 の範囲で指定する必要があります。 |
タイムスタンプ.ナノ秒
ナノ秒の分解能での 1 秒の端数。*
サイン:
readonly nanoseconds: number;
タイムスタンプ.秒
Unix エポック 1970-01-01T00:00:00Z からの UTC 時間の秒数。
サイン:
readonly seconds: number;
タイムスタンプ.fromDate()
指定された日付から新しいタイムスタンプを作成します。
サイン:
static fromDate(date: Date): Timestamp;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
日付 | 日付 | Timestamp を初期化する日付。 |
戻り値:
指定された日付と同じ時点を表す新しいTimestamp
。
タイムスタンプ.fromMillis()
指定されたミリ秒数から新しいタイムスタンプを作成します。
サイン:
static fromMillis(milliseconds: number): Timestamp;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
ミリ秒 | 番号 | Unix エポック 1970-01-01T00:00:00Z からのミリ秒数。 |
戻り値:
指定されたミリ秒数と同じ時点を表す新しいTimestamp
。
タイムスタンプ.isEqual()
このTimestamp
が指定されたタイムスタンプと等しい場合は true を返します。
サイン:
isEqual(other: Timestamp): boolean;
パラメーター
パラメータ | タイプ | 説明 |
---|---|---|
他の | タイムスタンプ | 比較するTimestamp 。 |
戻り値:
ブール値
このTimestamp
が指定されたタイムスタンプと等しい場合は true。
タイムスタンプ.now()
現在の日付をミリ秒精度で含む新しいタイムスタンプを作成します。
サイン:
static now(): Timestamp;
戻り値:
現在の日付を表す新しいタイムスタンプ。
タイムスタンプ.toDate()
Timestamp
JavaScript Date
オブジェクトに変換します。 Date
オブジェクトはミリ秒の精度のみをサポートするため、この変換により精度が失われます。
サイン:
toDate(): Date;
戻り値:
日付
このTimestamp
と同じ時点を表す JavaScript Date
オブジェクト、ミリ秒の精度で。
タイムスタンプ.toJSON()
このTimestamp
の JSON シリアル化可能な表現を返します。 。
サイン:
toJSON(): {
seconds: number;
nanoseconds: number;
};
戻り値:
{ 秒: 数値;ナノ秒: 数値; }
タイムスタンプ.toMillis()
Timestamp
数値タイムスタンプ (エポックからのミリ秒単位) に変換します。この操作により精度が失われます。
サイン:
toMillis(): number;
戻り値:
番号
このタイムスタンプに対応する時点。Unix エポック 1970-01-01T00:00:00Z からのミリ秒数として表されます。
タイムスタンプ.toString()
このTimestamp
のテキスト表現を返します。 。
サイン:
toString(): string;
戻り値:
弦
タイムスタンプ.valueOf()
このオブジェクトをプリミティブ文字列に変換します。これにより、 >
を使用してTimestamp
オブジェクトを比較できるようになります。 、 <=
、 >=
、 >
演算子。
サイン:
valueOf(): string;
戻り値:
弦