NATIVE

settings_applicationsObject  >   settings_applicationsIntl  >   settings_applicationsIntl.NumberFormat  >   settings_applications[[Prototype]]

NATIVE

Editing
  • account_tree
  • bug_report

ArrayformatRangeToPartsformatRangeToParts(BigInt, NumberstartRange, BigInt, NumberendRange)

Intl.NumberFormat 객체에 의해 생성된 형식화된 숫자 범위의 각 부분을 나타내는 지역별 토큰 배열을 반환한다.

구문

형식
numberFormat.formatRangeToParts(start, end)

매개 변수

BigInt, NumberstartRange필수

범위의 시작값을 지정한다.

BigInt, NumberendRange필수

범위의 종료값을 지정한다.

반환

ArrayformatRangeToParts

인수로 지정된 숫자 범위의 각 부분을 나타내는 지역별 토큰을 포함한 객체를 원소로 갖는 배열을 반환한다.

type 속성에 가능한 값은 다음과 같다.

  • currency : currencyDisplay에 따른 기호("$", "€" 등) 또는 이름("dollar", "euro" 등)을 나타내는 문자열이다.
  • decimal : 소수 구분 기호 문자열(".")이다.
  • fraction : 분수 형식의 숫자이다.
  • group : 그룹 구분자 문자열(",")이다.
  • infinity : 무한대 문자열("∞")이다.
  • integer : 정수이다.
  • literal : 형식이 지정된 숫자의 모든 리터럴 문자열 또는 공백이다.
  • minusSign : 빼기 기호 문자열("-")이다.
  • nan : NaN을 나타내는 문자열이다.
  • plusSign : 더하기 기호 문자열("+")이다.
  • percentSign : 백분율 기호 문자열("%")이다.
  • unit : unitDisplay에서 지정된 방식에 따른 단위 문자열이다.

source 속성에 가능한 값은 다음과 같다.

  • startRange : 범위의 시작이다.
  • endRange : 범위의 끝이다.
  • shared : 범위에서 공유되는 구분 기호, 통화 등이다.

다음 예외가 발생할 수 있다.

RangeError
매개변수로 지정된 값이 하나라도 NaN인 경우에 발생한다.
TypeError
범위가 정상적으로 지정되지 않은 경우 발생한다.

Exception

RangeError

어떤 값이 집합 구조에 없거나 허용되는 범위가 아닐 때 오류를 다루는 객체이다.

TypeError

동적 타입의 값이 흐름상 맞지 않는 자료형이라 연산을 할 수 없을 때 발생하는 오류를 다루는 객체이다.

버전 명세

ECMAScript Internationalization API Specification
#sec-intl.numberformat.prototype.formatrangetoparts

지원 웹브라우저