Temporal.PlainTime

Mô tả

PlainTime về cơ bản là phần thời gian của đối tượng Temporal.PlainDateTime, với thông tin ngày đã được loại bỏ. Do thông tin ngày và giờ không tương tác nhiều với nhau, tất cả thông tin chung về thuộc tính thời gian đều được tài liệu hóa tại đây.

Định dạng RFC 9557

Các đối tượng PlainTime có thể được tuần tự hóa và phân tích bằng định dạng RFC 9557, một phần mở rộng của định dạng ISO 8601 / RFC 3339. Chuỗi có dạng sau:

HH:mm:ss.sssssssss

HH

Số hai chữ số từ 00 đến 23. Có thể được tiền tố bởi ký hiệu chỉ thời gian T hoặc t.

mm Optional

Số hai chữ số từ 00 đến 59. Mặc định là 00.

ss.sssssssss Optional

Số hai chữ số từ 00 đến 59. Tùy chọn có thể theo sau bởi . hoặc , và một đến chín chữ số. Mặc định là 00. Các thành phần HH, mm và ss có thể được phân tách bởi : hoặc không có gì. Bạn có thể bỏ qua chỉ ss hoặc cả ss và mm, vì vậy thời gian có thể có một trong ba dạng: HH, HH:mm hoặc HH:mm:ss.sssssssss.

Khi nhập, bạn có thể tùy chọn bao gồm ngày, độ lệch, định danh múi giờ và lịch, theo cùng định dạng như PlainDateTime, nhưng chúng sẽ bị bỏ qua. Chuỗi chỉ có ngày sẽ bị từ chối. Các chú thích khác theo định dạng [key=value] cũng bị bỏ qua và không được có cờ critical.

Khi tuần tự hóa, bạn có thể cấu hình số chữ số thập phân của giây.

Hàm khởi tạo

Temporal.PlainTime()

Tạo một đối tượng Temporal.PlainTime mới bằng cách trực tiếp cung cấp dữ liệu cơ bản.

Phương thức tĩnh

Temporal.PlainTime.compare()

Trả về một số (-1, 0 hoặc 1) cho biết thời gian đầu tiên đến trước, bằng hoặc sau thời gian thứ hai. Tương đương với việc so sánh từng trường giờ, phút, giây, mili-giây, micro-giây và nano-giây một.

Temporal.PlainTime.from()

Tạo một đối tượng Temporal.PlainTime mới từ một đối tượng Temporal.PlainTime khác, một đối tượng với các thuộc tính thời gian, hoặc một chuỗi RFC 9557.

Thuộc tính thực thể

Các thuộc tính này được định nghĩa trên Temporal.PlainTime.prototype và được chia sẻ bởi tất cả các thực thể Temporal.PlainTime.

Temporal.PlainTime.prototype.constructor

Hàm khởi tạo đã tạo ra đối tượng thực thể. Đối với các thực thể Temporal.PlainTime, giá trị ban đầu là hàm khởi tạo Temporal.PlainTime().

Temporal.PlainTime.prototype.hour

Trả về một số nguyên từ 0 đến 23 đại diện cho thành phần giờ của thời gian này.

Temporal.PlainTime.prototype.microsecond

Trả về một số nguyên từ 0 đến 999 đại diện cho thành phần micro-giây (10^-6 giây) của thời gian này.

Temporal.PlainTime.prototype.millisecond

Trả về một số nguyên từ 0 đến 999 đại diện cho thành phần mili-giây (10^-3 giây) của thời gian này.

Temporal.PlainTime.prototype.minute

Trả về một số nguyên từ 0 đến 59 đại diện cho thành phần phút của thời gian này.

Temporal.PlainTime.prototype.nanosecond

Trả về một số nguyên từ 0 đến 999 đại diện cho thành phần nano-giây (10^-9 giây) của thời gian này.

Temporal.PlainTime.prototype.second

Trả về một số nguyên từ 0 đến 59 đại diện cho thành phần giây của thời gian này.

Temporal.PlainTime.prototype[Symbol.toStringTag]

Giá trị ban đầu của thuộc tính [Symbol.toStringTag] là chuỗi "Temporal.PlainTime". Thuộc tính này được sử dụng trong Object.prototype.toString().

Phương thức thực thể

Temporal.PlainTime.prototype.add()

Trả về một đối tượng Temporal.PlainTime mới đại diện cho thời gian này được tiến về phía trước một khoảng thời gian nhất định (dưới dạng có thể chuyển đổi bởi Temporal.Duration.from()), cuộn qua đồng hồ nếu cần.

Temporal.PlainTime.prototype.equals()

Trả về true nếu thời gian này có giá trị tương đương với một thời gian khác (dưới dạng có thể chuyển đổi bởi Temporal.PlainTime.from()), ngược lại là false. Chúng được so sánh theo giá trị thời gian. Tương đương với Temporal.PlainTime.compare(this, other) === 0.

Temporal.PlainTime.prototype.round()

Trả về một đối tượng Temporal.PlainTime mới đại diện cho thời gian này được làm tròn đến đơn vị nhất định.

Temporal.PlainTime.prototype.since()

Trả về một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian từ một thời gian khác (dưới dạng có thể chuyển đổi bởi Temporal.PlainTime.from()) đến thời gian này. Khoảng thời gian là dương nếu thời gian kia đến trước thời gian này, và âm nếu sau.

Temporal.PlainTime.prototype.subtract()

Trả về một đối tượng Temporal.PlainTime mới đại diện cho thời gian này được lùi về phía sau một khoảng thời gian nhất định (dưới dạng có thể chuyển đổi bởi Temporal.Duration.from()), cuộn qua đồng hồ nếu cần.

Temporal.PlainTime.prototype.toJSON()

Trả về một chuỗi đại diện cho thời gian này trong cùng định dạng RFC 9557 như khi gọi toString(). Được thiết kế để được gọi ngầm bởi JSON.stringify().

Temporal.PlainTime.prototype.toLocaleString()

Trả về một chuỗi với biểu diễn phụ thuộc ngôn ngữ của thời gian này.

Temporal.PlainTime.prototype.toString()

Trả về một chuỗi đại diện cho thời gian này theo định dạng RFC 9557.

Temporal.PlainTime.prototype.until()

Trả về một đối tượng Temporal.Duration mới đại diện cho khoảng thời gian từ thời gian này đến một thời gian khác (dưới dạng có thể chuyển đổi bởi Temporal.PlainTime.from()). Khoảng thời gian là dương nếu thời gian kia đến sau thời gian này, và âm nếu trước.

Temporal.PlainTime.prototype.valueOf()

Ném ra TypeError, ngăn các thực thể Temporal.PlainTime bị chuyển đổi ngầm sang kiểu nguyên thủy khi được sử dụng trong các phép tính số học hoặc so sánh.

Temporal.PlainTime.prototype.with()

Trả về một đối tượng Temporal.PlainTime mới đại diện cho thời gian này với một số trường được thay thế bằng các giá trị mới.

Đặc tả

Tương thích trình duyệt

Xem thêm

• Temporal
• Temporal.Duration
• Temporal.PlainDateTime