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

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

locales Optional

Một chuỗi có 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. Tùy chọn timeZone không được cung cấp, vì nó được tự động đặt là timeZoneId của ngày-giờ. Về các tùy chọn thành phần ngày-giờ và các 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ỳ cái nào: 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 đặt theo kiểu được chỉ định và ngôn ngữ.
• 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 sẽ đượ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 biểu thị ngày-giờ đã cho theo các quy ước ngôn ngữ cụ thể.

Trong các trình triển khai có Intl.DateTimeFormat, điều này tương đương với new Intl.DateTimeFormat(locales, { ...options, timeZone: dateTime.timeZoneId }).format(dateTime.toInstant()), 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 loại mong đợi.

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 ngôn ngữ mặc định và với các tùy chọn mặc định.

const zdt = Temporal.ZonedDateTime.from(
  "2021-08-01T12:34:56-04:00[America/New_York]",
);

console.log(zdt.toLocaleString()); // 8/1/2021, 12:34:56 PM EDT (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 ngôn ngữ, 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 zdt = Temporal.ZonedDateTime.from(
  "2021-08-01T12:34:56+09:00[Asia/Tokyo][u-ca=japanese]",
);
// The ja-JP locale uses the Gregorian calendar by default
zdt.toLocaleString("ja-JP", { calendar: "japanese" }); // R3/8/1 12:34:56 JST

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

Bạn có thể tùy chỉnh 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 zdt = Temporal.ZonedDateTime.from(
  "2021-08-01T12:34:56+09:00[Asia/Tokyo][u-ca=japanese]",
);
zdt.toLocaleString("ja-JP", {
  calendar: "japanese",
  dateStyle: "full",
  timeStyle: "full",
}); // 令和3年8月1日日曜日 12時34分56秒 日本標準時
zdt.toLocaleString("ja-JP", {
  calendar: "japanese",
  year: "numeric",
  month: "long",
  hour: "numeric",
  timeZoneName: "shortGeneric",
}); // 令和3年8月 12時 JST
zdt.toLocaleString("ja-JP", {
  calendar: "japanese",
  year: "numeric",
  hour: "numeric",
  minute: "numeric",
}); // 令和3年 12:34

Đặc tả

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

Xem thêm

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