Timestamp
แสดงถึงช่วงเวลาที่ไม่ขึ้นอยู่กับเขตเวลาหรือปฏิทินใดๆ ซึ่งแสดงเป็นวินาทีและเสี้ยววินาทีที่ความละเอียดระดับนาโนวินาทีตามเวลา UTC Epoch
โดยได้รับการเข้ารหัสโดยใช้ปฏิทินเกรกอเรียนโพรเลปติก ซึ่งขยายปฏิทินเกรกอเรียนย้อนหลังไปถึงปี 1 ซึ่งจะเข้ารหัสโดยสมมติว่านาทีทั้งหมดมีความยาว 60 วินาที เช่น จำนวนวินาทีที่อวบอิ่มจะถูก "ละเลง" เพื่อที่จะได้ไม่ต้องอาศัยตารางที่ 2 ในการตีความ ช่วงเวลามีค่าตั้งแต่ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59.999999999Z
ดูตัวอย่างและข้อกำหนดเพิ่มเติมได้ที่คำจำกัดความของการประทับเวลา
ลายเซ็น:
export declare class Timestamp
ผู้ผลิต
ผู้ผลิต | คีย์ตัวปรับแต่ง | คำอธิบาย |
---|---|---|
(เครื่องมือสร้าง)(วินาที, นาโนวินาที) | สร้างการประทับเวลาใหม่ |
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | คีย์ตัวปรับแต่ง | ประเภท | คำอธิบาย |
---|---|---|---|
นาโนวินาที | ตัวเลข | เสี้ยววินาทีที่ความละเอียดระดับนาโนวินาที* | |
วินาที | ตัวเลข | จำนวนวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z |
เมธอด
วิธีการ | คีย์ตัวปรับแต่ง | คำอธิบาย |
---|---|---|
fromDate(วันที่) | static |
สร้างการประทับเวลาใหม่จากวันที่ที่ระบุ |
fromMillis(มิลลิวินาที) | static |
สร้างการประทับเวลาใหม่จากจำนวนมิลลิวินาทีที่ระบุ |
isEqual(อื่นๆ) | แสดงค่า "จริง" หาก Timestamp นี้เท่ากับที่ระบุ |
|
now() | static |
สร้างการประทับเวลาใหม่โดยระบุวันที่ปัจจุบันด้วยความแม่นยำมิลลิวินาที |
toDate() | แปลง Timestamp เป็นออบเจ็กต์ JavaScript Date การแปลงนี้ทำให้สูญเสียความแม่นยำเนื่องจากออบเจ็กต์ Date รองรับความแม่นยำในมิลลิวินาทีเท่านั้น |
|
toJSON() | แสดงผลการแสดงแบบอนุกรม JSON ของ Timestamp นี้ |
|
toMillis() | แปลง Timestamp เป็นการประทับเวลาที่เป็นตัวเลข (เป็นมิลลิวินาทีตั้งแต่ Epoch) การดำเนินการนี้จะทำให้สูญเสียความแม่นยำ |
|
toString() | แสดงผลแบบข้อความของ Timestamp นี้ |
|
valueOf() | แปลงออบเจ็กต์นี้เป็นสตริงพื้นฐาน ซึ่งช่วยให้เปรียบเทียบออบเจ็กต์ Timestamp ได้โดยใช้โอเปอเรเตอร์ > , <= , >= และ > |
การประทับเวลา (เครื่องมือสร้าง)
สร้างการประทับเวลาใหม่
ลายเซ็น:
constructor(
seconds: number,
nanoseconds: number);
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
วินาที | ตัวเลข | จำนวนวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z รวมด้วย |
นาโนวินาที | ตัวเลข | เศษส่วนที่ไม่เป็นลบของวินาทีที่ความละเอียดระดับนาโนวินาที ค่าวินาทีติดลบที่มีเศษส่วนยังต้องมีค่านาโนวินาทีที่ไม่เป็นลบซึ่งจะนับต่อไปตามเวลา ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999 |
การประทับเวลานาโนวินาที
เสี้ยววินาทีที่ความละเอียดระดับนาโนวินาที*
ลายเซ็น:
readonly nanoseconds: number;
Timestamp.second
จำนวนวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z
ลายเซ็น:
readonly seconds: number;
Timestamp.fromDate()
สร้างการประทับเวลาใหม่จากวันที่ที่ระบุ
ลายเซ็น:
static fromDate(date: Date): Timestamp;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
วันที่ | วันที่ | วันที่ที่เริ่มใช้ Timestamp |
การคืนสินค้า:
Timestamp
ใหม่ที่แสดงช่วงเวลาเดียวกันกับวันที่ที่ระบุ
Timestamp.fromMillis()
สร้างการประทับเวลาใหม่จากจำนวนมิลลิวินาทีที่ระบุ
ลายเซ็น:
static fromMillis(milliseconds: number): Timestamp;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
มิลลิวินาที | ตัวเลข | จำนวนมิลลิวินาทีตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z |
การคืนสินค้า:
Timestamp
ใหม่ที่แสดงถึงช่วงเวลาเดียวกันกับจำนวนมิลลิวินาทีที่กำหนด
Timestamp.isEqual()
แสดงค่า "จริง" หาก Timestamp
นี้เท่ากับที่ระบุ
ลายเซ็น:
isEqual(other: Timestamp): boolean;
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
อื่นๆ | การประทับเวลา | Timestamp ที่จะเปรียบเทียบ |
การคืนสินค้า:
boolean
"จริง" หาก Timestamp
นี้เท่ากับที่ระบุ
การประทับเวลา.now()
สร้างการประทับเวลาใหม่โดยระบุวันที่ปัจจุบันด้วยความแม่นยำมิลลิวินาที
ลายเซ็น:
static now(): Timestamp;
การคืนสินค้า:
การประทับเวลาใหม่แทนวันที่ปัจจุบัน
Timestamp.toDate()
แปลง Timestamp
เป็นออบเจ็กต์ JavaScript Date
การแปลงนี้ทำให้สูญเสียความแม่นยำเนื่องจากออบเจ็กต์ Date
รองรับความแม่นยำในมิลลิวินาทีเท่านั้น
ลายเซ็น:
toDate(): Date;
การคืนสินค้า:
วันที่
ออบเจ็กต์ Date
ของ JavaScript แสดงช่วงเวลาเดียวกันกับ Timestamp
นี้โดยมีความแม่นยำเป็นมิลลิวินาที
การประทับเวลา.toJSON()
แสดงผลการนำเสนอ Timestamp
นี้แบบอนุกรมของ JSON
ลายเซ็น:
toJSON(): {
seconds: number;
nanoseconds: number;
};
การคืนสินค้า:
{ วินาที: ตัวเลข; นาโนวินาที: จำนวน; }
Timestamp.toMillis()
แปลง Timestamp
เป็นการประทับเวลาที่เป็นตัวเลข (เป็นมิลลิวินาทีตั้งแต่ Epoch) การดำเนินการนี้จะทำให้สูญเสียความแม่นยำ
ลายเซ็น:
toMillis(): number;
การคืนสินค้า:
ตัวเลข
จุดของเวลาที่สอดคล้องกับการประทับเวลานี้ ซึ่งแสดงเป็นจำนวนมิลลิวินาทีนับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z
Timestamp.toString()
แสดงผลแบบข้อความของ Timestamp
นี้
ลายเซ็น:
toString(): string;
การคืนสินค้า:
สตริง
Timestamp.valueOf()
แปลงออบเจ็กต์นี้เป็นสตริงพื้นฐาน ซึ่งช่วยให้เปรียบเทียบออบเจ็กต์ Timestamp
ได้โดยใช้โอเปอเรเตอร์ >
, <=
, >=
และ >
ลายเซ็น:
valueOf(): string;
การคืนสินค้า:
สตริง