Java 숫자 포매팅: DecimalFormat으로 원하는 모든 형식 만들기

들어가며: 숫자를 보기 좋게 표현하는 방법 #

애플리케이션에서 숫자를 다룰 때, 단순히 값을 보여주는 것을 넘어 사용자가 읽기 편한 형태로 가공해야 하는 경우가 많습니다. 예를 들어, 1234567.89라는 숫자를 “1,234,567.89"나 “$1,234,567.89"와 같이 표현하는 것입니다.

Java에서는 java.text.DecimalFormat 클래스를 통해 이러한 숫자 포매팅을 매우 유연하고 강력하게 처리할 수 있습니다. DecimalFormat은 NumberFormat의 하위 클래스로, 특정 패턴을 사용하여 숫자를 원하는 형식의 문자열로 변환하거나, 반대로 형식화된 문자열을 다시 숫자로 파싱하는 기능을 제공합니다.

이 글에서는 DecimalFormat의 핵심적인 사용법을 다양한 예제와 함께 알아보겠습니다.

핵심 패턴 문자 이해하기 #

DecimalFormat의 강력함은 패턴 문자를 조합하여 원하는 형식을 만드는 데 있습니다. 가장 중요하고 자주 사용되는 패턴 문자는 다음과 같습니다.

0과 #의 차이점이 가장 중요합니다. 0은 자리 수를 강제로 맞추고 싶을 때, #은 불필요한 0을 제거하고 싶을 때 사용합니다.

주요 포매팅 예제 #

실제 코드를 통해 다양한 포매팅 예제를 살펴보겠습니다.

1. 소수점 자릿수 제어 및 반올림 #

패턴에서 소수점 이하 자릿수를 지정하면, 그에 맞게 숫자가 반올림 됩니다.

double num = 123.456;

// 소수점 둘째 자리까지 표시 (셋째 자리에서 반올림)
Assertions.assertEquals("123.46", new DecimalFormat("#.##").format(num));

// 소수점 첫째 자리까지 표시 (둘째 자리에서 반올림)
Assertions.assertEquals("123.5", new DecimalFormat("0.0").format(num));

// 정수 부분만 표시 (소수점 첫째 자리에서 반올림)
Assertions.assertEquals("123", new DecimalFormat("#").format(num));

2. 0으로 자릿수 채우기 (Zero Padding) #

0 패턴을 사용하면 원하는 자릿수를 0으로 채울 수 있습니다. 고정 길이의 숫자 문자열을 만들 때 유용합니다.

double num = 12.3;

// 정수 4자리, 소수 3자리로 강제. 부족한 부분은 0으로 채움.
Assertions.assertEquals("0012.300", new DecimalFormat("0000.000").format(num));

// # 패턴은 0을 채우지 않음.
Assertions.assertEquals("12.3", new DecimalFormat("####.###").format(num));

3. 천 단위 구분 기호 (Grouping) #

, 패턴을 사용하여 큰 숫자의 가독성을 높일 수 있습니다. #,##0 패턴이 가장 일반적으로 사용됩니다.

double largeNum = 1234567.89;

Assertions.assertEquals("1,234,567.89", new DecimalFormat("#,##0.00").format(largeNum));
Assertions.assertEquals("1,234,568", new DecimalFormat("#,##0").format(largeNum)); // 반올림됨

4. 통화 및 백분율 포매팅 #

¤와 % 패턴을 사용하여 통화 및 백분율을 쉽게 표현할 수 있습니다.

double money = 5678.9;
double rate = 0.75;

// 로케일이 US라고 가정
Assertions.assertEquals("$5,678.90", new DecimalFormat("¤#,##0.00").format(money));

// 숫자에 100을 곱한 후 % 기호를 붙임
Assertions.assertEquals("75%", new DecimalFormat("##%").format(rate));

5. 문자열 리터럴 혼합 #

패턴 안에 일반 문자열을 포함하여 형식을 꾸밀 수 있습니다. 특수 문자를 리터럴로 사용하고 싶을 때는 작은따옴표(')로 감싸줍니다.

long userId = 8827L;

Assertions.assertEquals("User ID: 8827", new DecimalFormat("'User ID:' #").format(userId));

지역화(Localization) 포매팅 #

국가별로 숫자 표기법이 다릅니다. 예를 들어, 미국에서는 1,234.56으로 표기하지만, 독일에서는 1.234,56으로 표기합니다. DecimalFormat은 Locale 정보를 이용하여 이러한 지역화된 포매팅을 자동으로 처리할 수 있습니다.

double num = 1234567.89;
String pattern = "#,###.##";

// 영어권 로케일
DecimalFormatSymbols symbolsEn = new DecimalFormatSymbols(Locale.ENGLISH);
Assertions.assertEquals("1,234,567.89", new DecimalFormat(pattern, symbolsEn).format(num));

// 이탈리아 로케일
DecimalFormatSymbols symbolsIt = new DecimalFormatSymbols(Locale.ITALIAN);
Assertions.assertEquals("1.234.567,89", new DecimalFormat(pattern, symbolsIt).format(num));

문자열을 숫자로 파싱하기 #

parse() 메서드를 사용하면 형식화된 문자열을 다시 Number 객체로 변환할 수 있습니다. 파싱할 문자열이 지정된 패턴과 일치하지 않으면 ParseException이 발생할 수 있으므로 예외 처리가 필요합니다.

String numStr = "1,234.56";
DecimalFormat format = new DecimalFormat("#,##0.00");

try {
    Number parsedNum = format.parse(numStr);
    Assertions.assertEquals(1234.56, parsedNum.doubleValue());
} catch (ParseException e) {
    e.printStackTrace();
}

⚠️ 매우 중요: 스레드 안전성 문제 #

DecimalFormat 클래스는 스레드에 안전하지 않습니다(not thread-safe). 이는 여러 스레드에서 동일한 DecimalFormat 인스턴스를 공유하며 동시에 사용하면 예기치 않은 결과가 나오거나 오류가 발생할 수 있음을 의미합니다.

웹 애플리케이션과 같은 멀티스레드 환경에서는 이 문제를 반드시 해결해야 합니다. 해결 방법은 다음과 같습니다.

1. 매번 새로 생성하기: 메서드 내에서 매번 new DecimalFormat(...)을 호출하여 지역 변수로 사용합니다. 간단하지만, 객체 생성 비용이 발생할 수 있습니다.

2. ThreadLocal 사용하기: 각 스레드마다 별도의 DecimalFormat 인스턴스를 갖도록 ThreadLocal로 감싸서 사용합니다. 이는 스레드 안전성을 보장하면서 객체 재사용의 이점을 누릴 수 있는 가장 권장되는 방법입니다.

   private static final ThreadLocal<DecimalFormat> myFormatter = 
       ThreadLocal.withInitial(() -> new DecimalFormat("#,##0.00"));
   
   public String formatNumber(double num) {
       return myFormatter.get().format(num);
   }
   

결론 #

DecimalFormat은 Java에서 숫자를 다룰 때 매우 유용하고 강력한 도구입니다. 다양한 패턴 문자를 조합하여 거의 모든 종류의 숫자 형식을 만들 수 있습니다. 하지만 그 편리함 이면에 있는 스레드 안전성 문제 를 반드시 인지하고, 멀티스레드 환경에서는 ThreadLocal을 사용하는 등의 방법으로 안전하게 사용해야 합니다.

참고 자료:

• Baeldung - A Practical Guide to DecimalFormat
• Oracle Java 11 Documentation - DecimalFormat