Timestamp class

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;

ผลตอบแทน:

เชือก