Timestamp class

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;

การคืนสินค้า:

สตริง