Temporal.Duration.prototype.toLocaleString()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức toLocaleString() của các instance Temporal.Duration trả về một chuỗi biểu diễn duration này theo ngôn ngữ cụ thể. Trong các môi trường hỗ trợ API Intl.DurationFormat, phương thức này ủy quyền cho Intl.DurationFormat.
Mỗi lần toLocaleString được gọi, nó phải thực hiện tìm kiếm trong một cơ sở dữ liệu lớn về chuỗi bản địa hóa, điều này có thể không hiệu quả. Khi phương thức được gọi nhiều lần với cùng đối số, tốt hơn là tạo một đối tượng Intl.DurationFormat và sử dụng phương thức format() của nó, vì đối tượng DurationFormat ghi nhớ các đối số được truyền vào và có thể quyết định lưu vào bộ nhớ đệm một phần của cơ sở dữ liệu, do đó các lần gọi format trong tương lai có thể tìm kiếm chuỗi bản địa hóa trong một ngữ cảnh bị hạn chế hơn.
Cú pháp
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Tham số
Các tham số locales và options tùy chỉnh hành vi của hàm và cho phép ứng dụng chỉ định ngôn ngữ có quy ước định dạng cần sử dụng.
Trong các môi trường hỗ trợ API Intl.DurationFormat, các tham số này tương ứng chính xác với các tham số của hàm tạo Intl.DurationFormat(). Các môi trường không hỗ trợ Intl.DurationFormat trả về chuỗi giống hệt với toString(), bỏ qua cả hai tham số.
localesOptional-
Một chuỗi với BCP 47 language tag, hoặc một mảng các chuỗi như vậy. Tương ứng với tham số
localescủa hàm tạoIntl.DurationFormat(). optionsOptional-
Một đối tượng điều chỉnh định dạng đầu ra. Tương ứng với tham số
optionscủa hàm tạoIntl.DurationFormat().
Xem hàm tạo Intl.DurationFormat() để biết chi tiết về các tham số này và cách sử dụng chúng.
Giá trị trả về
Một chuỗi biểu diễn duration đã cho theo quy ước ngôn ngữ cụ thể.
Trong các môi trường có Intl.DurationFormat, điều này tương đương với new Intl.DurationFormat(locales, options).format(duration).
Note:
Hầu hết thời gian, định dạng được trả về bởi toLocaleString() là nhất quán. Tuy nhiên, đầu ra có thể khác nhau giữa các môi trường, ngay cả trong cùng một locale — sự biến đổi đầu ra là có chủ ý và được cho phép theo đặc tả. Nó cũng có thể không phải là những gì bạn mong đợi. Ví dụ, chuỗi có thể sử dụng dấu cách không ngắt hoặc được bao quanh bởi các ký tự kiểm soát hai chiều. Bạn không nên so sánh kết quả của toLocaleString() với các hằng số cố định.
Ví dụ
Sử dụng toLocaleString()
Cách sử dụng cơ bản của phương thức này mà không chỉ định locale trả về một chuỗi được định dạng theo locale mặc định và với các tùy chọn mặc định.
const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toLocaleString()); // 1 hr, 30 min, 15 sec
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.duration.prototype.tolocalestring |