Temporal.PlainDate.prototype.toLocaleString()

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 các ứng dụng chỉ định ngôn ngữ có quy ước định dạng cần sử dụng.

Trong các triển khai có hỗ trợ API Intl.DateTimeFormat, 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.DateTimeFormat(). Các triển khai không có hỗ trợ Intl.DateTimeFormat sẽ trả về cùng chuỗi như toString(), bỏ qua cả hai tham số.

locales Optional

Một chuỗi chứa BCP 47 language tag, hoặc một mảng các chuỗi như vậy. Tương ứng với tham số locales của hàm tạo Intl.DateTimeFormat().

options Optional

Một đối tượng điều chỉnh định dạng đầu ra. Tương ứng với tham số options của hàm tạo Intl.DateTimeFormat(). Nếu lịch của ngày này không phải là "iso8601", tùy chọn calendar phải được cung cấp với cùng giá trị; nếu không, nếu lịch của ngày này là "iso8601", tùy chọn calendar có thể là bất kỳ giá trị nào. Về các tùy chọn thành phần date-time và các phím tắt kiểu (dateStyle và timeStyle), các tùy chọn nên theo một trong các dạng sau:

• Không cung cấp bất kỳ tùy chọn nào: year, month, và day sẽ mặc định là "numeric".
• Chỉ cung cấp dateStyle: nó mở rộng thành các định dạng weekday, era, year, month, và day.
• Cung cấp một số tùy chọn thành phần date-time, trong đó ít nhất một tùy chọn là tùy chọn ngày (weekday, year, month, day). Chỉ các thành phần ngày được chỉ định mới được đưa vào đầu ra.

Xem hàm tạo Intl.DateTimeFormat() để 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 ngày đã cho theo các quy ước đặc thù của ngôn ngữ.

Trong các triển khai có Intl.DateTimeFormat, điều này tương đương với new Intl.DateTimeFormat(locales, options).format(date), trong đó options đã được chuẩn hóa như mô tả ở trên.

Ngoại lệ

RangeError

Được ném ra nếu bất kỳ tùy chọn nào không hợp lệ.

TypeError

Được ném ra nếu bất kỳ tùy chọn nào không thuộc kiểu dự kiến.

Ví dụ

Sử dụng toLocaleString()

Sử dụng cơ bản phương thức này mà không chỉ định locale sẽ trả về một chuỗi định dạng trong ngôn ngữ mặc định với các tùy chọn mặc định.

const date = Temporal.PlainDate.from("2021-08-01");

console.log(date.toLocaleString()); // 8/1/2021 (giả sử ngôn ngữ en-US)

Nếu lịch của ngày không khớp với lịch mặc định của ngôn ngữ, và lịch của ngày không phải là iso8601, phải cung cấp rõ ràng tùy chọn calendar với cùng giá trị.

const date = Temporal.PlainDate.from("2021-08-01[u-ca=japanese]");
// Ngôn ngữ ja-JP sử dụng lịch Gregorian theo mặc định
date.toLocaleString("ja-JP", { calendar: "japanese" }); // R3/8/1

Sử dụng toLocaleString() với các tùy chọn

Bạn có thể tùy chỉnh các phần nào của ngày được đưa vào đầu ra bằng cách cung cấp tham số options.

const date = Temporal.PlainDate.from("2021-08-01");
date.toLocaleString("en-US", { dateStyle: "full" }); // Sunday, August 1, 2021
date.toLocaleString("en-US", {
  year: "numeric",
  month: "long",
  day: "numeric",
}); // August 1, 2021
date.toLocaleString("en-US", { year: "numeric", month: "long" }); // August 2021

Đặc tả

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

Xem thêm

• Temporal.PlainDate
• Intl.DateTimeFormat
• Temporal.PlainDate.prototype.toJSON()
• Temporal.PlainDate.prototype.toString()