java.text
클래스 DecimalFormat

java.lang.Object 
  java.text.Format 
      java.text.NumberFormat 
          java.text.DecimalFormat

모든 구현된 인터페이스:

Serializable, Cloneable

public class DecimalFormat
extends NumberFormat 

DecimalFormat는 10 진수를 포맷 하는 NumberFormat 구상 서브 클래스입니다. DecimalFormat에는 서구, 아라비아 및 인도 숫자에 대한 지원를 포함한 여러가지 기능이 준비되어 있어 임의의 로케일로 수치의 해석과 포맷을 실행할 수 있도록 설계되고 있습니다. 또, 정수 (123), 고정 소수치 (123.4), 과학 표기법 (1.23E4), 퍼센트 (12%) 및 통화 금액 ($123)등이 다양한 종류의 수치도 지원 하고 있습니다. 이것들은 모두 지역 대응을 할 수 있습니다.

디폴트의 로케일등의 특정의 로케일의 NumberFormat를 취득하기 위해서는 getInstance() 등의 NumberFormat 팩토리 메서드의 1개를 호출합니다. 보통, NumberFormat 팩토리 메서드는 DecimalFormat 이외의 서브 클래스를 돌려주는 경우가 있기 때문에 DecimalFormat 생성자를 직접 호출하지 않습니다. 포맷 객체를 커스터마이즈 할 필요가 있는 경우는 다음과 같이 실행합니다.

 NumberFormat f = NumberFormat.getInstance(loc);
 if (f instanceof DecimalFormat) { ((DecimalFormat) f). setDecimalSeparatorAlwaysShown(true);
 } 

DecimalFormat는 패턴 및 기호세트로 구성됩니다. 패턴의 설정은 applyPattern()를 사용해 직접 행하는지, 또는 API 메서드를 사용해 간접적으로 실시합니다. 기호는 DecimalFormatSymbols 객체에 포함됩니다. NumberFormat 팩토리 메서드를 사용하고 있는 경우, 패턴과 기호는 지역 대응된 ResourceBundle로 부터 읽힙니다.

패턴

DecimalFormat 구문을 다음에 나타냅니다.

 Pattern: PositivePattern PositivePattern ;
 NegativePattern PositivePattern: Prefixopt Number Suffixopt NegativePattern: Prefixopt Number Suffixopt Prefix: 임의의 Unicode 문자 (\uFFFE, \uFFFF, 특수 문자를 제외하다) Suffix: 임의의 Unicode 문자 (\uFFFE, \uFFFF, 특수 문자를 제외하다) Number: Integer Exponentopt Integer .  Fraction Exponentopt Integer: MinimumInteger # # Integer #,
 Integer MinimumInteger: 0 0 MinimumInteger 0,
 MinimumInteger Fraction: MinimumFractionopt OptionalFractionopt MinimumFraction: 0 MinimumFractionopt OptionalFraction: # OptionalFractionopt Exponent: E MinimumExponent MinimumExponent: 0 MinimumExponentopt 

DecimalFormat 패턴에는 "#,##0. 00;(#,##0. 00)" 등의, 정과 부의 서브 패턴이 있습니다. 각 서브 패턴에는 접두사, 수치 부분 및 접미말이 1개 씩 있습니다. 부의 서브 패턴은 옵션입니다. 이 옵션을 설정하지 않는 경우는 지역 대응한 마이너스 기호 (대부분의 로케일에서는 '-')를 정의 서브 패턴에 접두사로서 붙이는 것으로 부의 서브 패턴으로서 사용합니다. 즉, 단독의 "0.00" 은 "0.00;-0. 00" 으로 등가가 됩니다. 명시적인 부의 서브 패턴이 있으면, 이것은 부의 접두사와 접미말을 지정하는 경우에만 기능합니다. 자리수, 최소 자리수 및 그 외의 특성은 모두 정의 패턴과 같습니다. 이것은 "#,##0. 0#;(#)" 는 "#,##0. 0#;(#,##0. 0#)" (와)과 정확하게 같은 결과가 되는 것을의미합니다.

접두사, 접미말 및 무한대, 자리수, 1000 단락지어 및 소수의 단락 문자 등에 사용하는 다양한 기호는 임의의 값으로 설정할 수 있어 포맷중에 올바르게 표시됩니다. 다만, 기호와 캐릭터 라인이 모순되지 않게 주의를 하지 않으면 해석은 신뢰성을 가지지 않습니다. 예를 들어, DecimalFormat.parse()로 정의 값과 잘못된 값을 구별할 수 있도록, 정과 부의 접두사나 접미말은 다를 필요가 있습니다. 동일하다라고, DecimalFormat는 부의 서브 패턴이 지정되어 있지 않은 것으로서 동작합니다. 다른 예로서 수치자리수 단락자와 1000 단락자에게는 다른 문자를 사용할 필요가 있습니다. 동일한 문자를 사용하면 해석이 불가능하게 됩니다.

그룹 단락자는 일반적으로 1000 마다 단락짓기 위해서 사용합니다만, 나라에 따라서는 10000 마다 사용하는 곳(중)도 있습니다. 그룹 단락의 사이즈란 100,000,000인 경우는 3, 1,0000,0000인 경우는 4와 같이, 그룹 단락 문자간의 일정한 자리수입니다. 복수의 그룹 단락 문자를 가지는 패턴을 지정하면, 마지막 단락 문자와 말미의 정수와의 사이가 이전 격으로서 사용됩니다. 따라서, "#,##,###,####" == "######,####" == "##,####,####" 됩니다.

특수 패턴 문자

패턴내가 많은 문자는 문자대로 취득됩니다. 이러한 문자는 해석중에 일치하면, 포맷중에 그대로 출력됩니다. 한편, 특수 문자는 다른 문자, 캐릭터 라인, 또는 문자의 클래스를 나타냅니다. 특수 문자는 접두사나 접미말에 리터럴로서 표시하는 경우는 특히 지시가 없는 한, 인용부호로 둘러쌀 필요가 있습니다.

다음에 리스트 하는 문자는 지역 대응되어 있지 않은 패턴으로 사용됩니다. 지역 대응되어 있지 않은 패턴에서는 대신에 이 포매터의 DecimalFormatSymbols 객체로부터 취득한 대응하는 문자를 사용하면, 이러한 문자는 특수한 상태는 아니게 됩니다. 2개의 예외는 지역 대응되어 있지 않은 통화 기호와 인용부호입니다.

기호	위치	지역 대응의 유무	의미
0	수치	있어	숫자
#	수치	있어	숫자. 제로라고 표시되지 않는다
.	수치	있어	수치자리수 단락자 또는 통화자리수 단락자
-	수치	있어	마이너스 기호
,	수치	있어	그룹 단락자
E	수치	있어	과학 표기법의 가수와 지수를 단락짓는다. 접두사나 접미말내에 인용부호를 붙일 필요는 없는
;	서브 패턴 경계	있어	정과 부의 서브 패턴을 단락짓는
%	접두사 또는 접미말	있어	100 배가 되어 퍼센트를 나타내는
\u2030	접두사 또는 접미말	있어	1000 배가 되어 퍼밀치를 나타내는
¤ (\u00A4)	접두사 또는 접미말	없음	통화 기호로 치환되는 통화 부호. 2개의 경우는 국제통화 기호로 치환된다. 패턴내에 있는 경우는 수치자리수 단락자가 아니고, 통화자리수 단락자가 사용되는
'	접두사 또는 접미말	없음	접두사나 접미말내의 특수 문자를 인용부호로 둘러싸는 경우에 사용되는. 예를 들어, "'#'#"를 사용하면 123 은 "#123"에 포맷된 다. 단일 인용부호 자체를 작성하기 위해서 합은 1 행에 2개 인용부호를 사용한다 ("# o''clock")

과학 표기법

과학 표기법의 수치는 가수와 10 누승의 결과로서 나타내집니다. 예를 들어 1234는 1.234 x 10^3 로서 나타내집니다. 가수의 상당수는 1.0 <= x <10.0 범위내입니다만, 반드시 이 범위내로 할 필요는 없습니다. DecimalFormat에는 패턴만을 개입시켜 과학 표기법을 포맷 및 해석하도록 지시할 수 있습니다. 현재, 과학 표기법형식을 작성하는 팩토리 메서드는 없습니다. 패턴에서는 지수 문자의 직후에 1개 이상의 숫자를 계속해 과학 표기법을 나타냅니다. 예를 들어 "0. ###E0"에 서는 1234는 "1.234E3"와 같이 포맷 됩니다.

• 지수 문자의 뒤의 숫자의 개수는 지수의 최소 자리수를 나타냅니다. 최대 자리수는 없습니다. 부의 지수는 패턴에 한 접두사나 접미말은 아니고, 지역 대응된 마이너스 기호를 사용해 포맷 됩니다. 이것에 의해 "0. ###E0 m/s" 등의 패턴이 허가됩니다.
• 정수의 최소 자리수와 최대 자리수는 동시에 해석됩니다.
  • 정수의 최대 자리수가 그 최소 자리수보다 크고, 1 보다 큰 경우, 지수는 정수의 최대 자리수의 배수가 되어, 정수의 최소 자리수는 1 으로서 해석됩니다. 이것은 기술 표기법의 경우에 자주 사용됩니다. 이 경우 지수는 "##0. #####E0" 등과 같이 3 배수가 됩니다. 이 패턴을 사용하면, 수치 12345는 "12.345E3"에 123456 은 "123.456E3"에 포맷 됩니다.
  • 그렇지 않은 경우, 정수의 최소 자리수는 지수를 조정하는 것에 의해 얻을 수 있습니다. 예를 들어 0.00123 은 "00. ###E0"를 사용해 "12.3E-4"로 포맷 됩니다.
• 가수의 유효 자리수는 최소 정수와 최대 소수의 자리수의 합계입니다. 유효 자리수는 정수의 최대 자리수에 영향을 받지 않습니다. 예를 들어 12345는 "##0. ##E0"를 사용해 "12.3E3"로 포맷 됩니다. 모든 자리수를 표시하는 경우는 유효 자리수를 제로로 설정해 주세요. 유효 자리수는 해석에 영향을 주지 않습니다.
• 지수 패턴에는 그룹 단락자가 포함되지 않는 경우가 있습니다.

둥근

DecimalFormat는 포맷에 바로 옆에의 둥근 (ROUND_HALF_EVEN를 참조)를 사용합니다.

숫자

DecimalFormat는 포맷에 DecimalFormatSymbols 객체로 정의되고 있는 지역 대응한 제로 숫자로 시작되는 10 개가 연속한 문자를 숫자로서 사용합니다. 해석에서는 이러한 숫자와 함께, Character.digit 정의에 한 모든 Unicode 10 진수를 인식합니다.

특수한 값

NaN는 단일의 문자 (일반적으로 \uFFFD)로서 포맷 됩니다. 이 문자는 DecimalFormatSymbols 객체에 의해 판정됩니다. 이것은 접두사와 접미말이 사용되지 않는 유일한 값입니다.

무한대는 단일 문자 (일반적으로\u221E)로서 포맷 되어 부 또는 정의 접두사 및 접미말이 적용됩니다. 무한대 문자는 DecimalFormatSymbols 객체에 의해 판정됩니다.

부의 제로 ("-0")는

• isParseBigDecimal()가 true 인 경우는 BigDecimal(0)와 해석되어
• isParseBigDecimal()가 false, isParseIntegerOnly()가 true 인 경우는 Long(0)와 해석되어
• isParseBigDecimal()와 isParseIntegerOnly()가 어느쪽이나 false 인 경우는 Double(-0. 0) 과 해석됩니다.

동기

decimal 포맷은 동기화 되지 않습니다. thread 마다 다른 포맷 인스턴스를 작성하는 것을 추천합니다. 복수의 thread가 포맷에 동시에 액세스 하는 경우는 외부적으로 동기화할 필요가 있습니다.

례

 // Print out a number using the localized number, integer, currency, // and percent format for each locale Locale[] locales = NumberFormat.getAvailableLocales();
 double myNumber = -1234. 56;
 NumberFormat form;
 for (int j=0;
 j<4;
 ++j) { System.out.println("FORMAT");
 for (int i = 0;
 i < locales.length;
 ++i) { if (locales[i]. getCountry(). length() == 0) { continue;
 // Skip language-only locales } System.out.print(locales[i]. getDisplayName());
 switch (j) { case 0:
 form = NumberFormat.getInstance(locales[i]);
 break;
 case 1:
 form = NumberFormat.getIntegerInstance(locales[i]);
 break;
 case 2:
 form = NumberFormat.getCurrencyInstance(locales[i]);
 break;
 default:
 form = NumberFormat.getPercentInstance(locales[i]);
 break;
 } if (form instanceof DecimalFormat) { System.out.print(":
 " + ((DecimalFormat) form). toPattern());
 } System.out.print(" -> " + form.format(myNumber));
 try { System.out.println(" -> " + form.parse(form.format(myNumber)));
 } catch (ParseException e) {} } } 

관련 항목:

Java Tutorial, NumberFormat, DecimalFormatSymbols, ParsePosition, 직렬화 된 형식

중첩(Nested) 클래스 개요

클래스 java.text. NumberFormat 로부터 상속된 중첩(Nested) 클래스/인터페이스

NumberFormat.Field

필드 개요

클래스 java.text. NumberFormat 로부터 상속된 필드

FRACTION_FIELD, INTEGER_FIELD

생성자 개요

DecimalFormat ()
디폴트 로케일에 대해서 디폴트의 패턴과 기호를 사용해 DecimalFormat를 작성합니다.

DecimalFormat (String pattern)
디폴트 로케일에 대해서 지정된 패턴과 기호를 사용해 DecimalFormat를 작성합니다.

DecimalFormat (String pattern, DecimalFormatSymbols symbols)
지정된 패턴과 기호를 사용해 DecimalFormat를 작성합니다.

메서드 개요

void	applyLocalizedPattern (String pattern) 지정된 패턴을 이 Format 객체에 적용합니다.
void	applyPattern (String pattern) 지정된 패턴을 이 Format 객체에 적용합니다.
Object	clone () 표준 오버라이드(override)입니다.
boolean	equals (Object obj) equals를 오버라이드(override) 합니다.
StringBuffer	format (double number, StringBuffer result, FieldPosition fieldPosition) double를 포맷의해 캐릭터 라인을 작성합니다.
StringBuffer	format (long number, StringBuffer result, FieldPosition fieldPosition) long를 포맷의해 캐릭터 라인을 작성합니다.
StringBuffer	format (Object number, StringBuffer toAppendTo, FieldPosition pos) 수치를 포맷 해, 그 결과의 텍스트가 지정된 캐릭터 라인 버퍼에 추가합니다.
AttributedCharacterIterator	formatToCharacterIterator (Object obj) Object를 포맷 해, AttributedCharacterIterator를 생성합니다.
Currency	getCurrency () 통화치의 포맷시에 이 10 진포맷이 사용하는 통화를 취득합니다.
DecimalFormatSymbols	getDecimalFormatSymbols () 수치자리수 단락 문자를 리턴합니다.
int	getGroupingSize () 그룹화 사이즈를 리턴합니다.
int	getMaximumFractionDigits () 수치의 소수 부분의 최대 자리수를 취득합니다.
int	getMaximumIntegerDigits () 수치의 정수 부분의 최대 자리수를 취득합니다.
int	getMinimumFractionDigits () 수치의 소수 부분의 최소 자리수를 취득합니다.
int	getMinimumIntegerDigits () 수치의 정수 부분의 최소 자리수를 취득합니다.
int	getMultiplier () 퍼센트, 퍼밀 (1000) 및 그 유사 포맷으로 사용하는 승수를 취득합니다.
String	getNegativePrefix () 부의 접두사를 취득합니다.
String	getNegativeSuffix () 부의 접미말을 취득합니다.
String	getPositivePrefix () 정의 접두사를 취득합니다.
String	getPositiveSuffix () 정의 접미말을 취득합니다.
int	hashCode () hashCode를 오버라이드(override) 합니다.
boolean	isDecimalSeparatorAlwaysShown () 정수와 구별하는 소수점의 동작을 취득합니다 (소수정도에서는 소수점이 항상 표시된다).
boolean	isParseBigDecimal () parse(java.lang.String, java.text.ParsePosition) 메서드가 BigDecimal를 돌려줄지 어떨지를 판정합니다.
Number	parse (String text, ParsePosition pos) 캐릭터 라인으로부터 텍스트를 해석해 Number를 생성합니다.
void	setCurrency (Currency currency) 통화치의 포맷시에 이 수치 포맷이 사용하는 통화를 설정합니다.
void	setDecimalFormatSymbols (DecimalFormatSymbols newSymbols) 수치자리수 단락 문자를 설정합니다.
void	setDecimalSeparatorAlwaysShown (boolean newValue) 정수와 구별하는 소수점의 동작을 설정합니다 (소수정도에서는 소수점이 항상 표시된다).
void	setGroupingSize (int newValue) 그룹화 사이즈를 설정합니다.
void	setMaximumFractionDigits (int newValue) 수치의 소수 부분의 최대 자리수를 설정합니다.
void	setMaximumIntegerDigits (int newValue) 수치의 정수 부분의 최대 자리수를 설정합니다.
void	setMinimumFractionDigits (int newValue) 수치의 소수 부분의 최소 자리수를 설정합니다.
void	setMinimumIntegerDigits (int newValue) 수치의 정수 부분의 최소 자리수를 설정합니다.
void	setMultiplier (int newValue) 퍼센트, 퍼밀 (1000) 및 그 유사 포맷으로 사용하는 승수를 설정합니다.
void	setNegativePrefix (String newValue) 부의 접두사를 설정합니다.
void	setNegativeSuffix (String newValue) 부의 접미말을 설정합니다.
void	setParseBigDecimal (boolean newValue) parse(java.lang.String, java.text.ParsePosition) 메서드가 BigDecimal를 돌려줄지 어떨지를 설정합니다.
void	setPositivePrefix (String newValue) 정의 접두사를 설정합니다.
void	setPositiveSuffix (String newValue) 정의 접미말을 설정합니다.
String	toLocalizedPattern () 이 Format 객체의 현재 상태를 나타내는 지역 대응된 패턴 캐릭터 라인을 종합 합니다.
String	toPattern () 이 Format 객체의 현재 상태를 나타내는 패턴 캐릭터 라인을 종합 합니다.

클래스 java.text. NumberFormat 로부터 상속된 메서드

format, format, getAvailableLocales, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setGroupingUsed, setParseIntegerOnly

클래스 java.text. Format 로부터 상속된 메서드

format, parseObject

클래스 java.lang. Object 로부터 상속된 메서드

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

생성자 상세

DecimalFormat

public DecimalFormat()

디폴트 로케일에 대해서 디폴트의 패턴과 기호를 사용해 DecimalFormat를 작성합니다. 이것은 국제화가 주요한 문제가 아닌 경우에 DecimalFormat를 얻기 위한 간단한 방법입니다.

지정된 로케일에 대한 표준 포맷을 얻으려면, getNumberInstance 등, NumberFormat 팩토리 메서드를 사용해 주세요. 이러한 팩토리 메서드는 지정된 로케일에 대한 NumberFormat 최적인 서브 클래스를 리턴합니다.

관련 항목:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()

DecimalFormat

public DecimalFormat(String  pattern)

디폴트 로케일에 대해서 지정된 패턴과 기호를 사용해 DecimalFormat를 작성합니다. 이것은 국제화가 주요한 문제가 아닌 경우는 DecimalFormat를 얻기 위해서는 간단한 방법입니다.

지정된 로케일에 대한 표준 포맷을 얻으려면, getNumberInstance 등, NumberFormat 팩토리 메서드를 사용해 주세요. 이러한 팩토리 메서드는 지정된 로케일에 대한 NumberFormat 최적인 서브 클래스를 리턴합니다.

파라미터:

pattern - 비지역 대응의 패턴 캐릭터 라인

예외:

NullPointerException - pattern가 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

관련 항목:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()

DecimalFormat

public DecimalFormat(String  pattern,
                     DecimalFormatSymbols  symbols)

지정된 패턴과 기호를 사용해 DecimalFormat를 작성합니다. 포맷의 동작을 완전하게 커스터마이즈 할 필요가 있는 경우에는 이 생성자를 사용해 주세요.

지정된 로케일에 대한 표준 포맷을 얻으려면, getInstance 나 getCurrencyInstance 등, NumberFormat 팩토리 메서드를 사용해 주세요. 표준 포맷을 조금 조정하는 것 뿐이라면, NumberFormat 팩토리 메서드로 리턴된 포맷을 수정할 수 있습니다 .

파라미터:

pattern - 비지역 대응의 패턴 캐릭터 라인

symbols - 사용하는 기호 세트

예외:

NullPointerException - 지정된 인수가 1개에 서도 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

관련 항목:

NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance(), DecimalFormatSymbols

메서드의 상세

format

public final StringBuffer  format(Object  number,
                                 StringBuffer  toAppendTo,
                                 FieldPosition  pos)

수치를 포맷 해, 그 결과의 텍스트가 지정된 캐릭터 라인 버퍼에 추가합니다. 지정 가능한 수치는 Number 임의의 서브 클래스입니다.

이 구현은 최대 허용 정밀도를 사용합니다.

오버라이드(override):

클래스 NumberFormat 내의 format

파라미터:

number - 포맷 하는 수치

toAppendTo - 포맷 후의 텍스트를 추가하는 StringBuffer

pos - 입력의 경우는 위치 맞춤 필드 (필요한 경우). 출력의 경우는 위치 맞춤 필드의 오프셋(offset)

반환값:

toAppendTo로 서 건네받은 값

예외:

IllegalArgumentException - number가 null, 또는 Number 인스턴스가 아닌 경우

NullPointerException - toAppendTo 또는 pos가 null인 경우

관련 항목:

FieldPosition

format

public StringBuffer  format(double number,
                           StringBuffer  result,
                           FieldPosition  fieldPosition)

double를 포맷의해 캐릭터 라인을 작성합니다.

정의:

클래스 NumberFormat 내의 format

파라미터:

number - 포맷 하는 double

result - 텍스트를 추가하는 위치

fieldPosition - 입력의 경우는 위치 맞춤 필드 (필요한 경우). 출력의 경우는 위치 맞춤 필드의 오프셋(offset)

반환값:

포맷된 수치 캐릭터 라인

관련 항목:

FieldPosition

format

public StringBuffer  format(long number,
                           StringBuffer  result,
                           FieldPosition  fieldPosition)

long를 포맷의해 캐릭터 라인을 작성합니다.

정의:

클래스 NumberFormat 내의 format

파라미터:

number - 포맷 하는 long

result - 텍스트를 추가하는 위치

fieldPosition - 입력의 경우는 위치 맞춤 필드 (필요한 경우). 출력의 경우는 위치 맞춤 필드의 오프셋(offset)

반환값:

포맷된 수치 캐릭터 라인

관련 항목:

FieldPosition

formatToCharacterIterator

public AttributedCharacterIterator  formatToCharacterIterator(Object  obj)

Object를 포맷 해, AttributedCharacterIterator를 생성합니다. 리턴된 AttributedCharacterIterator를 사용하면, 결과의 String를 구축할 수 있는 것과 동시에 결과의 String에 대한 정보를 판정할 수 있습니다.

AttributedCharacterIterator 각 속성 키는 NumberFormat.Field 형입니다. 속성값는 속성 키와 동일합니다.

오버라이드(override):

클래스 Format 내의 formatToCharacterIterator

파라미터:

obj - 포맷 하는 객체

반환값:

포맷된 값을 설명하는 AttributedCharacterIterator

예외:

NullPointerException - obj가 null인 경우

IllegalArgumentException - 지정된 객체를 Format 로 포맷 할 수 없는 경우

도입된 버전 :

1.4

parse

public Number  parse(String  text,
                    ParsePosition  pos)

캐릭터 라인으로부터 텍스트를 해석해 Number를 생성합니다.

메서드는 pos에 의해 지정된 인덱스를 개시 위값으로 텍스트의 해석을 시도합니다. 해석이 완료하면, pos 인덱스는 사용된 마지막 문자 (해석에서는 캐릭터 라인의 끝까지의 모든 문자를 사용할 필요는 없다)의 뒤의 인덱스에 갱신되어 해석된 수값이 리턴됩니다 . 갱신된 pos는 이 메서드의 다음의 호출의 개시점을 나타내는데 사용할 수 있습니다. 에러가 발생했을 경우는 pos 인덱스는 변경되지 않고, 에러가 발생한 문자의 인덱스에 pos 에러 인덱스가 설정되어 null이 리턴됩니다 .

반환값의 서브 클래스는 isParseBigDecimal() 값과 해석 대상 캐릭터 라인에 의해 정해집니다.

• isParseBigDecimal()가 false (기본값)의 경우, 정수값 의 대부분은 그 기술 형식에 관계없이, Long 객체로서 리턴됩니다 . "17" 으로 "17.000" 은 어느쪽이나, Long(17)로 서 해석됩니다. Long에 들어맞지 않는 값은 Double로 서 리턴됩니다 . 이것에는 소수 부분을 가지는 값, 무한대의 값, NaN 및 값 「-0. 0」등이 포함됩니다. DecimalFormat는 Double, Long 머지않아를 돌려줄까를, 소스 캐릭터 라인내에서의 소수 단락 문자의 유무로 판단하는 것은 아닙니다. 만일 그러한 경우는 "-9, 223,372,036,854,775,808.00" 등의 double 가수를 오버플로우 하는 정수를, 정확하게 해석할 수 없게 됩니다.

  호출원래는 Number 메서드 doubleValue 나 longValue를 이용하는 것으로 값을 필요한 형태로서 취득할 수 있습니다.

• isParseBigDecimal()가 true인 경우, 값은 BigDecimal 객체로서 리턴됩니다 . 이 값은 로케일비의존 형식의 대응하는 캐릭터 라인에 대해서 BigDecimal.BigDecimal(String) 에 의해 구축되는 값입니다. 다만, 특수한 값 (정부의 무한대나 NaN 등)은 대응하는 Double 정수값을 포함한 Double인스턴스로서 리턴됩니다 .

DecimalFormat는 Character.digit()로 정의되고 있는 10 진수자를 나타내는 모든 Unicode 문자를 해석합니다. 또한 DecimalFormat는 DecimalFormatSymbols 객체로 정의되고 있는 지역 대응한 제로 숫자로 시작되는 10 개가 연속한 문자를 숫자로서 인식합니다.

정의:

클래스 NumberFormat 내의 parse

파라미터:

text - 해석되는 캐릭터 라인

pos - 상기의 인덱스 및 에러 인덱스 정보를 가지는 ParsePosition 객체

반환값:

해석된 값. 해석이 실패했을 경우는 null

예외:

NullPointerException - text 또는 pos가 null인 경우

관련 항목:

NumberFormat.isParseIntegerOnly(), Format.parseObject(java.lang.String, java.text.ParsePosition)

getDecimalFormatSymbols

public DecimalFormatSymbols  getDecimalFormatSymbols()

수치자리수 단락 문자를 리턴합니다. 이것은 보통, 프로그래머나 사용자에 의해 변경되지 않습니다.

반환값:

필요한 DecimalFormatSymbols

관련 항목:

DecimalFormatSymbols

setDecimalFormatSymbols

public void setDecimalFormatSymbols(DecimalFormatSymbols  newSymbols)

수치자리수 단락 문자를 설정합니다. 이것은 보통, 프로그래머나 사용자에 의해 변경되지 않습니다.

파라미터:

newSymbols - 필요한 DecimalFormatSymbols

관련 항목:

DecimalFormatSymbols

getPositivePrefix

public String  getPositivePrefix()

정의 접두사를 취득합니다.

예: +123,$123, sFr123

setPositivePrefix

public void setPositivePrefix(String  newValue)

정의 접두사를 설정합니다.

예: +123,$123, sFr123

getNegativePrefix

public String  getNegativePrefix()

부의 접두사를 취득합니다.

예: -123, ($123) (부의 접미말첨부), sFr-123

setNegativePrefix

public void setNegativePrefix(String  newValue)

부의 접두사를 설정합니다.

예: -123, ($123) (부의 접미말첨부), sFr-123

getPositiveSuffix

public String  getPositiveSuffix()

정의 접미말을 취득합니다.

예: 123%

setPositiveSuffix

public void setPositiveSuffix(String  newValue)

정의 접미말을 설정합니다.

예: 123%

getNegativeSuffix

public String  getNegativeSuffix()

부의 접미말을 취득합니다.

예: -123%, ($123) (정의 접미말첨부)

setNegativeSuffix

public void setNegativeSuffix(String  newValue)

부의 접미말을 설정합니다.

예: 123%

getMultiplier

public int getMultiplier()

퍼센트, 퍼밀 (1000) 및 그 유사 포맷으로 사용하는 승수를 취득합니다.

관련 항목:

setMultiplier(int)

setMultiplier

public void setMultiplier(int newValue)

퍼센트, 퍼밀 (1000) 및 그 유사 포맷으로 사용하는 승수를 설정합니다. 퍼센트에서는 승수로서 100을 접미말로서 %를 설정합니다 (아라비아어에서는 다른 퍼센트 기호를 사용한다). 퍼밀에서는 승수로서 1000을 접미말로서 '\u2030'를 설정합니다.

예: 승수 100인 경우, 1.23 포맷 결과는 "123","123" 해석 결과는 1.23 이 된다

관련 항목:

getMultiplier()

getGroupingSize

public int getGroupingSize()

그룹화 사이즈를 리턴합니다. 그룹화 사이즈란 수치의 정수 부분에 있어서의 단락 문자와 단락지어 문자의 사이의 자리수입니다. 예를 들어 수치 123,456.78인 경우, 그룹화 사이즈는 3 입니다.

관련 항목:

setGroupingSize(int), NumberFormat.isGroupingUsed(), DecimalFormatSymbols.getGroupingSeparator()

setGroupingSize

public void setGroupingSize(int newValue)

그룹화 사이즈를 설정합니다. 그룹화 사이즈란 수치의 정수 부분에 있어서의 단락 문자와 단락지어 문자의 사이의 자리수입니다. 예를 들어 수치 123,456.78인 경우, 그룹화 사이즈는 3 입니다.
인수로서 건네받은 값은 바이트에 변환되기 때문에 정보가 없어질 가능성이 있습니다.

관련 항목:

getGroupingSize(), NumberFormat.setGroupingUsed(boolean), DecimalFormatSymbols.setGroupingSeparator(char)

isDecimalSeparatorAlwaysShown

public boolean isDecimalSeparatorAlwaysShown()

정수와 구별하는 소수점의 동작을 취득합니다 (소수정도에서는 소수점이 항상 표시된다).

예: Decimal ON: 12345 -> 12345. ; OFF: 12345 -> 12345

setDecimalSeparatorAlwaysShown

public void setDecimalSeparatorAlwaysShown(boolean newValue)

정수와 구별하는 소수점의 동작을 설정합니다 (소수정도에서는 소수점이 항상 표시된다).

예: Decimal ON: 12345 -> 12345. ; OFF: 12345 -> 12345

isParseBigDecimal

public boolean isParseBigDecimal()

parse(java.lang.String, java.text.ParsePosition) 메서드가 BigDecimal를 돌려줄지 어떨지를 판정합니다. 기본값는 false 입니다.

도입된 버전 :

1.5

관련 항목:

setParseBigDecimal(boolean)

setParseBigDecimal

public void setParseBigDecimal(boolean newValue)

parse(java.lang.String, java.text.ParsePosition) 메서드가 BigDecimal를 돌려줄지 어떨지를 설정합니다.

도입된 버전 :

1.5

관련 항목:

isParseBigDecimal()

clone

public Object  clone()

표준 오버라이드(override)입니다. 시멘틱스는 바뀌지 않습니다.

오버라이드(override):

클래스 NumberFormat 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

equals

public boolean equals(Object  obj)

equals를 오버라이드(override) 합니다.

오버라이드(override):

클래스 NumberFormat 내의 equals

파라미터:

obj - 비교 대상의 참조 객체

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

hashCode를 오버라이드(override) 합니다.

오버라이드(override):

클래스 NumberFormat 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

toPattern

public String  toPattern()

이 Format 객체의 현재 상태를 나타내는 패턴 캐릭터 라인을 종합 합니다.

관련 항목:

applyPattern(java.lang.String)

toLocalizedPattern

public String  toLocalizedPattern()

이 Format 객체의 현재 상태를 나타내는 지역 대응된 패턴 캐릭터 라인을 종합 합니다.

관련 항목:

applyPattern(java.lang.String)

applyPattern

public void applyPattern(String  pattern)

지정된 패턴을 이 Format 객체에 적용합니다. 패턴이란 각종의 포맷 특성에 대한 간략 사양입니다. 이러한 특성은 각 설정 기능 메서드로 개별적으로 변경할 수도 있습니다.

이 루틴으로 설정되는 정수의 자리수에 제한은 없습니다. 이것은 일반인 최종 사용자의 요망이기 때문에입니다. 실제의 값을 설정하고 싶은 경우는 setMaximumInteger를 사용해 주세요. 부의 수치의 경우는 세미콜론으로 단락지은 2번째의 패턴을 사용합니다.

예: "#,#00. 0#" -> 1,234.56

이것은 최소 2 자리수의 정수, 1개의 소수점, 최대 2 자리수의 소수를의미합니다.

예: "#,#00. 0#;(#,#00. 0#)" (부의 수치는 괄호로 둘러싼다)

부의 패턴에서는 최소와 최대의 자리수는 무시됩니다. 이것들은 정의 패턴으로 설정되는 것이라고 보여집니다.

예외:

NullPointerException - pattern가 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

applyLocalizedPattern

public void applyLocalizedPattern(String  pattern)

지정된 패턴을 이 Format 객체에 적용합니다. 이 패턴의 표기는 지역 대응되고 있는 것이라고 보여집니다. 패턴이란 각종의 포맷 특성에 대한 간략 사양입니다. 이러한 특성은 각 설정 기능 메서드로 개별적으로 변경할 수도 있습니다.

이 루틴으로 설정되는 정수의 자리수에 제한은 없습니다. 이것은 일반인 최종 사용자의 요망이기 때문에입니다. 실제의 값을 설정하고 싶은 경우는 setMaximumInteger를 사용해 주세요. 부의 수치의 경우는 세미콜론으로 단락지은 2번째의 패턴을 사용합니다.

예: "#,#00. 0#" -> 1,234.56

이것은 최소 2 자리수의 정수, 1개의 소수점, 최대 2 자리수의 소수를의미합니다.

예: "#,#00. 0#;(#,#00. 0#)" (부의 수치는 괄호로 둘러싼다)

부의 패턴에서는 최소와 최대의 자리수는 무시됩니다. 이것들은 정의 패턴으로 설정되는 것이라고 보여집니다.

예외:

NullPointerException - pattern가 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

setMaximumIntegerDigits

public void setMaximumIntegerDigits(int newValue)

수치의 정수 부분의 최대 자리수를 설정합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, newValue와 309 가운데 작은 편이 사용됩니다. 부의 입력치는 0 으로 옮겨집니다.

오버라이드(override):

클래스 NumberFormat 내의 setMaximumIntegerDigits

파라미터:

newValue - 정수의 최대 표시 자리수. 0 보다 작은 경우는 0 이 사용된다. 구상 서브 클래스에서는 이 값의 상한을 포맷 되는 수치의 종류에 적절한 값에 강제할 수 있는

관련 항목:

NumberFormat.setMaximumIntegerDigits(int)

setMinimumIntegerDigits

public void setMinimumIntegerDigits(int newValue)

수치의 정수 부분의 최소 자리수를 설정합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, newValue와 309 가운데 작은 편이 사용됩니다. 부의 입력치는 0 으로 옮겨집니다.

오버라이드(override):

클래스 NumberFormat 내의 setMinimumIntegerDigits

파라미터:

newValue - 정수의 최소 표시 자리수. 0 보다 작은 경우는 0 이 사용된다. 구상 서브 클래스에서는 이 값의 상한을 포맷 되는 수치의 종류에 적절한 값에 강제할 수 있는

관련 항목:

NumberFormat.setMinimumIntegerDigits(int)

setMaximumFractionDigits

public void setMaximumFractionDigits(int newValue)

수치의 소수 부분의 최대 자리수를 설정합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, newValue와 340 가운데 작은 편이 사용됩니다. 부의 입력치는 0 으로 옮겨집니다.

오버라이드(override):

클래스 NumberFormat 내의 setMaximumFractionDigits

파라미터:

newValue - 소수점의 최대 표시 자리수. 0 보다 작은 경우는 0 이 사용된다. 구상 서브 클래스에서는 이 값의 상한을 포맷 되는 수치의 종류에 적절한 값에 강제할 수 있는

관련 항목:

NumberFormat.setMaximumFractionDigits(int)

setMinimumFractionDigits

public void setMinimumFractionDigits(int newValue)

수치의 소수 부분의 최소 자리수를 설정합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, newValue와 340 가운데 작은 편이 사용됩니다. 부의 입력치는 0 으로 옮겨집니다.

오버라이드(override):

클래스 NumberFormat 내의 setMinimumFractionDigits

파라미터:

newValue - 소수점의 최소 표시 자리수. 0 보다 작은 경우는 0 이 사용된다. 구상 서브 클래스에서는 이 값의 상한을 포맷 되는 수치의 종류에 적절한 값에 강제할 수 있는

관련 항목:

NumberFormat.setMinimumFractionDigits(int)

getMaximumIntegerDigits

public int getMaximumIntegerDigits()

수치의 정수 부분의 최대 자리수를 취득합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, 이 반환값과 309 가운데 작은 편이 사용됩니다.

오버라이드(override):

클래스 NumberFormat 내의 getMaximumIntegerDigits

관련 항목:

setMaximumIntegerDigits(int)

getMinimumIntegerDigits

public int getMinimumIntegerDigits()

수치의 정수 부분의 최소 자리수를 취득합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, 이 반환값과 309 가운데 작은 편이 사용됩니다.

오버라이드(override):

클래스 NumberFormat 내의 getMinimumIntegerDigits

관련 항목:

setMinimumIntegerDigits(int)

getMaximumFractionDigits

public int getMaximumFractionDigits()

수치의 소수 부분의 최대 자리수를 취득합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, 이 반환값과 340 가운데 작은 편이 사용됩니다.

오버라이드(override):

클래스 NumberFormat 내의 getMaximumFractionDigits

관련 항목:

setMaximumFractionDigits(int)

getMinimumFractionDigits

public int getMinimumFractionDigits()

수치의 소수 부분의 최소 자리수를 취득합니다. BigInteger 객체 및 BigDecimal 객체 이외의 수치를 포맷 하는 경우, 이 반환값과 340 가운데 작은 편이 사용됩니다.

오버라이드(override):

클래스 NumberFormat 내의 getMinimumFractionDigits

관련 항목:

setMinimumFractionDigits(int)

getCurrency

public Currency  getCurrency()

통화치의 포맷시에 이 10 진포맷이 사용하는 통화를 취득합니다. 이 통화는 이 수치 포맷의 기호에 대해서 DecimalFormatSymbols.getCurrency를 호출하는 것으로 취득됩니다.

오버라이드(override):

클래스 NumberFormat 내의 getCurrency

반환값:

이 10 진포맷으로 사용되는 통화, 또는 null

도입된 버전 :

1.4

setCurrency

public void setCurrency(Currency  currency)

통화치의 포맷시에 이 수치 포맷이 사용하는 통화를 설정합니다. 이것은 수치 포맷이 사용하는 최소 소수 자리수나 최대 소수 자리수를 갱신하는 것이 아닙니다. 이 통화는 이 수치 포맷의 기호에 대해서 DecimalFormatSymbols.setCurrency를 호출하는 것으로 설정됩니다.

오버라이드(override):

클래스 NumberFormat 내의 setCurrency

파라미터:

currency - 이 10 진포맷으로 사용하는 새로운 통화

예외:

NullPointerException - currency가 null인 경우

도입된 버전 :

1.4