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;
返回:
细绳