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;
返回:
細繩