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(含)。

时间戳.纳秒

纳秒分辨率下的秒的分数。*

签名:

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;

返回:

细绳