numberFormat

숫자의 형식화를 위한 대표적인 클래스는 java.text.NumberFormat 클래스이다. 이는 java.text.Format 클래스를 상속 받고 있으며 각종 숫자에 대한 형식화를 할 수 있는 메쏘드들을 내장하고 있다.

NumberFormat 클래스는 여러 형태의 NumberFormat의 instance를 얻을 수 있는 getXxxInstance()등과 같은 static method들을 제공 하는데 이를 살펴보면 다음과 같다.

-. NumberFormat.getInstance() : NumberFormat의 기본 instance을 반환 한다. 이는 getNumberInstance()를 호출 하는 것과 같은 결과를 얻을 수 있다.

-. NumberFormat.getCurrencyInstance() : 이 메소드는 금액 앞에 통화기호를 그리고  각 단위마다 ","를 표현 할 수 있는 NumberFormat의 instance를 반환 한다.

-. NumberFormat.getPercentInstance() : 이 메소드는 숫자에 "%"를 표시 할 수 있는 instance를 반환 한다.

-. NumberFormat.getIntegerInstance() : 실수를 반 올림 해서 표현 할 수 있는 instance를 반환 한다.

위에 언급된 getXxxInstance()류는 모두 Default Locale을 사용 한 것이며 특정 Locale로 표현 하고 싶을 때는 NumberFormat.getInstance( Locale loc )등과 같이 Locale을 지정 해주면 된다.

1. 가장 기본이 되는 getInstance()를 사용한 예제.
    import java.text.NumberFormat;
    import java.util.Locale;
    public class NumberFormatTest{
        long long_01 = 1000000L;
        double double_01 = 1234567890.888;
        public void doInstance(){
            NumberFormat nf = NumberFormat.getInstance();
            print( nf, long_01 );
            print( nf, double_01 );
        }
        public void doNumberInstance(){
            NumberFormat nf = NumberFormat.getNumberInstance();
            print( nf, long_01 );
            print( nf, double_01 );
        }
        //가독성을 위해 long L로 사용함.
        private void print( NumberFormat nf, long L ){
            System.out.println( "format of long value : " + nf.format( L ) );
        }
        private void print( NumberFormat nf, double d ){
            System.out.println( "format fo double value : " + nf.format( d ) );
        }
        public static void main(String[] args) {
            NumberFormatTest nft = new NumberFormatTest();
            nft.doInstance();
            nft.doNumberInstance();
        }
    }
    결과 :
    ============================================
    format of long value : 1,000,000
    format fo double value : 1,234,567,890.888
    --------------------------------------------
    format of long value : 1,000,000
    format fo double value : 1,234,567,890.888
    ============================================
위의 결과에서 볼 수 있듯이 getInstance()를 사용 했을 때와 getNumberInstance()를 이용 했을 때 모두 같은 결과가 나온다는 것을 알 수 있다.

2. getCurrencyInstance()를 사용한 예제.
*/
    /*
    import java.text.NumberFormat;
    import java.util.Locale;
    public class NumberFormatTest{
        long long_01 = 1000000L;
        double double_01 = 1234567890.8888889;
        public void doCurrencyUsingDefaultLocale(){
            NumberFormat nf = NumberFormat.getCurrencyInstance();
            print( nf, long_01 );
            print( nf, double_01 );
            //소수점 이하 최대 자리를 지정한다.
            nf.setMaximumFractionDigits( 3 ) ;
            print( nf, double_01 );
        }
        public void doCurrencyUsingSpecificLocale(){
            NumberFormat nf = NumberFormat.getCurrencyInstance( Locale.JAPAN );
            print( nf, long_01 );
            print( nf, double_01 );
            nf = NumberFormat.getCurrencyInstance( Locale.US );
            print( nf, long_01 );
            print( nf, double_01 );
           
            //소수점 이하 최대 자리를 지정한다.
            nf.setMaximumFractionDigits( 1 ) ;
            print( nf, double_01 );
        }
        //가독성을 위해 long L로 사용함.
        private void print( NumberFormat nf, long L ){
            System.out.println( "format of long value : " + nf.format( L ) );
        }
        private void print( NumberFormat nf, double d ){
            System.out.println( "format of double value : " + nf.format( d ) );
        }
        public static void main(String[] args) {
            NumberFormatTest nft = new NumberFormatTest();
            nft.doCurrencyUsingDefaultLocale();
            nft.doCurrencyUsingSpecificLocale();
        }
    }
    */
    /*
    결과 :
    =========================================
    format of long value : ￦1,000,000
    format of double value : ￦1,234,567,891
    format of double value : ￦1,234,567,890.889
    -----------------------------------------
    format of long value : ￥1,000,000
    format of double value : ￥1,234,567,891
    -----------------------------------------
    format of long value : $1,000,000.00
    format of double value : $1,234,567,890.89
    format of double value : $1,234,567,890.9
    ========================================
결과를 살펴 보면 해당 국가의 통화 기호가 앞에 표시 되는 걸 볼 수 있다. 특이한 것은 바로 이전의 예제와는 달리 setMaximumFractionDigits( int value )이라는 메소드가 사용 된 점이다.
setMaximumFractionDigits( int value) 는 최대로 표현 할 수 있는 소수점 이하 자리를 지정 할 때 사용된다. 이 메소드를 사용 하면 지정한 바로 다음 소수자리에서 반올림이 되고 그 이하 자리는 가차 없이 버려진다.

3. getPercentInstance()를 사용한 예제.
*/
    import java.text.NumberFormat;
    import java.util.Locale;
    public class NumberFormatTest{
        long long_01 = 3L;
        double double_01 = 0.897659;
        public void doPercentInstanceUsingDefaultLocale(){
            NumberFormat nf = NumberFormat.getPercentInstance();
            print( nf, long_01 );
            //최소한 표현 되어야 할 소수 자리를 지정한다.
            nf.setMinimumFractionDigits(1);
            print( nf, long_01 );
            print( nf, double_01 );
            //소수점 이하 최대 자리를 지정한다.
            nf.setMaximumFractionDigits( 3 ) ;
            print( nf, double_01 );
        }
        //가독성을 위해 long L로 사용함.
        private void print( NumberFormat nf, long L ){
            System.out.println( "format of long value : " + nf.format( L ) );
        }
        private void print( NumberFormat nf, double d ){
            System.out.println( "format of double value : " + nf.format( d ) );
        }
        public static void main(String[] args) {
            NumberFormatTest nft = new NumberFormatTest();
            nft.doPercentInstanceUsingDefaultLocale();
        }
    }
    /*
    결과 :
    ===========================================
    format of long value : 300%
    format of long value : 300.0%
    -------------------------------------------
    format of double value : 89.8%
    format of double value : 89.766%
    ===========================================
결과는 위와 같다. 여기서는 setMinimunFractionDigits( int value )라는 메소드가 사용 되었는데 이는 최소한 표현을 해야 하는 소수점 이하 자리를 지정한다. 이를 지정하지 않으면 정수의 경우 소수점은 표시 되지 않는다.  getPercentInstance()를 사용하면 퍼센트(%)로 형식화 하는데 아주 편리하다.

이외에도 유용한 메소드로는 setGroupingUsed( boolean used )라는 메소드가 있는데 이 메소드를 통해 1000단위로 ","의 사용 여부를 결정해서 쓸 수 있다.

====================================
2002.12.03-00:10 너부리 - 최인국(희선)