Timestamp class

Timestamp は、タイムゾーンやカレンダーに依存しない特定の時点を表し、UTC エポック時間のナノ秒単位の分解能で秒と小数点以下で表されます。

Timestamp は先発グレゴリオ暦を使用してエンコードされています。先発グレゴリオ暦は、紀元 1 年までグレゴリオ暦を拡大したものです。このエンコーディングでは、すべての分の長さが 60 秒であると仮定されています。つまり、うるう秒を無視することで、解釈にうるう秒テーブルが不要となっています。範囲は 0001-01-01T00:00:00Z ～ 9999-12-31T23:59:59.999999999Z です。

例と詳細な仕様については、タイムスタンプの定義をご覧ください。

署名:

export declare class Timestamp 

コンストラクタ

プロパティ

メソッド

Timestamp.（コンストラクタ）

新しいタイムスタンプを作成します。

署名:

constructor(
    seconds: number, 
    nanoseconds: number);

パラメータ

Timestamp.ナノ秒

ナノ秒単位の分解能の 1 秒未満*。

署名:

readonly nanoseconds: number;

Timestamp.seconds

Unix エポック 1970-01-01T00:00:00Z からの UTC 時間の秒数。

署名:

readonly seconds: number;

Timestamp.fromDate()

指定された日付から新しいタイムスタンプを作成します。

署名:

static fromDate(date: Date): Timestamp;

パラメータ

戻り値:

タイムスタンプ

指定された日付と同じ時点を表す新しい Timestamp。

Timestamp.fromMillis()

指定されたミリ秒数から新しいタイムスタンプを作成します。

署名:

static fromMillis(milliseconds: number): Timestamp;

パラメータ

戻り値:

タイムスタンプ

指定されたミリ秒数と同じ時点を表す新しい Timestamp。

Timestamp.isEqual()

この Timestamp が指定された値と等しい場合、true を返します。

署名:

isEqual(other: Timestamp): boolean;

パラメータ

戻り値:

ブール値

この Timestamp が指定された値と等しい場合は true を返します。

Timestamp.now()

現在の日付で新しいタイムスタンプをミリ秒単位の精度で作成します。

署名:

static now(): Timestamp;

戻り値:

タイムスタンプ

現在の日付を表す新しいタイムスタンプ。

Timestamp.toDate()

Timestamp を JavaScript の Date オブジェクトに変換します。Date オブジェクトはミリ秒単位の精度しかサポートしないため、この変換により精度が低下します。

署名:

toDate(): Date;

戻り値:

日付

この Timestamp と同じ時点をミリ秒単位の精度で表す JavaScript Date オブジェクト。

Timestamp.toJSON()

この Timestamp の JSON シリアル化可能な表現を返します。

署名:

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

戻り値:

{ 秒: 数値;ナノ秒: 数値;}

Timestamp.toMillis()

Timestamp を数値のタイムスタンプ（エポックからのミリ秒数）に変換します。このオペレーションでは精度が低下します。

署名:

toMillis(): number;

戻り値:

数値

このタイムスタンプに対応する時点。Unix エポック 1970-01-01T00:00:00Z からの経過ミリ秒数で表されます。

Timestamp.toString()

この Timestamp のテキスト表現を返します。

署名:

toString(): string;

戻り値:

文字列

Timestamp.valueOf()

このオブジェクトをプリミティブ文字列に変換します。これにより、>、<=、>=、> 演算子を使用して Timestamp オブジェクトを比較できます。

署名:

valueOf(): string;

戻り値:

文字列