Timestamp class

Timestamp biểu thị một thời điểm không phụ thuộc vào múi giờ hay lịch, được biểu diễn dưới dạng giây và phân số của giây ở độ phân giải nano giây theo giờ UTC (theo giờ UTC).

Lịch này được mã hoá bằng Lịch Gregorian Proleptic, kéo dài dương lịch Gregory ngược trở lại năm thứ nhất. Thông số này được mã hoá với giả định tất cả phút dài 60 giây, tức là giây nhuận được "nhám" để không cần bảng thứ hai nhuận để diễn giải. Phạm vi là từ 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59.999999999Z.

Để xem ví dụ và thông số kỹ thuật khác, hãy tham khảo Định nghĩa dấu thời gian.

Chữ ký:

export declare class Timestamp

Công ty sản xuất

Công ty sản xuất Công cụ sửa đổi Mô tả
(hàm khởi tạo)(giây, nano giây) Tạo một dấu thời gian mới.

Thuộc tính

Tài sản Công cụ sửa đổi Loại Mô tả
nano giây số Các phân số của một giây ở độ phân giải nano giây.*
giây số Số giây thời gian UTC kể từ thời gian Unix 1970-01-01T00:00:00Z.

Phương thức

Phương thức Công cụ sửa đổi Mô tả
fromDate(ngày) static Tạo một dấu thời gian mới từ ngày cụ thể.
fromMillis(mili giây) static Tạo một dấu thời gian mới từ số mili giây đã cho.
isEqual(other) Trả về true nếu Timestamp này bằng giá trị đã cho.
now() static Tạo một dấu thời gian mới có ngày hiện tại với độ chính xác tính bằng mili giây.
toDate() Chuyển đổi Timestamp thành đối tượng Date của JavaScript. Hoạt động chuyển đổi này làm giảm độ chính xác vì các đối tượng Date chỉ hỗ trợ độ chính xác từng mili giây.
toJSON() Trả về một bản trình bày được chuyển đổi tuần tự JSON của Timestamp này.
toMillis() Chuyển đổi Timestamp thành dấu thời gian dạng số (tính bằng mili giây kể từ thời gian bắt đầu của hệ thống). Thao tác này sẽ làm giảm độ chính xác.
toString() Trả về nội dung biểu thị bằng văn bản của Timestamp này.
giá_trị_của() Chuyển đổi đối tượng này thành một chuỗi gốc để cho phép so sánh các đối tượng Timestamp bằng các toán tử >, <=, >= và >.

Dấu thời gian.(hàm khởi tạo)

Tạo một dấu thời gian mới.

Chữ ký:

constructor(
    seconds: number, 
    nanoseconds: number);

Thông số

Thông số Loại Mô tả
giây số Số giây thời gian UTC kể từ thời gian Unix 1970-01-01T00:00:00Z. Phải từ 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z.
nano giây số Các phân số không âm của một giây ở độ phân giải nano giây. Giá trị âm thứ hai chứa phân số vẫn phải có giá trị nano giây không âm và đếm ngược theo thời gian. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999.

Dấu thời gian.nano giây

Các phân số của một giây ở độ phân giải nano giây.*

Chữ ký:

readonly nanoseconds: number;

Dấu thời gian.giây

Số giây thời gian UTC kể từ thời gian Unix 1970-01-01T00:00:00Z.

Chữ ký:

readonly seconds: number;

Timestamp.fromDate() (Dấu thời gian từ ngày())

Tạo một dấu thời gian mới từ ngày cụ thể.

Chữ ký:

static fromDate(date: Date): Timestamp;

Thông số

Thông số Loại Mô tả
ngày Ngày Ngày bắt đầu Timestamp.

Trường hợp trả lại hàng:

Dấu thời gian

Một Timestamp mới đại diện cho cùng một thời điểm với ngày cụ thể.

Timestamp.fromMillis()

Tạo một dấu thời gian mới từ số mili giây đã cho.

Chữ ký:

static fromMillis(milliseconds: number): Timestamp;

Thông số

Thông số Loại Mô tả
mili giây số Số mili giây kể từ thời gian Unix 1970-01-01T00:00:00Z.

Trường hợp trả lại hàng:

Dấu thời gian

Một Timestamp mới biểu thị cùng một thời điểm với số mili giây đã cho.

Timestamp.isEqual()

Trả về true nếu Timestamp này bằng giá trị đã cho.

Chữ ký:

isEqual(other: Timestamp): boolean;

Thông số

Thông số Loại Mô tả
khác Dấu thời gian Timestamp để so sánh.

Trường hợp trả lại hàng:

boolean

true nếu Timestamp này bằng với giá trị đã cho.

Timestamp (Dấu thời gian)

Tạo một dấu thời gian mới có ngày hiện tại, với độ chính xác tính bằng mili giây.

Chữ ký:

static now(): Timestamp;

Trường hợp trả lại hàng:

Dấu thời gian

một dấu thời gian mới thể hiện ngày hiện tại.

Timestamp.toDate() (Dấu thời gian.toDate())

Chuyển đổi Timestamp thành đối tượng Date của JavaScript. Hoạt động chuyển đổi này làm giảm độ chính xác vì các đối tượng Date chỉ hỗ trợ độ chính xác từng mili giây.

Chữ ký:

toDate(): Date;

Trường hợp trả lại hàng:

Ngày

Đối tượng Date JavaScript biểu thị cùng một thời điểm với Timestamp này, với độ chính xác đến từng mili giây.

Timestamp.toJSON()

Trả về một bản trình bày được chuyển đổi tuần tự JSON của Timestamp này.

Chữ ký:

toJSON(): {
        seconds: number;
        nanoseconds: number;
    };

Trường hợp trả lại hàng:

{ seconds: number; nano giây: số; }

Timestamp.toMillis()

Chuyển đổi Timestamp thành dấu thời gian dạng số (tính bằng mili giây kể từ thời gian bắt đầu của hệ thống). Thao tác này sẽ làm giảm độ chính xác.

Chữ ký:

toMillis(): number;

Trường hợp trả lại hàng:

số

Thời điểm tương ứng với dấu thời gian này, được biểu thị bằng số mili giây kể từ thời gian Unix 1970-01-01T00:00:00Z.

Timestamp.toString()

Trả về bản trình bày bằng văn bản của Timestamp này.

Chữ ký:

toString(): string;

Trường hợp trả lại hàng:

chuỗi

Timestamp.valueOf()

Chuyển đổi đối tượng này thành một chuỗi gốc để cho phép so sánh các đối tượng Timestamp bằng các toán tử >, <=, >= và >.

Chữ ký:

valueOf(): string;

Trường hợp trả lại hàng:

chuỗi