NATIVE

settings_applicationsObject  >   settings_applicationsIntl  >   settings_applicationsIntl.NumberFormat  >   settings_applicationsConstructor

NATIVE

Editing
  • account_tree
  • bug_report

Intl.NumberFormatnumberFormatIntl.NumberFormat([ string, Arraylocales[ , Objectoptions]])

새로운 Intl.NumberFormat 객체를 생성하여 반환한다. new 연산자를 사용하거나 사용하지 않고도 생성자를 호출할 수 있다.

구문

형식
Init.NumberFormat([locales[, optoins]])

매개 변수

string, Arraylocales선택

BCP 47 언어 태그가 있는 문자열 또는 이러한 식별값을 원소로 가진 배열을 지정한다.

다음의 유니코드 확장키가 허용된다.

nu
번호 매기기 시스템으로서 가능한 값은 다음과 같다.
"adlm", "ahom","arab","arabext","bali", "beng", "bhks", "brah", "cakm", "cham", "deva","diak","fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp","java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho" 
Objectoptions선택

다음 속성을 한 개 이상 가진 객체를 지정한다.

compactDisplay
notation이 "compact"인 경우에만 사용된다. "short"(기본값) 또는 "long" 문자열 값을 가질 수 있다.
currency
통화 형식을 나타낸다. 예를 들어서 "USD"(미국), "EUR"(유로)와 같은 ISO 4217 통화 코드를 지정한다. style이 "currency"인 경우에 이 값을 지정해야 한다.
currencyDisplay
통화 형식으로 통화를 표시하는 방법을 지정한다. 기본값은 "symbol"이다.
  • "symbol" : €와 같은 현지화된 통화 기호를 나타낸다.
  • "narrowSymbol" : 예를 들어서 "US$10"의 표시를 "$10"으로 표시한다.
  • "code" : ISO 통화 코드를 사용한다.
  • "name" : "dollar"와 같은 현지화된 통화 이름을 사용한다.
currencySign
음수 기호 대신에 숫자를 괄호로 묶어서 표시하는 "accounting" 또는 표준으로 표시하는 "standard"를 지정할 수 있다. 기본값은 "standard"이다.
localeMatcher
사용할 지역 일치 알고리즘을 다음 중에서 선택할 수 있다.
  • "lookup"
  • "best fit" : 기본 값
notation
숫자를 표시하는 형식이다.
  • "standard" : 일반 숫자 형식을 나타낸다.
  • "scientific" : 크기 순서가 있는 형식화된 숫자를 나타낸다.
  • "engineering" : 3으로 나눌 때 10의 지수를 나타낸다.
  • "compact" : 지수를 나타내는 문자열이며 기본값으로 "short" 형식을 사용한다.
numberingSystem
번호 매기기 시스템을 나타내며 가능한 값은 다음과 같다. 사용되는 값에 대한 자세한 내용은 getNumberingSystems()를 참고한다.
"arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt"
signDisplay
숫자에 부호를 표시하는 방식를 나타낸다. 기본값은 "auto"이다.
  • "auto" : 음수 0을 포함하여 음수에 대해서만 부호를 표시한다.
  • "always" : 항상 부호를 표시한다.
  • "outZero" : 0을 제외한 양수와 음수에 부호를 표시한다.
  • "negative" : 음수 0을 제외한 음수에서만 부호를 표시한다.
  • "never" : 부호를 표시하지 않는다.
style
서식 스타일을 지정한다. 기본값은 "decimal"(십진수)이다.
  • "decimal" : 일반 숫자 형식을 나타낸다.
  • "currency" : 통화 형식을 나타낸다.
  • "percent" : 백분율 형식을 나타낸다.
  • "unit" : 단위 형식을 나타낸다.
unit
단위 형식에 사용할 단위를 지정한다.
unitDisplay
단위 형식 스타일을 지정한다. 기본값은 "short"이다.
  • "long" : (예) 10litres
  • "short" : (예) 10l
  • "narrow"
useGrouping
천 단위 구분 기호 등 그룹화 구분 기호를 사용할지에 대한 여부를 나타낸다. 기본값은 "auto"이다.
  • "always" : 항상 사용한다.
  • "auto" : 지역 기본 설정에 따라 그룹 구분 기호를 사용한다. 통화에 따라 달라질 수 있다.
  • false : 그룹 구분 기호를 사용하지 않는다.
  • "min2" : 그룹에 최소 2자리 숫자가 있는 경우 그룹 구분 기호를 사용한다.
  • true : "always"의 별칭이다.
roundingMode
반올림 모드에 대한 옵션을 지정한다.
  • "ceil" : +∞ 방향으로 반올림을 한다. 양수는 반올림, 음수는 양수쪽으로 반올림한다.
  • "floor" :  -∞ 방향으로 반올림을 한다. 양수는 내림, 음수는 음수쪽으로 반올림한다.
  • "expand" :  0에서 멀어지도록 반올림한다. 값의 크기는 반올림을 하여 증가한다. 음수는 음수쪽으로 반올림한다.
  • "trunc" :  0의 방향으로 반올림한다. 값의 크기는 반올림을 하여 감소한다. 양수는 반내림, 음수는 양수쪽으로 반올림한다.
  • "halfCeil" :  +∞ 방향으로 연결된다. 반증분 위의 값은 "ceil"처럼 반올림하고 아래의 값은 "floor"처럼 반올림한다. 반증분에서 값은 "ceil"과 같이 반올림된다.
  • "halfFloor" : -∞ 방향으로 연결된다. 반증분 위의 값은 "ceil"처럼 반올림하고 아래의 값은 "floor"처럼 반올림한다. 반증분에서 값은 "floor"과 같이 반올림된다.
  • "halfExpand" : 0 에서 멀어지도록 연결된다. 반증분 위의 값은 "expand"처럼 반올림하고 아래의 값은 "trunc"처럼 반올림한다. 반증분에서 값은 "expand"과 같이 반올림된다.
  • "halfTrunc" : 0과 가까워지도록 연결된다.  반증분 위의 값은  "expand"처럼 반올림하고 아래의 값은 "trunc"처럼 반올림한다. 반증분에서 값은 "trunc"처럼 반올림된다.
  • "halfEven" : 가장 가까운 짝수 정수로 연결한다. 반증분 위의 값은 "expand"처럼 반올림하고 그 아래의 값은 "trunc"처럼 반올림한다. 반증분 값은 가장 가까운 짝수 자리로 반올림된다.
roundingPriority
"FractionDigits"(minimumFractionDigits/maximumFractionDigits) 및 "SignificantDigits"(minimumSignificantDigits/maximumSignificantDigits)가 모두 지정된 경우 반올림 충돌을 해결하는 방법을 지정한다. 기본값은"auto"이다
  • "auto" : 유효 숫자 속성의 결과가 사용된다.
  • "morePrecision" : 더 높은 정밀도를 제공하는 속성의 결과가 사용된다.
  • "lessPrecision" : 정밀도가 떨어지는 속성의 결과가 사용된다.
"auto" 이외의 값에 대한 더 높은 정밀도의 결과가 maximumSignificantDigits와 maximumFractionDigits에서 계산된다.
roundingIncrement
반올림 증분 정밀도를 지정한다. 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, 5000 정수 중 하나이어야 한다. 계산된 반올림 크기를 기준으로 반올림이 발생해야 하는 증분을 나타낸다.
trailingZeroDisplay
정수 뒤에 오는 0을 표시하는 방식을 나타내는 문자열이다.
  • "auto" : minimumFractionDigits 및 minimumSignificantDigits에 따라 후행 0을 유지한다.
  • "stripIfInteger" : 분수가 모두 0인 경우 분수를 제거한다. 분수 자리 중 하나라도 0이 아니면 "auto"와 같다.
minimumIntegerDigits
사용할 최소 정수 자리수를 지정한다. 지정된 숫자보다 작은 정수 자리수를 가진 값은 형식화될 경우 지정된 길이만큼 왼쪽이 0으로 채워진다. 지정할 수 있는 값은 1~21까지이다. 기본값은 1이다.
minimumFractionDigits
사용할 최소 분수 자리수를 지정한다. 지정할 수 있는 값은 0~20이다. 일반 숫자와 백분율 형식의 기본값은 0이다. 통화 형식의 기본값은 ISO 4217 통화 코드 목록에서 제공하는 소수 단위 자리수이다.
maximumFractionDigits
사용할 최대 분수 자리수를 지정한다. 지정할 수 있는 값은 0~20이다. 일반 숫자 형식의 기본값은 maximumFractionDigits와 3 중 더 큰 값이다. 통화 형식의 기본값은 ISO 4217 통화 코드 목록에서 제공하는 minimumFractionDigits와 보조 단위 자리수 중 더 큰 값이다. 백분율 형식의 기본값은 maximumFractionDigits와 0 중 더 큰 값이다.
minimumSignificant
사용할 최소 유효 자리수를 지정한다. 지정할 수 있는 값은 1~21이다. 기본값은 1이다.
maximumSignificant
사용할 최대 유효 자리수를 지정한다. 지정할 수 있는 값은 1~21이다. 기본값은 21이다.

반환

Intl.NumberFormatnumberFormat

새로운 Intl.NumberFormat 객체를 반환한다.

다음과 같은 예외가 발생할 수 있다.

RangeError
다음의 경우 중에서 하나가 해당된다.
  • 열거된 값을 사용하는 속성이 잘못된 값으로 설정되었다.
  • maximumFractionDigits와 minimumFractionDigits가 모두 설정되어 있으며 서로 다른 값으로 설정이 되었다. 다양한 형식 지정 옵션에 따라 이러한 속성에 기본값이 있을 수 있다. 따라서 속성 중 하나만 설정한 경우에도 이 오류가 발생할 수 있다.
TypeError
style 속성이 "unit" 또는 "currency"로 설정되어 있는 데 해당 unit 또는 currency 속성에 값이 설정되어 있지 않은 경우 발생한다.

Exception

RangeError

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

TypeError

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

상속 계층 탐색

Function

  • Properties

    • arguments

      함수에 전달된 인수를 조회한다. 유사 배열로 참조되며 인덱스로 접근이 가능하다.

    • caller

      지정된 함수를 호출한 함수를 참조한다. strict 모드에서는 사용할 수 없다.

    • length

      함수에 사용 되고 있는 인수의 개수를 조회한다.

    • name

      함수 이름을 조회한다.

    • prototype

      생성자 함수(constructor function)에 의해 생성된 인스턴스(instance)에게 상속되어지는 생성자의 프로토타입을 나타낸다.

  • Methods

    • apply()

      지정된 this와 제공된 인수를 가진 배열 또는 유사 배열로 함수를 호출한다.

    • bind()

      원본 함수와 동일한 본문을 갖는 바인딩된 함수를 만든다. this 키워드가 있는 경우 실제로 자신을 참조할 수 있도록 활성화된다.

    • call()

      인수를 지정하여 함수를 호출한다.

    • toString()

      함수의 소스 코드를 반환한다.

Object

  • Methods

    • hasOwnProperty()

      객체가 특정 프로퍼티를 가지고 있는지를 블린(boolean) 값으로 반환한다.

    • isPrototypeOf()

      해당 객체가 다른 객체의 프로토타입 체인에 속한 객체인지를 체크한다.

    • propertyIsEnumerable()

      매개 변수의 속성이 열거가능(enumerable)한지 여부를 체크한다.

    • toLocaleString()

      객체를 나타내는 문자열을  작동하는 지역(locale)의 방식으로 출력이 된다.

    • toString()

      객체를 나타내는 문자열을 반환한다.

    • valueOf()

      객체의 원시(primitive) 값을 반환한다.

  • Properties

    • constructor

      객체의 생성자 함수를 참조한다.

    • __proto__

      상속된 [[Prototype]] 참조하거나 설정가능하며 일반적으로 실제 코드상에서는 잘 사용되지 않는다. ECMAScript에서 사용되지 않는 비표준이지만 최신 웹브라우저에서는 비공식적으로 지원하고 있다. 따라서 곧 표준 속성으로 지원될 확률이 높다.

      현재는 표준 사양에 명시되었다.

버전 명세

ECMAScript Internationalization API Specification
#sec-intl-numberformat-constructor

지원 웹브라우저

©2024 devdic.com, Korea

출처를 밝힌 리소스 이외의 본 레퍼런스에 사용된 모든 생성물의 소유 및 저작권은 devdic.com에 있습니다. 특별히 재배포를 금지한 것 이외는 재배포가 가능하며 반드시 출처를 표기해 주시기 바랍니다.
현재는 베타 버전으로 미등록 및 불완전한 콘텐츠가 일부 있을 수 있습니다. 오류 및 기술 자료 제보(건의)는 언제든지 환영하며 감사드립니다.
기본적으로 W3C 기술 사양을 기준으로 작성하였으며 일반적이지 않은 기술 설명에 대한 내용의 일부는 Mozilla의 MDN web docs에서 도움 받았음을 밝힙니다. 그들을 존경합니다.

master@cydemy.com