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