Timestamp class

Timestamp表示獨立於任何時區或日曆的時間點,以 UTC 紀元時間中奈秒分辨率的秒和秒的分數表示。

它使用 Proleptic 公曆進行編碼,將公曆向後延伸到第一年。它的編碼假定所有分鐘都是 60 秒長,即閏秒被“塗抹”,因此不需要閏秒錶來解釋。範圍從 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59.999999999Z。

有關範例和更多規範,請參閱時間戳定義

簽名:

export declare class Timestamp 

建構函數

建構函數修飾符描述
(構造函數)(秒,奈秒)建立新的時間戳。

特性

財產修飾符類型描述
奈秒數位納秒分辨率下的秒的分數。*
數位自 Unix 紀元 1970-01-01T00:00:00Z 以來 UTC 時間的秒數。

方法

方法修飾符描述
起始日期(日期) static從給定日期建立新的時間戳。
fromMillis(毫秒) static根據給定的毫秒數建立新的時間戳記。
是否等於(其他)如果此Timestamp等於提供的時間戳,則傳回 true。
現在() static使用當前日期建立新的時間戳,精度為毫秒。
迄今為止()Timestamp戳記轉換為 JavaScript Date物件。此轉換會導致精確度損失,因為Date物件僅支援毫秒精度。
toJSON()傳回此Timestamp的 JSON 可序列化表示形式。
toMillis()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(含)。
奈秒數位奈秒分辨率下的非負分數。帶分數的負秒值仍必須具有按時間向前計數的非負奈秒值。必須介於 0 到 999,999,999 之間(包含 0 和 999,999,999)。

時間戳.納秒

納秒分辨率下的秒的分數。*

簽名:

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;

返回:

日期

JavaScript Date物件表示與此Timestamp相同的時間點,具有毫秒精度。

時間戳.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;

返回:

細繩