Temporal.PlainDateTime.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ó các quy ước định dạng cần được sử dụng.

Trong các triển khai 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 trả về chuỗi giống hệt như toString(), bỏ qua cả hai tham số.

locales Optional

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ố 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-giờ 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ị; ngược lại, nếu lịch của ngày-giờ này là "iso8601", tùy chọn calendar có thể là bất kỳ giá trị nào. Đối với các tùy chọn thành phần ngày-giờ và các phím tắt style (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 trong số đó: year, month, day, hour, minute, và second sẽ mặc định là "numeric".
• Cung cấp ít nhất một trong dateStyle hoặc timeStyle: các thành phần ngày-giờ sẽ được thiết lập theo style được chỉ định và locale.
• Cung cấp một số tùy chọn thành phần ngày-giờ. Chỉ các thành phần ngày-giờ được chỉ định mới được bao gồm trong đầ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 đại diện cho ngày-giờ đã cho theo các quy ước theo ngôn ngữ cụ thể.

Trong các triển khai có Intl.DateTimeFormat, điều này tương đương với new Intl.DateTimeFormat(locales, options).format(dateTime), 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 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 dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56");

console.log(dt.toLocaleString()); // 8/1/2021, 12:34:56 PM (assuming en-US locale)

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

const dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56[u-ca=japanese]");
// The ja-JP locale uses the Gregorian calendar by default
dt.toLocaleString("ja-JP", { calendar: "japanese" }); // R3/8/1 12:34:56

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 bao gồm trong đầu ra bằng cách cung cấp tham số options.

const dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56");
dt.toLocaleString("en-US", { dateStyle: "full", timeStyle: "full" }); // Sunday, August 1, 2021 at 12:34:56 PM
dt.toLocaleString("en-US", {
  year: "numeric",
  month: "long",
  hour: "numeric",
}); // August 2021 at 12 PM
dt.toLocaleString("en-US", {
  year: "numeric",
  hour: "numeric",
  minute: "numeric",
}); // 2021, 12:34 PM

Đặc tả

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

Xem thêm

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