String.prototype.toLocaleUpperCase()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
toLocaleUpperCase()
메서드는 어떤 지역 특정 대/소문자 매핑에 따른 대문자로 변환된 문자열 값을 반환합니다.
시도해보기
구문
toLocaleUpperCase()
toLocaleUpperCase(locales)
매개변수
locales
Optional-
BCP 47 언어 태그가 있는 문자열 또는 이런 문자열을 가진 배열. 어떤 지역 특정 대/소문자 매핑에 따른 대문자로 변환하는데 사용된 지역을 나타냅니다. 일반 양식과
locales
인수의 설명에 대해서 Locale identification and negotiation를 참조하세요.
반환 값
어떤 지역 특정 대/소문자 매핑에 따른 대문자로 변환된 문자열을 나타낸 새 문자열.
예외
locale
인수가 올바른 언어 태그가 아닌 경우RangeError
("잘못된 언어 태그: xx_yy")가 발생합니다.- 배열 요소가 문자열 유형이 아닌 경우
TypeError
("지역 인수에 있는 잘못된 요소")가 발생합니다.
설명
theLocaleUpperCase()
메서드는 지역 특정 대/소문자 맴핑에 따른 대문자로 변환된 문자열 값을 반환합니다. toLocaleUpperCase()
는 문자열 자체 값에 영향을 미치지 않습니다. 대부분의 경우, toUpperCase()
와 같은 결과를 제공하지만 터키와 같은 일부 지역에서는 대/소문자 매핑이 유니코드의 기존 대/소문자 매핑을 따르지 않아 다른 결과가 있을 수 있습니다.
또한 대문자로 변환될 때 어떤 문자는 두 개 (혹은 그 이상) 문자를 생성할 수 있으므로 변환이 반드시 1:1 문자 맴핑일 필요는 없다는 것을 알아야 합니다. 그러므로 문자열 결과 길이는 입력 길이와 다를 수 있습니다. 이것은 또한 변환이 안정적이지 않음을 의미합니다. 즉, 구문 x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()
는 false
를 반환할 수 있습니다.
예제
toLocaleUpperCase() 사용
"alphabet".toLocaleUpperCase(); // 'ALPHABET'
"Gesäß".toLocaleUpperCase(); // 'GESÄSS'
"i\u0307".toLocaleUpperCase("lt-LT"); // 'I'
const locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"];
"i\u0307".toLocaleUpperCase(locales); // 'I'
명세서
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.tolocaleuppercase |
ECMAScript Internationalization API Specification # sup-string.prototype.tolocaleuppercase |
브라우저 호환성
BCD tables only load in the browser