Timestamp
biểu thị một điểm trong thời gian độc lập với bất kỳ múi giờ hoặc lịch nào, được biểu thị dưới dạng giây và phân số của giây ở độ phân giải nano giây trong thời gian UTC Epoch.
Nó được mã hóa bằng Lịch Gregorian Proleptic, kéo dài lịch Gregorian ngược về năm thứ nhất. Nó được mã hóa với giả định tất cả các phút đều dài 60 giây, tức là các giây nhuận bị "làm mờ" nên không cần bảng giây nhuận để giải thích. Phạm vi là từ 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59.999999999Z.
Để biết 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
nhà xây dựng
Người xây dựng | sửa đổi | Sự miêu tả |
---|---|---|
(hàm tạo)(giây, nano giây) | Tạo dấu thời gian mới. |
Của cải
Tài sản | sửa đổi | Kiểu | Sự miêu tả |
---|---|---|---|
nano giây | con số | Phân số của một giây ở độ phân giải nano giây.* | |
giây | con số | Số giây của thời gian UTC kể từ kỷ nguyên Unix 1970-01-01T00:00:00Z. |
phương pháp
Phương pháp | sửa đổi | Sự miêu tả |
---|---|---|
từNgày(ngày) | static | Tạo dấu thời gian mới từ ngày đã cho. |
từMillis(mili giây) | static | Tạo dấu thời gian mới từ số mili giây đã cho. |
isEqual(khác) | Trả về true nếu Timestamp này bằng với Dấu thời gian được cung cấp. | |
Hiện nay() | static | Tạo dấu thời gian mới với ngày hiện tại, với độ chính xác đến mili giây. |
toDate() | Chuyển đổi Timestamp thành đối tượng Date trong JavaScript. Việc chuyển đổi này làm mất độ chính xác do đối tượng Date chỉ hỗ trợ độ chính xác đến mili giây. | |
toJSON() | Trả về biểu diễn có thể tuần tự hóa 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ừ kỷ nguyên). Hoạt động này gây ra sự mất độ chính xác. | |
toString() | Trả về dạ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 nguyên thủy, cho phép so sánh các đối tượng Timestamp bằng cách sử dụng các toán tử > , <= , >= và > . |
Dấu thời gian.(hàm tạo)
Tạo dấu thời gian mới.
Chữ ký:
constructor(
seconds: number,
nanoseconds: number);
Thông số
Tham số | Kiểu | Sự miêu tả |
---|---|---|
giây | con số | Số giây của thời gian UTC kể từ kỷ nguyên Unix 1970-01-01T00:00:00Z. Phải bao gồm từ 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z. |
nano giây | con số | Các phân số không âm của giây ở độ phân giải nano giây. Giá trị thứ hai âm có phân số vẫn phải có giá trị nano giây không âm được đếm tiến theo thời gian. Phải bao gồm từ 0 đến 999.999.999. |
Dấu thời gian.nano giây
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 của thời gian UTC kể từ kỷ nguyên Unix 1970-01-01T00:00:00Z.
Chữ ký:
readonly seconds: number;
Dấu thời gian.fromDate()
Tạo dấu thời gian mới từ ngày đã cho.
Chữ ký:
static fromDate(date: Date): Timestamp;
Thông số
Tham số | Kiểu | Sự miêu tả |
---|---|---|
ngày | Ngày | Ngày khởi tạo Timestamp từ đó. |
Trả về:
Timestamp
mới biểu thị cùng thời điểm với ngày đã cho.
Dấu thời gian.fromMillis()
Tạo dấu thời gian mới từ số mili giây đã cho.
Chữ ký:
static fromMillis(milliseconds: number): Timestamp;
Thông số
Tham số | Kiểu | Sự miêu tả |
---|---|---|
mili giây | con số | Số mili giây kể từ kỷ nguyên Unix 1970-01-01T00:00:00Z. |
Trả về:
Timestamp
mới biểu thị cùng một thời điểm với số mili giây đã cho.
Dấu thời gian.isEqual()
Trả về true nếu Timestamp
này bằng với Dấu thời gian được cung cấp.
Chữ ký:
isEqual(other: Timestamp): boolean;
Thông số
Tham số | Kiểu | Sự miêu tả |
---|---|---|
khác | Dấu thời gian | Timestamp để so sánh. |
Trả về:
boolean
đúng nếu Timestamp
này bằng với Dấu thời gian được cung cấp.
Dấu thời gian.now()
Tạo dấu thời gian mới với ngày hiện tại, với độ chính xác đến mili giây.
Chữ ký:
static now(): Timestamp;
Trả về:
dấu thời gian mới đại diện cho ngày hiện tại.
Dấu thời gian.toDate()
Chuyển đổi Timestamp
thành đối tượng Date
trong JavaScript. Việc chuyển đổi này làm mất độ chính xác do đối tượng Date
chỉ hỗ trợ độ chính xác đến mili giây.
Chữ ký:
toDate(): Date;
Trả về:
Ngày
Đối tượng Date
JavaScript biểu thị cùng thời điểm với Timestamp
này , với độ chính xác đến mili giây.
Dấu thời gian.toJSON()
Trả về một biểu diễn có thể tuần tự hóa JSON của Timestamp
này .
Chữ ký:
toJSON(): {
seconds: number;
nanoseconds: number;
};
Trả về:
{ giây: số; nano giây: số; }
Dấu thời gian.toMillis()
Chuyển đổi Timestamp
thành dấu thời gian dạng số (tính bằng mili giây kể từ kỷ nguyên). Hoạt động này gây ra sự mất độ chính xác.
Chữ ký:
toMillis(): number;
Trả về:
con 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ừ kỷ nguyên Unix 1970-01-01T00:00:00Z.
Dấu thời gian.toString()
Trả về dạng văn bản của Timestamp
này .
Chữ ký:
toString(): string;
Trả về:
sợi dây
Dấu thời gian.valueOf()
Chuyển đổi đối tượng này thành một chuỗi nguyên thủy, cho phép so sánh các đối tượng Timestamp
bằng cách sử dụng >
, <=
các toán tử , >=
và >
.
Chữ ký:
valueOf(): string;
Trả về:
sợi dây