String.prototype.toLocaleLowerCase()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức toLocaleLowerCase() của các giá trị String trả về chuỗi này được chuyển đổi sang chữ thường, theo các ánh xạ chữ hoa/thường đặc thù của từng ngôn ngữ.
Try it
const dotted = "İstanbul";
console.log(`EN-US: ${dotted.toLocaleLowerCase("en-US")}`);
// Expected output: "i̇stanbul"
console.log(`TR: ${dotted.toLocaleLowerCase("tr")}`);
// Expected output: "istanbul"
Cú pháp
toLocaleLowerCase()
toLocaleLowerCase(locales)
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. Chỉ định ngôn ngữ được sử dụng để chuyển đổi sang chữ thường theo các ánh xạ chữ hoa/thường đặc thù của ngôn ngữ đó. Để biết dạng chung và cách diễn giải tham số
locales, xem mô tả tham số trên trang chính củaIntl.Khác với các phương thức khác sử dụng tham số
locales,toLocaleLowerCase()không cho phép đối sánh ngôn ngữ. Do đó, sau khi kiểm tra tính hợp lệ của tham sốlocales,toLocaleLowerCase()luôn sử dụng ngôn ngữ đầu tiên trong danh sách (hoặc ngôn ngữ mặc định nếu danh sách rỗng), ngay cả khi ngôn ngữ đó không được hỗ trợ bởi trình thực thi.
Giá trị trả về
Một chuỗi mới biểu diễn chuỗi gọi được chuyển đổi sang chữ thường, theo các ánh xạ chữ hoa/thường đặc thù của từng ngôn ngữ.
Mô tả
Phương thức toLocaleLowerCase() trả về giá trị của chuỗi được chuyển đổi sang chữ thường theo các ánh xạ chữ hoa/thường đặc thù của từng ngôn ngữ. toLocaleLowerCase() không ảnh hưởng đến giá trị của bản thân chuỗi. Trong hầu hết các trường hợp, kết quả sẽ giống với toLowerCase(), nhưng với một số ngôn ngữ như tiếng Thổ Nhĩ Kỳ, có ánh xạ chữ hoa/thường không tuân theo ánh xạ mặc định trong Unicode, có thể có kết quả khác.
Ví dụ
>Sử dụng toLocaleLowerCase()
"ALPHABET".toLocaleLowerCase(); // 'alphabet'
"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false
const locales = ["tr", "TR", "tr-TR", "tr-u-co-search", "tr-x-turkish"];
"\u0130".toLocaleLowerCase(locales) === "i"; // true
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification> # sec-string.prototype.tolocalelowercase> |
| ECMAScript® 2026 Internationalization API Specification> # sup-string.prototype.tolocalelowercase> |