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() 메서드는 어떤 지역 특정 대/소문자 매핑에 따른 대문자로 변환된 문자열 값을 반환합니다.

시도해보기

구문

js
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() 사용

js
"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

같이 보기