Formatter (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 차의 클래스

프레임으로 프레임 없이

개요: 상자 | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.util
클래스 Formatter

java.lang.Object 
  java.util.Formatter

모든 구현된 인터페이스:: Closeable, Flushable

public final class Formatter
extends Object
implements Closeable, Flushable
extends Object
implements Closeable, Flushable

printf 형식의 캐릭터 라인용의 interpreter. 이 클래스는 행 가지런히 하고 및 수평 배치 레이아웃, 수치, 캐릭터 라인 및 날짜와 시간/시각 데이터용의 공통 서식, 로케일 고유의 출력을 지원 합니다. byte, BigDecimal 및 Calendar 등의 공통 Java 타입이 지원 됩니다. 임의의 사용자 타입용의 제한된 서식 커스터마이즈가Formattable 인터페이스를 개입시켜 제공됩니다.

multi-thread 액세스를 실행하는 경우, 포매터는 반드시 안전하지는 않습니다. thread의 안전성은 이 클래스의 메서드를 사용하는 사용자에 의해 옵션으로 보증됩니다.

Java 언어의 서식 첨부 출력은 C printf 영향을 크게 받고 있습니다. 서식 캐릭터 라인은 C를 닮아 있습니다만, Java 언어에 대응해, 그 기능을 활용하기 위해서 일부가 커스터마이즈 되고 있습니다. 또, Java 서식은 C 보다 엄밀합니다. 예를 들어 변환이 플래그와 호환성이 없는 경우, 예외가 발생 됩니다. C 에서는 적용 불가능한 플래그는 무시될 뿐입니다. 이 때문에 서식 캐릭터 라인은 C 프로그래머에게 친숙함이 있는 것이 되어 있습니다만, C와 의 완전한 호환성을 유지하고 있는 것은 아닙니다.

사용예:

   StringBuilder sb = new StringBuilder();
   // Send all output to the Appendable object sb
   Formatter formatter = new Formatter(sb, Locale.US);

   // Explicit argument indices may be used to re-order output.
   formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
   // -> " d  c  b  a"

   // Optional locale as the first argument can be used to get
   // locale-specific formatting of numbers.   The precision and width can be
   // given to round and align the value.
   formatter.format(Locale.FRANCE, "e = %+10. 4f", Math.E);
   // -> "e =    +2, 7183"

   // The '(' numeric flag may be used to format negative numbers with
   // parentheses rather than a minus sign.   Group separators are
   // automatically inserted.
   formatter.format("Amount gained or lost since last statement: $ %(,. 2f",
                    balanceDelta);
   // -> "Amount gained or lost since last statement: $ (6,217.58)"

일반적인 서식 설정 요구로 사용 가능한 편리한 메서드가 존재합니다. 다음에 그 호출예를 나타냅니다.

   // Writes a formatted string to System.out.
   System.out.format("Local time: %tT", Calendar.getInstance());
   // -> "Local time: 13:34:18"

   // Writes formatted output to System.err.
   System.err.printf("Unable to open file '%1$s': %2$s",
                     fileName, exception.getMessage());
   // -> "Unable to open file 'food': No such file or directory"

C sprintf(3)와 같게, static 메서드 String.format를 사용해 캐릭터 라인의 서식을 설정할 수 있습니다.

 // Format a string containing a date.  import java.util.Calendar;
 import java.util.GregorianCalendar;
 import static java.util.Calendar. *;
 Calendar c = new GregorianCalendar(1995, MAY, 23); String s = String.format("Duke's Birthday: %1$tm %1$te, %1$tY", c); // -> s == "Duke's Birthday: May 23, 1995"

구성

이 사양은 2개의 섹션으로 나눌 수 있습니다. 최초의 「개요」섹션에서는 서식 설정의 기본적인 개념을 취급합니다. 이 섹션은 이 클래스를 곧바로 이용하는 것을 바라는 다른 프로그램 언어에서의 서식 첨부 출력에 익숙한 사용자를 대상으로 하고 있습니다. 계속되는「상세」섹션에서는 이 클래스에 고유의 구현의 상세를 설명합니다. 이 섹션은 보다 엄밀한 사양의 서식 설정을 필요로 하는 사용자를 대상으로 하고 있습니다.

개요

이 섹션에서는 서식 설정의 개요를 간결하게 설명합니다. 동작의 상세한 것에 대하여는 「상세」섹션을 참조하십시오.

서식 캐릭터 라인의 구문

서식 첨부의 출력을 생성하는 각 메서드에는 「서식 캐릭터 라인」과「인수 리스트」를 지정할 필요가 있습니다. 서식 캐릭터 라인은 String 로 이것에는 고정의 텍스트와 1개 이상이 파묻힌 「서식 지시자」를 포함할 수 있습니다 . 다음에 예를 나타냅니다.

 Calendar c = ...;
 String s = String.format("Duke's Birthday:
 %1$tm %1$te, %1$tY", c);

이 경우 서식 캐릭터 라인은 format 메서드의 최초의 인수입니다. 이것에는 인수의 처리 방법 및 텍스트내의 삽입 위치를 나타내는 3개의 서식 지시자 「%1$tm」, 「%1$te」 및 「%1$tY」가 포함됩니다. 서식 캐릭터 라인의 나머지의 부분은 고정 텍스트로 「Dukes Birthday: 」 및 다른 공백이나 구두점이 포함됩니다. 인수 리스트는 서식 캐릭터 라인의 후에 메서드에게 건네지는 모든 인수로 구성됩니다. 전술한 예에서는 인수 리스트의 사이즈는 1 으로 새로운달력 객체로 구성됩니다.

일반, 문자 및 수치형의 서식 지시자에서는 다음의 구문이 사용됩니다.
```
 %[argument_index$][flags][width][. precision]conversion 
```
옵션의 argument_index는 인수 리스트내에서의 인수의 위치를 나타내는 10 진정수입니다. 최초의 인수는 「1$」, 2번째의 인수는 「2$」으로 참조됩니다.
옵션의 flags는 출력 서식을 변경하는 문자세트입니다. 유효한 플래그세트는 변환에 따라서 다릅니다.
옵션의 width는 출력에 출력하는 최소 문자수를 나타내는 정의 10 진정수입니다.
옵션의 precision는 문자수를 제한하기 위해서 보통 사용되는 정의 10 진정수입니다. 그 동작은 변환에 따라서 다릅니다.
필수의 conversion는 인수를 서식 설정하는 방법을 나타냅니다. 지정된 인수로 유효한 변환 세트는 인수의 데이터형에 따라서 다릅니다.
날짜와 시간 및 시각표 실제로 사용하는 형태의 서식 지시자에서는 다음의 구문이 사용됩니다.
```
 %[argument_index$][flags][width]conversion 
```
옵션의 argument_index, flags 및 width 정의는 전술대로입니다.
필수의 conversion는 2개의 문자 순서입니다. 최초의 문자는 「t」또는 「T」. 2번째의 문자는 사용하는 서식을 나타냅니다. 이러한 문자는 GNU date 및 POSIX strftime(3c)로 정의된 문자와 유사하지만 완전하게 동일하지는 않습니다.
인수에 대응하지 않는 서식 지시자에서는 다음의 구문이 사용됩니다.
```
 %[flags][width]conversion 
```
옵션의 flags 및 width 정의는 전술대로입니다.
필수의 conversion는 출력에의 삽입 내용을 나타내는 문자입니다.

변환

변환은 다음의 카테고리로 나눌 수 있습니다.

일반 - 임의의 인수형에 적용된다
문자 - Unicode 문자를 나타내는 기본형 char, Character, byte, Byte, short 및 Short에 적용된다. Character.isValidCodePoint(int) 가 true를 돌려주는 경우, 이 변환은, int 및 Integer 형에도 적용된다
수치
1. 정수 - byte, Byte, short, Short, int, Integer, long, Long 및 BigInteger 등의 Java 정수형에 적용된다
2. 부동 소수점 - float, Float, double, Double 및 BigDecimal 등의 Java 부동 소수점형에 적용된다
일자/시각 - long, Long, Calendar 및 Date 등, 날짜와 시간 또는 시각의 인코딩이 가능한 Java 형에 적용된다
퍼센트 - 리터럴 「%」(\u0025)을 생성한다
행 단락 문자 - 플랫폼 고유의 행 단락 문자를 생성한다

다음의 겉(표)는 지원하는 변환을 요약한 것입니다. 대문자 (B, H, S, C, X, E, G, A 및 T 등)로 나타내진 변환은 각각의 소문자를 사용하는 변환과 같습니다만, 변환의 결과는 일반적으로 사용되고 있는 Locale 규칙에 따라 대문자에 변환됩니다. 결과는 다음의 String.toUpperCase()를 호출했을 경우와 같게 됩니다.


    out.toUpperCase()

변환	인수의 카테고리	설명
`b`, `B`	일반	인수 arg가 `null`인 경우, 결과는 `false`가 됩니다. arg가 `boolean` 또는 `Boolean` 인 경우, 결과는 `String.valueOf()` 에 의해 리턴된 캐릭터 라인이 됩니다. 그렇지 않은 경우, 결과는 true가 됩니다.
`h`, `H`	일반	인수 arg가 `null`인 경우, 결과는 `null`가 됩니다. 그렇지 않은 경우, 결과는 `Integer.toHexString(arg.hashCode())` 호출로 취득됩니다.
`s`, `S`	일반	인수 arg가 `null`인 경우, 결과는 `null`가 됩니다. arg가 `Formattable`를 구현하는 경우에 `arg.formatTo` 가 호출됩니다. 그렇지 않은 경우, 결과는 `arg.toString()` 호출로 취득됩니다.
`c`, `C`	문자	결과는 Unicode 문자입니다.
`'d'`	정수	결과는 10 진정수로서 서식 설정됩니다.
`'o'`	정수	결과는 8 진정수로서 서식 설정됩니다.
`'x'`, `'X'`	정수	결과는 16 진정수로서 서식 설정됩니다.
`'e'`, `'E'`	부동 소수점	결과는 부동 소수점 표시 형식의 10 진수로서 서식 설정됩니다.
`'f'`	부동 소수점	결과는 10 진수로서 서식 설정됩니다.
`g`, `G`	부동 소수점	결과는 사사오입 처리 후의 정밀도 및 값에 응해 부동 소수점 표시 형식 또는 10 진수 서식을 사용해 서식 설정됩니다.
`a`, `A`	부동 소수점	결과는 유효 숫자 및 지수를 가지는 부동 소수점수(실수)로서 서식 설정됩니다.
`t`, `T`	날짜와 시간/시각	날짜와 시간 및 시각 변환 문자용의 접두사. 「일자/시각 변환」을 참조하십시오.
`'%'`	퍼센트	결과는 리터럴 「`%`」(`\u0025`)이 됩니다.
`'n'`	행 단락 문자	결과는 플랫폼 고유의 행 단락 문자입니다.

변환으로서 명시적으로 정의되어 있지 않은 문자는 모두 부정하고, 장래의 기능확장에 대비해 예약되고 있습니다.

날짜와 시간/시각 변환

다음날 부 및 시각 변환 문자의 접미말이, t 및 T 변환용으로 정의되고 있습니다. 이 형태는 GNU date 및 POSIX strftime(3c)로 정의된 형태에 유사하고 있습니다만 완전하게 동일하지는 않습니다. 초내의 밀리 세컨드를 나타내는 L 등, Java 고유의 기능에 액세스하기 위한 추가의 변환형이 제공되고 있습니다.

시각의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'H'`	24 시간제때. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 23`).
`'I'`	12 시간제때. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 12`).
`'k'`	24 시간제때 (`0 - 23`)
`'l'`	12 시간제때 (`1 - 12`)
`'M'`	분. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 59`).
`'S'`	초. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 60`). 「`60`」은 윤년에서의 초의 지원에 필요한 특수한 값입니다.
`'L'`	밀리 세컨드. 필요에 따라서 0을 선두에 추가해, 3 자리수로 표현합니다 (`000 - 999`).
`'N'`	나노초. 필요에 따라서 0을 선두에 추가해, 9 자리수로 표현합니다 (`000000000 - 999999999`).
`'p'`	오전 또는 오후를 나타내는 로케일 고유의 소문자의 마커 (예, 「`am`」나 「`pm`」). 변환 접두사의 `T`를 사용하면, 결과는 대문자로 강제 출력됩니다.
`'z'`	RFC 822에 준거한, GMT 로부터의 수치 타임 존 오프셋(offset) (예, `-0800`)
`'Z'`	타임 존의 생략형을 나타내는 캐릭터 라인. Formatter 로케일은 인수의 로케일 (존재하는 경우)보다 우선됩니다.
`'s'`	1970 년 1 월 1 일 `00:00:00` UTC 신기원 개시부터의 초 (`Long.MIN_VALUE/1000`로 부터 `Long.MAX_VALUE/1000` 까지)
`'Q'`	1970 년 1 월 1 일 `00:00:00` UTC 신기원 개시부터의 밀리 세컨드 (`Long.MIN_VALUE`로 부터 `Long.MAX_VALUE` 까지)

날짜와 시간의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'B'`	로케일 고유의 달의 완전한 이름 (예, 「`January`」, 「`February`」)
`'b'`	로케일 고유의 달의 생략명 (예, 「`Jan`」, 「`Feb`」)
`'h'`	`'b'`와 같다
`'A'`	로케일 고유의 요일의 완전한 이름 (예, 「`Sunday`」, 「`Monday`」)
`'a'`	로케일 고유의 요일의 단축명 (예, 「`Sun`」, 「`Mon`」)
`'C'`	4 자리수의 해를 `100` 으로 나눈 값. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표시합니다 (`00 - 99`).
`'Y'`	해. 필요에 따라서 0을 선두에 추가해, 4 자리수 이상으로 표현합니다. 예를 들어, `0092`는 그레고리오력의 `92` CE와 같습니다.
`'y'`	해하 2 자리수. 필요에 따라서 0을 선두에 추가합니다 (`00 - 99`).
`'j'`	해의 며칠눈인지를 나타내는 날. 필요에 따라서 0을 선두에 추가해, 3 자리수로 표현합니다. 예를 들어 그레고리오력의 경우, `001 - 366` 이 됩니다.
`'m'`	달. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`01 - 13`).
`'d'`	달의 며칠눈인지를 나타내는 날. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`01 -31`).
`'e'`	달의 며칠눈인지를 나타내는 날. 최대 2 자리수로 표현합니다 (`1 - 31`).

일반의 날짜와 시간/시각 변환의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'R'`	「`%tH:%tM`로서 24 시간제로 서식 설정되었을 때 각
`'T'`	「`%tH:%tM:%tS`로서 24 시간제로 서식 설정되었을 때 각
`'r'`	「`%tI:%tM:%tS %Tp`로서 12 시간제로 서식 설정되었을 때 각. 오전 및 오후 마커 (`%Tp`)의 위치는 로케일에 의해 다릅니다.
`'D'`	「`%tm/%td/%ty`로서 서식 설정된 날짜와 시간
`'F'`	「`%tY-%tm-%td`로서 서식 설정된, ISO 8601에 준거한 날짜와 시간
`'c'`	「`%ta %tb %td %tT %tZ %tY`로서 서식 설정된 날짜와 시간 및 시각 (예, 「`Sun Jul 20 16:17:00 EDT 1969`」)

날짜와 시간/시각 변환의 접미말로서 명시적으로 정의되어 있지 않은 문자는 모두 부정하고, 장래의 기능확장에 대비해 예약되고 있습니다.

플래그

다음의 겉(표)에 지원 되는 플래그의 개요를 나타냅니다. y는 지정된 인수형으로 플래그가 지원 되는 것을의미합니다.

플래그	일반	문자	정수	부동 소수점	날짜와 시간/시각	설명
'-'	y	y	y	y	y	결과는 왼쪽 가지런히 하가 됩니다.
'#'	y¹	-	y³	y	-	결과는 변환에 의존된 대체 폼을 사용할 필요가 있습니다.
'+'	-	-	y⁴	y	-	결과에는 항상 부호가 포함됩니다.
' '	-	-	y⁴	y	-	결과의 선두에는 정의 값을 나타내는 공백이 포함됩니다.
'0'	-	-	y	y	-	결과에는 제로가 추가됩니다.
', '	-	-	y²	y⁵	-	결과에는 로케일 고유의 그룹화 단락 문자가 포함됩니다.
'('	-	-	y⁴	y⁵	-	부의 수치를 괄호로 둘러쌉니다.

¹ Formattable 정의에 존한다

² 'd' 변환만

³ 'o', 'x' 및 'X'변환만

⁴ 'd', 'o', 'x' 및 'X' 변환이 BigInteger에 적용되는지, 'd'가 byte, Byte, short, Short, int, Integer, long 및 Long에 적용되는 경우

⁵ 'e', 'E', 'f', 'g' 및 'G' 변환만

변환으로서 명시적으로 정의되어 있지 않은 플래그는 모두 부정하고, 장래의 기능확장에 대비해 예약되고 있습니다.

Width

width는 출력에 출력해지는 최소 문자수입니다. 행 단락 문자 변환에서는 width는 사용할 수 없습니다. width가 지정되었을 경우, 에러가 발생 됩니다.

Precision

일반의 인수형에서는 precision는 출력에 출력해지는 최대 문자수입니다.

'e', 'E' 및 'f' 부동 소수점의 변환에서는 precision는 10 진수의 단락 문자의 뒤의 자리수가 됩니다. 변환이 'g' 또는 'G'인 경우는 사사오입 처리 후의 결과의 절대치의 합계 자리수가 됩니다. 'a' 또는 'A' 변환의 경우는 precision는 지정되지 않습니다.

문자, 정수, 날짜와 시간/시각 인수 타입 및 퍼센트, 행 단락 문자 변환의 경우, precision는 적용할 수 없습니다. precision가 지정되었을 경우, 예외가 발생 됩니다.

인수의 인덱스

인수의 인덱스는 인수 리스트내에서의 인수의 위치를 나타내는 10 진정수입니다. 최초의 인수는 「1$」, 2번째의 인수는 「2$」으로 참조됩니다.

위치에서 인수를 참조하는 다른 방법은, '<' ('\u003c') 플래그를 사용하는 것입니다. 이 플래그를 지정하면, 이전의 서식 지시자의 인수가 재이용됩니다. 예를 들어 다음의 2개의 문장에서는 동일한 캐릭터 라인이 생성됩니다.

 Calendar c = ...;
 String s1 = String.format("Duke's Birthday:
 %1$tm %1$te, %1$tY", c);
 String s2 = String.format("Duke's Birthday: %1$tm %<$te,%<$tY", c);

이 섹션에서는 조건이나 예외, 지원 되는 데이터형, 지역 대응 및 플래그, 변환, 데이터형간의 상호작용을 포함한, 서식 설정의 동작의 상세를 나타냅니다. 서식 설정의 개념에 대해서는 「개요」를 참조하십시오.

변환, 날짜와 시간/시각 변환의 접미말, 또는 플래그로서 명시적으로 선언되어 있지 않은 문자는 모두 부정하고, 장래의 기능확장에 대비해 예약되고 있습니다. 서식 캐릭터 라인내에서 이런 종류의 문자를 사용하면, UnknownFormatConversionException 또는 UnknownFormatFlagsException을 발생시킵니다.

서식 지시자에게 width가 포함되는 경우, precision에 부정한 값이 있는 경우, 또는 서식 지시자가 지원 되지 않는 경우는 IllegalFormatWidthException 또는 IllegalFormatPrecisionException이 각각 발생 됩니다.

서식 지시자에게, 대응하는 인수에 적용 불가능한 변환 문자가 포함되는 경우, IllegalFormatConversionException을 발생시킵니다.

지정된 예외는 모두, Formatter format() 메서드의 언젠가 및 String.format 나 PrintStream.printf 등의 format 간이 메서드의 어느 쪽인가에보다 발생 됩니다.

대문자 (B, H, S, C, X, E, G, A 및 T 등)로 나타내진 변환은 각각의 소문자를 사용하는 변환과 같습니다만, 변환의 결과는 일반적으로 사용되고 있는 Locale 규칙에 따라 대문자에 변환됩니다. 결과는 다음의 String.toUpperCase()를 호출했을 경우와 같게 됩니다.


    out.toUpperCase()

일반

다음의 일반 변환을 임의의 인수형에 적용할 수 있습니다.

`'b'`	`'\u0062'`	`Boolean.toString(boolean)` 에 의해 리턴된 `true` 또는 `false`를 생성합니다. 인수가 `null`인 경우, 결과는 `false`가 됩니다. 인수가 `boolean` 또는 `Boolean` 인 경우, 결과는 `String.valueOf()` 에 의해 리턴된 캐릭터 라인이 됩니다. 그렇지 않은 경우, 결과는 `true`가 됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'B'`	`'\u0042'`	`'b'` 대문자의 변형
`'h'`	`'\u0068'`	객체의 해시 코드값을 나타내는 캐릭터 라인을 생성합니다. 인수 arg가 `null`인 경우, 결과는 `null`가 됩니다. 그렇지 않은 경우, 결과는 `Integer.toHexString(arg.hashCode())` 호출로 취득됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'H'`	`'\u0048'`	`'h'` 대문자의 변형
`'s'`	`'\u0073'`	캐릭터 라인을 생성합니다. 인수가 `null`인 경우, 결과는 `null`가 됩니다. 인수가 `Formattable`를 구현하는 경우에 `formatTo` 메서드가 호출됩니다. 그렇지 않은 경우, 결과는 인수의 `toString()` 메서드의 호출로 취득됩니다. `'#'` 플래그가 지정되어 인수가 `Formattable` 가 아닌 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'S'`	`'\u0053'`	`'s'` 대문자의 변형

다음의 플래그가 일반 변환에 적용됩니다.

`'-'`	`'\u002d'`	왼쪽 가지런히 하고로 출력합니다. 필요하게 응해 변환된 값의 말미에 공백 (`'\u0020'`)이 추가되어, 필드의 최소폭이 채워집니다. width가 지정되어 있지 않은 경우, `MissingFormatWidthException`을 발생시킵니다. 이 플래그가 설정되어 있지 않은 경우, 오른쪽맞춤으로 출력됩니다.
`'#'`	`'\u0023'`	출력으로 대체 폼을 사용할 필요가 있습니다. 폼의 정의는 변환으로 지정됩니다.

width는 출력에 출력해지는 최소 문자수입니다. 변환 후의 값의 길이가 width 보다 작은 경우, 총문자수가 width에 동일해질 때까지 출력에 ' ' (\u0020')가 패딩 됩니다. 디폴트에서는 좌측으로 패딩 됩니다. '-' 플래그가 지정되었을 경우, 우측으로 패딩 됩니다. width가 지정되어 있지 않은 경우, 최소값는 존재하지 않습니다.

precision는 출력에 출력해지는 최대 문자수입니다. precision는 width 전에 적용되기 때문에 width 값이 precision 보다 큰 경우에서도, 출력은 precision로 지정된 문자수에 버릴 수 있습니다. precision가 지정되어 있지 않은 경우, 문자수에 명시적인 제한은 존재하지 않습니다.

문자

이 변환은, char, Character, byte, Byte, short 및 Short에 적용됩니다. Character.isValidCodePoint(int) 가 true를 돌려주는 경우, 이 변환은 int 및 Integer 형에도 적용 가능합니다. false를 돌려주는 경우는 IllegalFormatCodePointException을 발생시킵니다.

`'c'`	`'\u0063'`	「Unicode 문자 표현」의 기술에 따라, 인수를 Unicode 문자로서 서식 설정합니다. 인수가 보조 문자를 나타내는 경우, 이것을 1개 이상의 16 비트 `char`로 할 수 있습니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'C'`	`'\u0043'`	`'c'` 대문자의 변형

일반 변환용으로 정의된 '-' 플래그가 적용됩니다. '#' 플래그가 지정되었을 경우, FormatFlagsConversionMismatchException을 발생시킵니다.

width는 일반 변환용으로 정의됩니다.

precision는 적용할 수 없습니다. precision가 지정되었을 경우, IllegalFormatPrecisionException을 발생시킵니다.

수치

수치 변환은 다음의 카테고리로 나눌 수 있습니다.

Byte, Short, Integer 및 Long
BigInteger
Float 및 Double
BigDecimal

수치형은 다음의 알고리즘에 따라 서식 설정됩니다.

수치의 지역 대응 알고리즘

정수부, 소수부 및 지수 (데이터형으로 필요한 경우)의 숫자의 취득 후에 다음의 변환이 적용됩니다.

캐릭터 라인내의 각 숫자 d는 현재의 로케일의 제로 숫자 z를 기준에 계산된 로케일 고유의 숫자로 옮겨놓을 수 있다. 즉, d - '0' + z가 된다
소수 단락 문자가 존재하는 경우, 로케일 고유의 소수 단락 문자로 옮겨진다
', ' ('\u002c') 플래그가 지정되었을 경우, 로케일 고유의 그룹 단락 문자가 삽입된다. 캐릭터 라인의 정수부를 최소 유효자리수로부터 최대 유효자리수까지 스캔 해, 로케일의 그룹화 사이즈로 정의된 간격으로 단락지어 문자를 삽입한다
'0' 플래그가 지정되었을 경우, 캐릭터 라인의 길이가 요구된 필드폭과 동일해질 때까지, 로케일 고유의 제로 숫자가 기호의 뒤 (기호가 존재하는 경우), 최초의 제로 이외의 숫자의 전에 삽입된다
값이 부로'(' 플래그가 가리키는 경우, 전에 '(' ('\u0028')가 후에 ')' ('\u0029')가 각각 붙일 수 있다
값이 부 (또는 부동 소수점의 부의 제로)로'(' 플래그가 지정되어 있지 않은 경우, 전에 '-' ('\u002d')가 붙일 수 있다
'+' 플래그가 지정되어 한편 값이 정 또는 제로 (혹은 부동 소수점의 정의 제로)인 경우, 전에 '+' ('\u002b')가 붙일 수 있다

값이 NaN 또는 정의 무한대의 경우, 리터럴 캐릭터 라인 「NaN」또는 「Infinity」가 각각 출력됩니다. 값이 부의 무한대의 경우, '(' 플래그가 지정되고 있으면 출력은 「(Infinity)」가 되어, 그렇지 않은 경우는 「-Infinity」가 됩니다. 이러한 값의 지역 대응은 행해지지 않습니다.

Byte, Short, Integer 및 Long

다음의 변환을 byte, Byte, short, Short, int, Integer, long 및 Long에 적용할 수 있습니다.

`'d'`	`'\u0054'`	인수를 10 진정수로서 서식 설정합니다. 지역 대응 알고리즘이 적용됩니다. `'0'` 플래그가 지정되어 값이 부의 경우, 부호의 뒤에 제로가 패딩 됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'o'`	`'\u006f'`	인수를, 기수 8 정수로서 서식 설정합니다. 지역 대응은 적용되지 않습니다. x가 부의 경우, 결과는 값에 2ⁿ를 추가해 생성된 부호 없음의 값이 됩니다. `n`는 필요하게 응해Byte, Short, Integer, 또는 Long 클래스내의 static `SIZE` 필드에 의해 리턴된 형태의 비트수입니다. `'#'` 플래그가 지정되었을 경우, 출력은 항상 기수 지시자 `'0'`로 시작됩니다. `'0'` 플래그가 지정되었을 경우, 출력으로는 부호 지시에 계속되는 필드폭의 선두에 제로가 패딩 됩니다. `'('`, `'+'`, ' ', 또는 `', '` 플래그가 지정되었을 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'x'`	`'\u0078'`	인수를, 기수 16 정수로서 서식 설정합니다. 지역 대응은 적용되지 않습니다. x가 부의 경우, 결과는 값에 2ⁿ를 추가해 생성된 부호 없음의 값이 됩니다. `n`는 필요하게 응해Byte, Short, Integer, 또는 Long 클래스내의 static `SIZE` 필드에 의해 리턴된 형태의 비트수입니다. `'#'` 플래그가 지정되었을 경우, 출력은 항상 기수 지시자 「`0x`」로 시작됩니다. `'0'` 플래그가 지정되었을 경우, 출력의 필드폭의 선두에서 기수 지시자 또는 부호 (존재하는 경우)의 뒤에 제로가 패딩 됩니다. `'('`, `' '`, `'+'`, 또는 `', '` 플래그가 지정되었을 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'X'`	`'\u0058'`	`'x'` 대문자의 변형. `'x'` (존재하는 경우) 및 모든 16 진수 `'a'` - `'f'` (`'\u0061'` - `'\u0066'`)를 포함한, 수치를 나타내는 캐릭터 라인 전체가대문자에 변환됩니다.

변환이 'o', 'x', 또는 'X'로 플래그 '#'와 '0' 양쪽 모두의 플래그가 가리키는 경우, 결과에는 기수 지시자 (8 진의 경우는 '0', 16 진의 경우는 "0x" 또는 "0X"), 몇개의 제로 (width에 근거한다) 및 값이 포함됩니다.

'-' 플래그가 지정되어 있지 않은 경우, 부호의 전에 공백이 패딩 됩니다.

다음의 플래그가 수치 정수 변환에 적용됩니다.

`'+'`	`'\u002b'`	출력으로 정의 수 모두에게 정의 부호를 포함할 필요가 있습니다. 이 플래그가 지정되어 있지 않은 경우, 잘못된 값에 게만 부호를 포함할 수 있습니다. 플래그 `'+'`와 `' '` 양쪽 모두가 가리키는 경우, `IllegalFormatFlagsException`을 발생시킵니다.
`' '`	`'\u0020'`	출력으로 부 이외의 값에 여분의 공백 (`'\u0020'`)을 1개 포함할 필요가 있습니다. 플래그 `'+'`와 `' '` 양쪽 모두가 가리키는 경우, `IllegalFormatFlagsException`을 발생시킵니다.
`'0'`	`'\u0030'`	출력으로 다음의 부호 또는 기수 지시자에게 계속되는 최소 필드폭의 선두에제로를 패딩 할 필요가 있습니다 (NaN 또는 무한의 변환시를 제외하다). width가 지정되어 있지 않은 경우, `MissingFormatWidthException`을 발생시킵니다. 플래그 `'-'`와 `'0'` 양쪽 모두가 가리키는 경우, `IllegalFormatFlagsException`을 발생시킵니다.
`', '`	`'\u002c'`	출력에 로케일 고유의 그룹 단락 문자를 포함할 필요가 있습니다. 자세한 내용은 지역 대응 알고리즘의 그룹 섹션을 참조하십시오.
`'('`	`'\u0028'`	출력으로 잘못된 값 의 선두에 `'('` (`'\u0028'`)를, 말미에 `')'` (`'\u0029'`)를 부가할 필요가 있습니다.

플래그가 지정되지 않는 경우의, 디폴트 서식 설정은 다음과 같습니다.

출력은, width 내에서 오른쪽맞춤 된다
부의 수는 '-' ('\u002d')로 시작된다
정의 수 및 제로에는 부호도 선두의 여분의 공백도 부가되지 않는다
그룹화 단락 문자는 포함할 수 없다

width는 출력에 출력해지는 최소 문자수입니다. 이것에는 부호, 숫자, 그룹화 단락 문자, 기수 지시자 및 괄호가 포함됩니다. 변환 후의 값의 길이가 width 보다 작은 경우, 총문자수가 width에 동일해질 때까지 출력에 공백 ('\u0020')이 패딩 됩니다. 디폴트에서는 좌측으로 패딩 됩니다. '-' 플래그가 지정되었을 경우, 우측으로 패딩 됩니다. width가 지정되어 있지 않은 경우, 최소값는 존재하지 않습니다.

precision는 적용할 수 없습니다. precision가 지정되었을 경우, IllegalFormatPrecisionException을 발생시킵니다.

BigInteger

다음의 변환을 BigInteger에 적용할 수 있습니다.

`'d'`	`'\u0054'`	출력을 10 진정수로서 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'o'`	`'\u006f'`	출력을 기수 8 정수로서 서식 설정할 필요가 있습니다. 지역 대응은 적용되지 않습니다. x가 부의 경우, 결과는 `'-'` (`'\u002d'`)로 시작되는 부호 첨잘못된 값이 됩니다. 이 형태의 경우, 부호 첨부의 출력이 허가됩니다. 이것은 원시형 과는 달라, 명시적인 데이터형 사이즈를 상정하지 않고 등가인 부호 없음의 값을 작성하는 것은 불가능하기 때문에입니다. x가 정 또는 제로로`'+'` 플래그가 가리키는 경우, 결과는 `'+'` (`'\u002b'`)로 시작됩니다. `'#'` 플래그가 지정되었을 경우, 출력은 항상 접두사 `'0'`로 시작됩니다. `'0'` 플래그가 지정되었을 경우, 출력으로는 부호 지시에 계속되는 필드폭의 선두에 제로가 패딩 됩니다. `', '` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'x'`	`'\u0078'`	출력을 기수 16 정수로서 서식 설정할 필요가 있습니다. 지역 대응은 적용되지 않습니다. x가 부의 경우, 결과는 `'-'` (`'\u002d'`)로 시작되는 부호 첨잘못된 값이 됩니다. 이 형태의 경우, 부호 첨부의 출력이 허가됩니다. 이것은 원시형 과는 달라, 명시적인 데이터형 사이즈를 상정하지 않고 등가인 부호 없음의 값을 작성하는 것은 불가능하기 때문에입니다. x가 정 또는 제로로`'+'` 플래그가 가리키는 경우, 결과는 `'+'` (`'\u002b'`)로 시작됩니다. `'#'` 플래그가 지정되었을 경우, 출력은 항상 기수 지시자 「`0x`」로 시작됩니다. `'0'` 플래그가 지정되었을 경우, 출력의 필드폭의 선두에서 기수 지시자 또는 부호 (존재하는 경우)의 뒤에 제로가 패딩 됩니다. `', '` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'X'`	`'\u0058'`	`'x'` 대문자의 변형. `'x'` (존재하는 경우) 및 모든 16 진수 `'a'` - `'f'` (`'\u0061'` - `'\u0066'`)를 포함한, 수치를 나타내는 캐릭터 라인 전체가대문자에 변환됩니다.

변환이 'o', 'x', 또는 'X'로 플래그 '#'와 '0' 양쪽 모두의 플래그가 가리키는 경우, 결과에는 기저 지시자 (8 진의 경우는 '0', 16 진의 경우는 "0x" 또는 "0X"), 몇개의 제로 (width에 근거한다) 및 값이 포함됩니다.

'0' 플래그가 지정되어 값이 부의 경우, 부호의 뒤에 제로가 패딩 됩니다.

'-' 플래그가 지정되어 있지 않은 경우, 부호의 전에 공백이 패딩 됩니다.

Byte, Short, Integer 및 Long 용으로 정의된 모든플래그가 적용됩니다. 플래그가 지정되지 않는 경우의 디폴트 동작은,Byte, Short, Integer 및 Long 디폴트 동작과 같습니다.

width 사양은 Byte, Short, Integer 및 Long 로 정의된 사양과 같습니다.

precision는 적용할 수 없습니다. precision가 지정되었을 경우, IllegalFormatPrecisionException을 발생시킵니다.

Float 및 Double

다음의 변환을 float, Float, double 및 Double에 적용할 수 있습니다.

`'e'`	`'\u0065'`	출력을부동 소수점 표시 형식을 사용해 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. 절대치 m 서식 설정은 값에 의해 다릅니다. m가 NaN 또는 무한대의 경우, 리터럴 캐릭터 라인 「NaN」또는 「Infinity」가 각각 출력됩니다. 이러한 값의 지역 대응은 행해지지 않습니다. m가 정의 제로 또는 부의 제로의 경우, 지수는 「`+00`」이 됩니다. 그렇지 않은 경우, 결과는 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호의 서식 설정에 대해서는 지역 대응 알고리즘을 참조하십시오. 절대치 m 서식 설정은 값에 의해 다릅니다. n를 10ⁿ <= m < 10ⁿ⁺¹ 등의 일의의 정수로 해, a를 1 <= a < 10 이 되는 것 같은 m와 10ⁿ 수학적으로 정확한 상으로 합니다. 이 경우 절대치는 메서드 `Long.toString(long, int)` 로 생성되도록, a 정수부인 1 자리수의 10 진수, 소수점, a 소수부를 나타내는 10 진수, 지수 기호 `'e'` (`'\u0065'`), 지수의 기호, n 10 진정수 표현이 이 순서에 줄선 형태로 표현됩니다. 또, 2 자리수 이상이 되도록 제로가 패딩 됩니다. 결과내의 m 또는 a 소수부의 자리수는 precision와 동일해집니다. precision가 지정되지 않는 경우의, 기본값는 `6` 입니다. precision 가`Float.toString(float)` 또는 `Double.toString(double)` 에 의해 각각 리턴된 캐릭터 라인내의 소수점 이후의 자리수보다 작은 경우, 값은반절인상 알고리즘을 사용해 사사오입 됩니다. 그렇지 않은 경우, precision 값에 이르도록 말미에 제로를 부가할 수 있습니다. 값의 정규 표현에서는 필요에 따라서 `Float.toString(float)` 또는 `Double.toString(double)`를 사용합니다. `', '` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'E'`	`'\u0045'`	`'e'` 대문자의 변형입니다. 지수는 `'E'` (`'\u0045'`)가 됩니다.
`'g'`	`'\u0067'`	일반의 과학 표기법을 사용해 출력을 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. precision 사사오입 처리 후의 결과의 절대치 m 서식 설정은 값에 의해 다릅니다. m가 10^-4 이상으로 10^precision 미만의 경우, 10 진포맷으로 표현됩니다. m가 10^-4 미만, 또는 10^precision 이상의 경우, 부동 소수점 표시 형식에서 표현됩니다. m 자리수의 합계는 precision와 동일해집니다. precision가 지정되어 있지 않은 경우의 기본값는 `6` 입니다. precision가 `0`인 경우는 `1` 이 됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'G'`	`'\u0047'`	`'g'` 대문자의 변형
`'f'`	`'\u0066'`	출력을 10 진포맷을 사용해 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. 결과는 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호의 서식 설정에 대해서는 지역 대응 알고리즘을 참조하십시오. 절대치 m 서식 설정은 값에 의해 다릅니다. m가 NaN 또는 무한대의 경우, 리터럴 캐릭터 라인 「NaN」또는 「Infinity」가 각각 출력됩니다. 이러한 값의 지역 대응은 행해지지 않습니다. 절대치의 서식은, m 정수부 (선두에 제로가 부가되지 않는다), 소수점 및 m 소수부를 나타내는 1개 이상의 10 진수가 이 차례로 표기된 것이 됩니다. 결과내의 m 또는 a 소수부의 자리수는 precision 과 동일해집니다. precision가 지정되지 않는 경우의, 기본값는 `6` 입니다. precision 가`Float.toString(float)` 또는 `Double.toString(double)` 에 의해 각각 리턴된 캐릭터 라인내의 소수점 이후의 자리수보다 작은 경우, 값은반절인상 알고리즘을 사용해 사사오입 됩니다. 그렇지 않은 경우, precision 값에 이르도록 말미에 제로를 부가할 수 있습니다. 값의 정규 표현에서는 필요에 따라서 `Float.toString(float)` 또는 `Double.toString(double)`를 사용합니다.
`'a'`	`'\u0061'`	출력의 서식을 16 진의 지수로 설정할 필요가 있습니다. 지역 대응은 적용되지 않습니다. 결과는 인수 x 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. x가 부 또는 부의 제로치의 경우, 결과의 선두는 `'-'` (`'\u002d'`)가 됩니다. x가 정 또는 정의 제로치로`'+'` 플래그가 가리키는 경우, 결과의 선두는 `'+'` (`'\u002b'`)가 됩니다. 절대치 m 서식 설정은 값에 의해 다릅니다. 값이 NaN 또는 무한대의 경우, 리터럴 캐릭터 라인 「NaN」또는 「Infinity」이 각각 출력됩니다. m가 제로의 경우, 이것은 캐릭터 라인 `"0x0. 0p0"`로 표현됩니다. m가 정규화된 표현을 가지는 `double` 치의 경우, 서브 캐릭터 라인을 사용해 유효 숫자 및 지수 필드가 표현됩니다. 유효 숫자는 문자 「`0x1`」에 유효 숫자의 나머지의 부분 (소수)의 16 진표현을 부가한 것입니다. 지수는 `'p'` (`'\u0070'`)에 지수치에 대해서 `Integer.toString`를 호출했는지와 같이 불편 지수의 10 진캐릭터 라인을 부가한 것입니다. m가 서브 노멀 표현을 보관 유지하는 `double` 치의 경우, 유효 숫자는 문자 `'0x0. '`에 유효 숫자의 나머지의 부분 (소수)의 16 진표현을 부가한 것이 됩니다. 지수는 `'p-1022'`로 나타내집니다. 서브 노멀 유효 숫자내에 제로가 아닌 숫자가 1개 이상 존재할 필요가 있는 것에 유의해 주세요. `'('` 또는 `', '` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'A'`	`'\u0041'`	`'a'` 대문자의 변형입니다. 수치를 나타내는 캐릭터 라인 전체가 대문자에 변환됩니다. 이것에는 `'x'` (`'\u0078'`), `'p'` (`'\u0070'`) 및 모든 16 진수 `'a'` - `'f'` (`'\u0061'` - `'\u0066'`)도 포함됩니다.

Byte, Short, Integer 및 Long 용으로 정의된 모든플래그가 적용됩니다.

'#' 플래그가 가리키는 경우, 소수점이 항상 존재합니다.

플래그가 지정되지 않는 경우의, 디폴트 서식 설정은 다음과 같습니다.

출력은, width 내에서 오른쪽맞춤 된다
부의 수는 '-'로 시작된다
정의 수 및 정의 제로에는 부호도 선두의 여분의 공백도 부가되지 않는다
그룹화 단락 문자는 포함되지 않는다
소수점은 그 후에 숫자가 표기되는 경우에게만 표시된다

width는 출력에 출력해지는 최소 문자수입니다. 이것에는 부호, 숫자, 그룹화 단락 문자, 10 진수 단락 문자, 지수 기호, 기수 지시자, 괄호 및 Infinity와 NaN를 규정대로 나타내는 캐릭터 라인이 포함됩니다. 변환 후의 값의 길이가 width 보다 작은 경우, 총문자수가 width에 동일해질 때까지 출력에 공백 ('\u0020')이 패딩 됩니다. 디폴트에서는 좌측으로 패딩 됩니다. '-' 플래그가 지정되었을 경우, 우측으로 패딩 됩니다. width가 지정되어 있지 않은 경우, 최소값는 존재하지 않습니다.

변환이 'e', 'E' 또는 'f'인 경우, precision는 소수 아래의 자리수입니다. precision가 지정되어 있지 않은 경우, 6 이다고 보여집니다.

변환이 'g' 또는 'G'인 경우, precision는 사사오입 처리 후의 결과의 절대치의 유효자리수의 합계수입니다. precision가 지정되지 않는 경우, 기본값는 6 이 됩니다. precision가 0인 경우는 1 이 됩니다.

변환이 'a' 또는 'A'의 경우, precision는 소수점 아래의 16 진의 자리수가 됩니다. precision가 지정되지 않는 경우, Double.toHexString(double) 에 의해 리턴된 모든 자리수가 출력됩니다.

BigDecimal

다음의 변환을 BigDecimal에 적용할 수 있습니다.

`'e'`	`'\u0065'`	출력을부동 소수점 표시 형식을 사용해 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. 절대치 m 서식 설정은 값에 의해 다릅니다. m가 정의 제로 또는 부의 제로의 경우, 지수는 「`+00`」이 됩니다. 그렇지 않은 경우, 결과는 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호의 서식 설정에 대해서는 지역 대응 알고리즘을 참조하십시오. 절대치 m 서식 설정은 값에 의해 다릅니다. n를 10ⁿ <= m < 10ⁿ⁺¹ 등의 일의의 정수로 해, a를 1 <= a < 10 이 되는 것 같은 m와 10ⁿ 수학적으로 정확한 상으로 합니다. 이 경우 절대치는 메서드 `Long.toString(long, int)` 로 생성되도록, a 정수부인 1 자리수의 10 진수, 소수점, a 소수부를 나타내는 10 진수, 지수 기호 `'e'` (`'\u0065'`), 지수의 기호, n 10 진정수 표현이 이 순서에 줄선 형태로 표현됩니다. 또, 2 자리수 이상이 되도록 제로가 패딩 됩니다. 결과내의 m 또는 a 소수부의 자리수는 precision와 동일해집니다. precision가 지정되지 않는 경우의, 기본값는 `6` 입니다. precision 가`Float.toString(float)` 또는 `Double.toString(double)` 에 의해 각각 리턴된 캐릭터 라인내의 소수점 이후의 자리수보다 작은 경우, 값은반절인상 알고리즘을 사용해 사사오입 됩니다. 그렇지 않은 경우, precision 값에 이르도록 말미에 제로를 부가할 수 있습니다. 값의 정규 표현에서는 `BigDecimal.toString()`를 사용합니다. `', '` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'E'`	`'\u0045'`	`'e'` 대문자의 변형입니다. 지수는 `'E'` (`'\u0045'`)가 됩니다.
`'g'`	`'\u0067'`	일반의 과학 표기법을 사용해 출력을 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. precision 사사오입 처리 후의 결과의 절대치 m 서식 설정은 값에 의해 다릅니다. m가 10^-4 이상으로 10^precision 미만의 경우, 10 진포맷으로 표현됩니다. m가 10^-4 미만, 또는 10^precision 이상의 경우, 부동 소수점 표시 형식에서 표현됩니다. m 자리수의 합계는 precision와 동일해집니다. precision가 지정되어 있지 않은 경우의 기본값는 `6` 입니다. precision가 `0`인 경우는 `1` 이 됩니다. `'#'` 플래그가 가리키는 경우, `FormatFlagsConversionMismatchException`을 발생시킵니다.
`'G'`	`'\u0047'`	`'g'` 대문자의 변형
`'f'`	`'\u0066'`	출력을 10 진포맷을 사용해 서식 설정할 필요가 있습니다. 지역 대응 알고리즘이 적용됩니다. 결과는 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호의 서식 설정에 대해서는 지역 대응 알고리즘을 참조하십시오. 절대치 m 서식 설정은 값에 의해 다릅니다. 절대치의 서식은, m 정수부 (선두에 제로가 부가되지 않는다), 소수점 및 m 소수부를 나타내는 1개 이상의 10 진수가 이 차례로 표기된 것이 됩니다. 결과내의 m 또는 a 소수부의 자리수는 precision와 동일해집니다. precision가 지정되지 않는 경우의, 기본값는 `6` 입니다. precision 가`Float.toString(float)` 또는 `Double.toString(double)` 에 의해 각각 리턴된 캐릭터 라인내의 소수점 이후의 자리수보다 작은 경우, 값은반절인상 알고리즘을 사용해 사사오입 됩니다. 그렇지 않은 경우, precision 값에 이르도록 말미에 제로를 부가할 수 있습니다. 값의 정규 표현에서는 `BigDecimal.toString()`를 사용합니다.

Byte, Short, Integer 및 Long 용으로 정의된 모든플래그가 적용됩니다.

'#' 플래그가 가리키는 경우, 소수점이 항상 존재합니다.

플래그가 지정되지 않는 경우의 디폴트 동작은,Float 및 Double와 같습니다.

width 및 precision 사양은 Float 및 Double 로 정의된 사양과 같습니다.

날짜와 시간/시각

이 변환은, long, Long, Calendar 및 Date에 적용할 수 있습니다.

`'t'`	`'\u0074'`	날짜와 시간 및 시각 변환 문자의 접두사
`'T'`	`'\u0054'`	`'t'` 대문자의 변형

시각의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'H'`	`'\u0048'`	24 시간제때. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 23`). `00` 은 한밤 중에 대응합니다.
`'I'`	`'\u0049'`	12 시간제때. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 -12`). `01` 은 1 시 (오전 또는 오후)에 대응합니다.
`'k'`	`'\u006b'`	24 시간제때 (`0 - 23`). `0` 은 한밤 중에 대응합니다.
`'l'`	`'\u006c'`	12 시간제때 (`1 - 12`). `1` 은 1 시 (오전 또는 오후)에 대응합니다.
`'M'`	`'\u004d'`	분. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 59`).
`'S'`	`'\u0053'`	초. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`00 - 60`). 「`60`」은 윤년에서의 초의 지원에 필요한 특수한 값입니다.
`'L'`	`'\u004c'`	밀리 세컨드. 필요에 따라서 0을 선두에 추가해, 3 자리수로 표현합니다 (`000 - 999`).
`'N'`	`'\u004e'`	나노초. 필요에 따라서 0을 선두에 추가해, 9 자리수로 표현합니다 (`000000000 - 999999999`). 이 값의 정밀도는 배후의 OS 또는 하드웨어의 해상도에 의해 제한됩니다.
`'p'`	`'\u0070'`	로케일에 특정의 오전 또는 오후의 소문자 (`am` 또는 `pm` 등)의 마커. 변환의 접두사 `'T'`는 이것을 강제적으로 대문자로 출력합니다 (`'p'`는 소문자로 출력된다. 이것은 대문자로 출력되는 GNU `date` 및 POSIX `strftime(3c)`와는 다르다).
`'z'`	`'\u007a'`	RFC 822에 준거한, GMT 로부터의 수치 타임 존 오프셋(offset) (예, `-0800`)
`'Z'`	`'\u005a'`	타임 존의 생략형을 나타내는 캐릭터 라인
`'s'`	`'\u0073'`	1970 년 1 월 1 일 `00:00:00` UTC 신기원 개시부터의 초 (`Long.MIN_VALUE/1000`로 부터 `Long.MAX_VALUE/1000` 까지)
`'Q'`	`'\u004f'`	1970 년 1 월 1 일 `00:00:00` UTC 신기원 개시부터 (즉, `Long.MIN_VALUE`로 부터 `Long.MAX_VALUE` 까지)의 밀리 세컨드. 이 값의 정밀도는 배후의 OS 또는 하드웨어의 해상도에 의해 제한됩니다.

날짜와 시간의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'B'`	`'\u0042'`	로케일 고유의 달의 완전한 이름 (예, 「`January`」, 「`February`」)
`'b'`	`'\u0062'`	로케일 고유의 달의 생략명 (예, 「`Jan`」, 「`Feb`」)
`'h'`	`'\u0068'`	`'b'`와 같다
`'A'`	`'\u0041'`	로케일 고유의 요일의 완전한 이름 (예, 「`Sunday`」, 「`Monday`」)
`'a'`	`'\u0061'`	로케일 고유의 요일의 단축명 (예, 「`Sun`」, 「`Mon`」)
`'C'`	`'\u0043'`	4 자리수의 해를 `100` 으로 나눈 값. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표시합니다 (`00 - 99`).
`'Y'`	`'\u0059'`	해. 필요에 따라서 0을 선두에 추가해 4 자리수 이상으로 표현합니다. 예를 들어, `0092`는 그레고리오력의 `92` CE와 같습니다.
`'y'`	`'\u0079'`	해하 2 자리수. 필요에 따라서 0을 선두에 추가합니다 (`00 - 99`).
`'j'`	`'\u006a'`	해의 며칠눈인지를 나타내는 날. 필요에 따라서 0을 선두에 추가해, 3 자리수로 표현합니다. 예를 들어 그레고리오력의 경우, `001 - 366` 이 됩니다. `001` 은 해의 최초의 날에 대응합니다.
`'m'`	`'\u006d'`	달. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`01 - 13`). 「`01`」은 해의 최초의 달입니다 ( 「`13`」은 음력의 지원에 필요한 특수한 값).
`'d'`	`'\u0064'`	달의 며칠눈인지를 나타내는 날. 필요에 따라서 0을 선두에 추가해, 2 자리수로 표현합니다 (`01 - 31`). 「`01`」은 달의 최초의 날을 나타냅니다.
`'e'`	`'\u0065'`	달의 며칠눈인지를 나타내는 날. 최대 2 자리수로 표현합니다 (`1 - 31`). 「`1`」은 달의 최초의 날을 나타냅니다.

일반의 날짜와 시간/시각 변환의 서식 설정에서는 다음의 변환 문자가 사용됩니다.

`'R'`	`'\u0052'`	「`%tH:%tM`로서 24 시간제로 서식 설정되었을 때 각
`'T'`	`'\u0054'`	「`%tH:%tM:%tS`로서 24 시간제로 서식 설정되었을 때 각
`'r'`	`'\u0072'`	「`"%tI:%tM:%tS %Tp"`로서 12 시간제로 서식 설정되었을 때 각. 오전 및 오후 마커의 위치 (`'%Tp'`)는 로케일에 의해 다릅니다.
`'D'`	`'\u0044'`	「`%tm/%td/%ty`로서 서식 설정된 날짜와 시간
`'F'`	`'\u0046'`	「`%tY-%tm-%td`로서 서식 설정된, ISO 8601에 준거한 날짜와 시간
`'c'`	`'\u0063'`	「`%ta %tb %td %tT %tZ %tY`로서 서식 설정된 날짜와 시간 및 시각 (예, 「`Sun Jul 20 16:17:00 EDT 1969`」)

일반 변환용으로 정의된 '-' 플래그가 적용됩니다. '#' 플래그가 지정되었을 경우, FormatFlagsConversionMismatchException을 발생시킵니다.

width는 출력에 출력해지는 최소 문자수입니다. 변환 후의 값의 길이가 width 보다 작은 경우, 총문자수가 width에 동일해질 때까지 출력에 공백 ('\u0020')이 패딩 됩니다. 디폴트에서는 좌측으로 패딩 됩니다. '-' 플래그가 지정되었을 경우, 우측으로 패딩 됩니다. width가 지정되어 있지 않은 경우, 최소값는 존재하지 않습니다.

precision는 적용할 수 없습니다. precision가 지정되었을 경우, IllegalFormatPrecisionException을 발생시킵니다.

퍼센트

이 변환에 대응하는 인수는 없습니다.

'%'

결과는 리터럴 「%」(\u0025)이 됩니다.

width는 출력에 출력해지는 '%'를 포함한 최소 문자수입니다. 변환 후의 값의 길이가 width 보다 작은 경우, 총문자수가 width에 동일해질 때까지 출력에 공백 ('\u0020')이 패딩 됩니다. 패딩은 좌측에 행해집니다. width가 지정되어 있지 않은 경우, '%' 만이 출력됩니다.

일반 변환용으로 정의된 '-' 플래그가 적용됩니다. 다른 플래그가 지정되었을 경우, FormatFlagsConversionMismatchException을 발생시킵니다.

precision는 적용할 수 없습니다. precision가 지정되었을 경우, IllegalFormatPrecisionException을 발생시킵니다.

행 단락 문자

이 변환에 대응하는 인수는 없습니다.

'n' 플랫폼 고유의 행 단락 문자로System.getProperty("line.separator") 에 의해 리턴됩니다 .

flags, width 및 precision는 적용할 수 없습니다. 이것들이 지정되었을 경우, IllegalFormatFlagsException, IllegalFormatWidthException 및 IllegalFormatPrecisionException이 각각 발생 됩니다.

인수의 인덱스

서식 지시자는 다음의 3개의 방법으로 인수를 참조할 수 있습니다.

「명시적인 인덱스 지정」은 서식 지시자에게 인수 인덱스가 포함되는 경우에 사용합니다. 인수 인덱스는 인수 리스트내에서의 인수의 위치를 나타내는 10 진정수입니다. 최초의 인수는 「1$」, 2번째의 인수는 「2$」으로 참조됩니다. 인수는 여러 차례 참조할 수 있습니다.
다음에 예를 나타냅니다.
```
 formatter.format("%4$s %3$s %2$s %1$s %4$s %3$s %2$s %1$s", "a", "b", "c", "d") // -> "d c b a d c b a" 
```
「상대적인 인덱스 지정」은 서식 지시자에게 '<' ('\u003c') 플래그가 포함되는 경우에 사용합니다. 이 플래그가 포함되어 있으면, 이전의 서식 지시자의 인수가 재이용됩니다. 이전의 인수가 존재하지 않는 경우, MissingFormatArgumentException을 발생시킵니다.
```
 formatter.format("%s %s %<s %<s", "a", "b", "c", "d") // -> "a b b b" // "c" and "d" are ignored because they are not referenced 
```
서식 지시자에게 인수 인덱스도 '<' 플래그도 포함되지 않는 경우, 「보통 의 인덱스 지정」이 사용됩니다. 보통 의 인덱스 지정을 사용하는 각 서식 지시자에게는 인수 리스트에 대한 암묵의 차례차례 인덱스를 할당할 수 있습니다. 이 인덱스는 명시적 또는 상대적인 인덱스 지정으로 사용되는 인덱스로부터 독립하고 있습니다.
```
 formatter.format("%s %s %s %s", "a", "b", "c", "d") // -> "a b c d" 
```

1개의 서식 캐릭터 라인으로 모든 인덱스 지정을 사용할 수 있습니다. 다음에 예를 나타냅니다.

 formatter.format("%2$s %s %<s %s", "a", "b", "c", "d") // -> "b a a b" // "c" and "d" are ignored because they are not referenced

인수의 최대수는 Java 가상 머신 사양으로 정의된 Java 배열의 최대 사이즈의 제한을 받습니다. 인수 인덱스가 이용 가능한 인수에 대응하고 있지 않는 경우, MissingFormatArgumentException을 발생시킵니다.

서식 지시자 이상의 인수가 존재하는 경우, 여분의 인수는 무시됩니다.

특히 지정되어 있지 않은 한, null 인수를 이 클래스의 메서드 또는 생성자에 건네주면, NullPointerException을 발생시킵니다.

도입된 버전 :: 1.5

중첩(Nested) 클래스 개요
`static class`	`Formatter.BigDecimalLayoutForm`

생성자 개요
`Formatter ()` 새로운 포매터를 구축합니다.
`Formatter (Appendable a)` 지정된 행선지를 가지는 새로운 포매터를 구축합니다.
`Formatter (Appendable a, Locale l)` 지정된 행선지 및 로케일을 가지는 새로운 포매터를 구축합니다.
`Formatter (File file)` 지정된 파일을 가지는 새로운 포매터를 구축합니다.
`Formatter (File file, String csn)` 지정된 파일 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.
`Formatter (File file, String csn, Locale l)` 지정된 파일, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.
`Formatter (Locale l)` 지정된 로케일을 가지는 새로운 포매터를 구축합니다.
`Formatter (OutputStream os)` 지정된 출력 스트림을 가지는 새로운 포매터를 구축합니다.
`Formatter (OutputStream os, String csn)` 지정된 출력 스트림 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.
`Formatter (OutputStream os, String csn, Locale l)` 지정된 출력 스트림, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.
`Formatter (PrintStream ps)` 지정된 출력 스트림을 가지는 새로운 포매터를 구축합니다.
`Formatter (String fileName)` 지정된 파일명을 가지는 새로운 포매터를 구축합니다.
`Formatter (String fileName, String csn)` 지정된 파일명 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.
`Formatter (String fileName, String csn, Locale l)` 지정된 파일명, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.

메서드 개요
`void`	`close ()` 이 포매터를 닫습니다.
`void`	`flush ()` 이 포매터를 플래시 합니다.
`Formatter`	`format (Locale l, String format, Object ... args)` 지정된 로케일, 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 객체의 행선지에 출력합니다.
`Formatter`	`format (String format, Object ... args)` 지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 객체의 행선지에 출력합니다.
`IOException`	`ioException ()` 이 포매터 `Appendable` 에 의해 마지막에 Throw 된 `IOException`을 리턴합니다.
`Locale`	`locale ()` 이 포매터를 구축하는 것으로 설정된 로케일을 리턴합니다.
`Appendable`	`out ()` 출력처를 리턴합니다.
`String`	`toString ()` 출력 먼저 대해 `toString()`를 호출한 결과를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

생성자 상세

Formatter

public Formatter()

새로운 포매터를 구축합니다.

서식 설정된 출력의 행선지는 StringBuilder 입니다. 이것은, out()를 호출하는 것으로 취득할 수 있습니다. 또한, toString()를 호출하는 것으로 현재의 내용을 변환할 수 있습니다. 사용되는 로케일은 이 Java 가상 머신 인스턴스용의 디폴트 로케일입니다.

Formatter

public Formatter(Appendable  a)

지정된 행선지를 가지는 새로운 포매터를 구축합니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: a - 서식 첨부 출력의 행선지. a가 null인 경우, StringBuilder 가 작성된다

Formatter

public Formatter(Locale  l)

지정된 로케일을 가지는 새로운 포매터를 구축합니다.

서식 첨부 출력의 행선지는 StringBuilder 입니다. 이것은, out()를 호출하는 것으로 취득할 수 있습니다. 또한, toString()를 호출하는 것으로 현재의 내용을 캐릭터 라인으로 변환할 수 있습니다.

파라미터:: l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다

Formatter

public Formatter(Appendable  a,
                 Locale  l)

지정된 행선지 및 로케일을 가지는 새로운 포매터를 구축합니다.

파라미터:: a - 서식 첨부 출력의 행선지. a가 null인 경우, StringBuilder 가 작성되는; l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다

Formatter

public Formatter(String  fileName)
          throws FileNotFoundException

지정된 파일명을 가지는 새로운 포매터를 구축합니다.

사용되는 캐릭터셋는 이 Java 가상 머신 인스턴스의 디폴트 캐릭터셋입니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: fileName - 이 포매터의 행선지로서 사용되는 파일의 이름. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어진다
예외:: SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(fileName) 가 파일에의 쓰기 권한을 허가하지 않을 때; FileNotFoundException - 지정된 파일명이 기존의 출력가능한 보통 의 파일을 나타내지 않는 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우

Formatter

public Formatter(String  fileName,
                 String  csn)
          throws FileNotFoundException,

                 UnsupportedEncodingException

지정된 파일명 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: fileName - 이 포매터의 행선지로서 사용되는 파일의 이름. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어지는; csn - 지원하는 charset 이름
예외:: FileNotFoundException - 지정된 파일명이 기존의 출력가능한 보통 의 파일을 나타내지 않는 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(fileName) 가 파일에의 쓰기 권한을 허가하지 않을 때; UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

Formatter

public Formatter(String  fileName,
                 String  csn,
                 Locale  l)
          throws FileNotFoundException,

                 UnsupportedEncodingException

지정된 파일명, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.

파라미터:: fileName - 이 포매터의 행선지로서 사용되는 파일의 이름. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어지는; csn - 지원하는 charset 이름; l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다
예외:: FileNotFoundException - 지정된 파일명이 기존의 출력가능한 보통 의 파일을 나타내지 않는 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(fileName) 가 파일에의 쓰기 권한을 허가하지 않을 때; UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

Formatter

public Formatter(File  file)
          throws FileNotFoundException

지정된 파일을 가지는 새로운 포매터를 구축합니다.

사용되는 캐릭터셋는 이 Java 가상 머신 인스턴스의 디폴트 캐릭터셋입니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: file - 이 포매터의 행선지로서 사용되는 파일. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어진다
예외:: SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(file.getPath()) 가 파일에의 쓰기 권한을 허가하지 않을 때; FileNotFoundException - 지정된 파일 객체가 기존의 파일을 나타내지 않는 출력가능한 보통 의 파일 및 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우

Formatter

public Formatter(File  file,
                 String  csn)
          throws FileNotFoundException,

                 UnsupportedEncodingException

지정된 파일 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: file - 이 포매터의 행선지로서 사용되는 파일. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어지는; csn - 지원하는 charset 이름
예외:: FileNotFoundException - 지정된 파일 객체가 기존의 파일을 나타내지 않는 출력가능한 보통 의 파일 및 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(file.getPath()) 가 파일에의 쓰기 권한을 허가하지 않을 때; UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

Formatter

public Formatter(File  file,
                 String  csn,
                 Locale  l)
          throws FileNotFoundException,

                 UnsupportedEncodingException

지정된 파일, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.

파라미터:: file - 이 포매터의 행선지로서 사용되는 파일. 파일이 존재하는 경우는 제로의 사이즈에 잘라 버릴 수 있어 그렇지 않은 경우는 새로운 파일이 작성된다. 출력은 파일에 출력해져 버퍼에 넣어지는; csn - 지원하는 charset 이름; l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다
예외:: FileNotFoundException - 지정된 파일 객체가 기존의 파일을 나타내지 않는 출력가능한 보통 의 파일 및 새로운의 보통 파일이 그 이름으로 작성할 수 없는 또는 파일의 오픈 또는 작성중에 다른 에러가 발생했을 경우; SecurityException - 시큐러티 매니저가 존재하는 경우에 시큐러티 매니저의 checkWrite(file.getPath()) 가 파일에의 쓰기 권한을 허가하지 않을 때; UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

Formatter

public Formatter(PrintStream  ps)

지정된 출력 스트림을 가지는 새로운 포매터를 구축합니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

문자는 지정된 PrintStream 객체에 출력해지기 때문에 이 객체의 캐릭터셋를 사용해 encode 됩니다.

파라미터:: ps - 이 포매터의 행선지로서 사용되는 스트림

Formatter

public Formatter(OutputStream  os)

지정된 출력 스트림을 가지는 새로운 포매터를 구축합니다.

사용되는 캐릭터셋는 이 Java 가상 머신 인스턴스의 디폴트 캐릭터셋입니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: os - 이 포매터의 행선지로서 사용되는 출력 스트림. 출력은 버퍼에 넣어진다

Formatter

public Formatter(OutputStream  os,
                 String  csn)
          throws UnsupportedEncodingException

지정된 출력 스트림 및 캐릭터셋를 가지는 새로운 포매터를 구축합니다.

사용되는 로케일은 이 Java 가상 머신 인스턴스의 디폴트 로케일입니다.

파라미터:: os - 이 포매터의 행선지로서 사용되는 출력 스트림. 출력은 버퍼에 넣어지는; csn - 지원하는 charset 이름
예외:: UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

Formatter

public Formatter(OutputStream  os,
                 String  csn,
                 Locale  l)
          throws UnsupportedEncodingException

지정된 출력 스트림, 캐릭터셋 및 로케일을 가지는 새로운 포매터를 구축합니다.

파라미터:: os - 이 포매터의 행선지로서 사용되는 출력 스트림. 출력은 버퍼에 넣어지는; csn - 지원하는 charset 이름; l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다
예외:: UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

메서드의 상세

locale

public Locale  locale()

이 포매터를 구축하는 것으로 설정된 로케일을 리턴합니다.

로케일 인수를 가지는 이 객체의 format 메서드는 이 값을 돌려주지 않습니다.

반환값:: 지역 대응이 적용되지 않는 경우는 null, 그렇지 않은 경우는 로케일
예외:: FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

out

public Appendable  out()

출력처를 리턴합니다.

반환값:: 출력처
예외:: FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

toString

public String  toString()

출력 먼저 대해 toString()를 호출한 결과를 리턴합니다. 예를 들어 다음의 코드에 의해 텍스트가 StringBuilder 내에서 서식 설정되어, 결과의 캐릭터 라인이 취득됩니다.

 Formatter f = new Formatter();
 f.format("Last reboot at %tc", lastRebootDate);
 String s = f.toString();
 // -> s == "Last reboot at Sat Jan 01 00:00:00 PST 2000"

이 메서드 호출의 동작은 다음의 호출의 동작과 완전히 동일합니다.


     out(). toString()

Appendable에 대한 toString 지정에 응해, 리턴된 캐릭터 라인에 행선지에 출력해진 문자가 포함되는 일도, 포함되지 않는 것도 있습니다. 예를 들어 보통, 버퍼는 toString() 내용을 리턴합니다만, 스트림에서는 데이터가 파기되기 위해서 그것을 할 수 없습니다.

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 출력 먼저 대해 toString()를 호출한 결과
예외:: FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

flush

public void flush()

이 포매터를 플래시 합니다. 행선지가 Flushable 인터페이스를 구현하는 경우, flush 메서드가 호출됩니다.

포매터의 플래시에의해 행선지에서 버퍼에 넣어진 임의의 출력이 기본으로 되는 스트림에 출력해집니다.

정의:: 인터페이스 Flushable 내의 flush

예외:: FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

close

public void close()

이 포매터를 닫습니다. 행선지가 Closeable 인터페이스를 구현하는 경우, close 메서드가 호출됩니다.

포매터를 닫으면, 그것이 보관 유지하고 있던 자원 (열려 있던 파일등)을 해방할 수 있습니다. 포매터가 이미 닫혀지고 있는 경우, 이 메서드를 호출해도 무슨 효과도 없습니다.

이 포매터를 닫은 후에 이 포매터내의 ioException() 이외의 메서드를 호출하려고 하면, FormatterClosedException을 발생시킵니다.

정의:: 인터페이스 Closeable 내의 close

ioException

public IOException  ioException()

이 포매터 Appendable 에 의해 마지막에 Throw 된 IOException을 리턴합니다.

행선지의 append() 메서드가 전혀 IOException을 Throw 하지 않는 경우, 이 메서드는 항상 null을 리턴합니다.

반환값:: Appendable에 의해 Throw 된 마지막 예외. 해당하는 예외가 존재하지 않는 경우는 null

format

public Formatter  format(String  format,
                        Object ... args)

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 객체의 행선지에 출력합니다. 사용되는 로케일은 이 포매터의 구축시에 정의된 로케일입니다.

파라미터:: format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인; args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 최대수는 Java 가상 머신 사양으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다
반환값:: 이 포매터
예외:: IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든자세한 내용은 formatter 클래스 사양의 「상세」섹션을 참조; FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

format

public Formatter  format(Locale  l,
                        String  format,
                        Object ... args)

지정된 로케일, 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 객체의 행선지에 출력합니다.

파라미터:: l - 서식 설정시에 적용하는로케일 . l가 null인 경우, 지역 대응은 적용되지 않는다. 구축시로 설정된 이 객체의 로케일이 이것에 의해 변경될 것은 없는; format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인; args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 최대수는 Java 가상 머신 사양으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다
반환값:: 이 포매터
예외:: IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든자세한 내용은 formatter 클래스 사양의 「상세」섹션을 참조; FormatterClosedException - close() 메서드를 호출하는 것으로 이 포매터가 닫혀졌을 경우

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 차의 클래스

프레임으로 프레임 없이

개요: 상자 | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.util 클래스 Formatter

구성

변환

플래그

Width

Precision

인수의 인덱스

일반

행 단락 문자

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

Formatter

locale

out

toString

flush

close

ioException

format

format

java.util
클래스 Formatter