0Pricing
Java Academy · 강의

NumberFormat과 printf

NumberFormat, DecimalFormat, printf 형식을 사용해 표시할 숫자를 서식화합니다.

NumberFormat과 printf은(는) CoddyKit의 무료 Java Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Java Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

NumberFormat과 형식 지정 출력

Java는 다양한 숫자 서식 지정 API를 제공합니다. 로캘을 고려한 통화 및 백분율에는 NumberFormat, 사용자 지정 패턴에는 DecimalFormat, C 스타일 서식 지정에는 printf/String.format을 사용합니다.

String.format 기본

String.format()은 서식 지정자를 사용하여 문자열을 만듭니다. 일반적인 지정자는 %d(정수), %f(실수), %s(문자열), %n(줄 바꿈)입니다.

String name = "Alice";
int score = 95;
double avg = 87.567;

String msg = String.format(
    "Player: %s | Score: %d | Average: %.2f", name, score, avg);
System.out.println(msg);
// Player: Alice | Score: 95 | Average: 87.57

// printf is equivalent — formats directly to output
System.out.printf("%-10s %5d %8.2f%n", name, score, avg);
// Alice          95    87.57

너비, 채우기 및 정렬

서식 지정자는 너비와 정렬 플래그를 지원합니다. %10d는 10칸 안에서 오른쪽 정렬하고, %-10d는 왼쪽 정렬하며, %010d는 0으로 채웁니다.

// Table layout with padding
System.out.printf("%-20s %10s %10s%n", "Product", "Qty", "Price");
System.out.printf("%-20s %10d %10.2f%n", "Java Book", 3, 49.99);
System.out.printf("%-20s %10d %10.2f%n", "USB Hub", 1, 24.95);
System.out.printf("%-20s %10d %10.2f%n", "Mechanical Keyboard", 2, 129.00);

// Zero-padding for order IDs
int orderId = 42;
System.out.printf("Order: ORD-%08d%n", orderId); // Order: ORD-00000042

통화를 위한 NumberFormat

NumberFormat.getCurrencyInstance(Locale)는 지정한 로캘에 맞는 기호, 구분 기호 및 소수 자릿수를 사용하여 숫자를 통화 문자열로 서식 지정합니다.

import java.text.*;
import java.util.*;

NumberFormat usd = NumberFormat.getCurrencyInstance(Locale.US);
NumberFormat eur = NumberFormat.getCurrencyInstance(Locale.GERMANY);
NumberFormat gbp = NumberFormat.getCurrencyInstance(Locale.UK);

double amount = 1234567.89;
System.out.println(usd.format(amount)); // $1,234,567.89
System.out.println(eur.format(amount)); // 1.234.567,89 EUR
System.out.println(gbp.format(amount)); // GBP1,234,567.89

백분율을 위한 NumberFormat

NumberFormat.getPercentInstance()는 소수를 백분율 문자열로 서식 지정합니다. 0과 1 사이의 값을 전달합니다.

import java.text.*;
import java.util.*;

NumberFormat pct = NumberFormat.getPercentInstance(Locale.US);
pct.setMaximumFractionDigits(1);

System.out.println(pct.format(0.75));     // 75%
System.out.println(pct.format(0.1234));   // 12.3%
System.out.println(pct.format(1.0));      // 100%

// Conversion rate in e-commerce
double convRate = 3_456.0 / 42_000.0;
System.out.println("Conversion: " + pct.format(convRate)); // 8.2%

사용자 지정 패턴을 사용하는 DecimalFormat

DecimalFormat은 #을 선택적 숫자로, 0을 필수 숫자로 해석하는 패턴 문자열을 사용합니다.

import java.text.*;

DecimalFormat df1 = new DecimalFormat("#,###.00");
System.out.println(df1.format(1234567.5));  // 1,234,567.50

DecimalFormat df2 = new DecimalFormat("000.0");
System.out.println(df2.format(7.5));  // 007.5

DecimalFormat df3 = new DecimalFormat("0.00E0");
System.out.println(df3.format(0.000123)); // 1.23E-4

// Scientific notation for large values
DecimalFormat sci = new DecimalFormat("0.000E0");
System.out.println(sci.format(123456789)); // 1.235E8

문자열에서 숫자 구문 분석하기

NumberFormat은 로캘에 맞게 서식 지정된 문자열을 다시 숫자로 구문 분석할 수도 있습니다. 이는 서로 다른 로캘에서 사용자 입력을 읽을 때 필수적입니다.

import java.text.*;
import java.util.*;

NumberFormat nf = NumberFormat.getInstance(Locale.GERMANY);
try {
    // German uses comma as decimal separator
    Number parsed = nf.parse("1.234,56");
    System.out.println(parsed.doubleValue()); // 1234.56

    // Parse US currency string
    NumberFormat usd = NumberFormat.getCurrencyInstance(Locale.US);
    Number amount = usd.parse("$1,234.56");
    System.out.println(amount.doubleValue()); // 1234.56
} catch (ParseException e) {
    System.out.println("Parse error: " + e.getMessage());
}

서식 지정 문자열(Java 15 이상)

Java 15 이상에서는 String.format()의 인스턴스 메서드 대안으로 String.formatted()를 추가했습니다. 메서드 연결과 stream 처리 흐름에서 유용합니다.

record Product(String name, double price, int stock) {}

var products = List.of(
    new Product("Laptop", 999.0, 5),
    new Product("Mouse",  29.99, 42),
    new Product("Monitor", 349.0, 8)
);

products.stream()
    .map(p -> "%-15s $%8.2f  [stock: %d]"
        .formatted(p.name(), p.price(), p.stock()))
    .forEach(System.out::println);
// Laptop          $  999.00  [stock: 5]
// Mouse           $   29.99  [stock: 42]
// Monitor         $  349.00  [stock: 8]

숫자 그룹화와 로캘

숫자 그룹화(천 단위 구분 기호)는 로캘에 따라 달라집니다. 사용자에게 표시하는 출력에서는 쉼표를 직접 고정해 넣지 말고 항상 NumberFormat을 사용합니다.

import java.text.*;
import java.util.*;

long users = 1_234_567;

for (Locale locale : new Locale[]{Locale.US, Locale.FRANCE, Locale.GERMANY}) {
    NumberFormat nf = NumberFormat.getIntegerInstance(locale);
    System.out.printf("%-10s: %s%n", locale, nf.format(users));
}
// en_US     : 1,234,567
// fr_FR     : 1 234 567
// de_DE     : 1.234.567

청구서 생성 예제

통화와 백분율을 올바르게 표시하고 표를 정렬하여 서식 지정된 청구서 출력물을 생성하는 과정을 종합합니다.

import java.text.*;
import java.util.*;

NumberFormat curr = NumberFormat.getCurrencyInstance(Locale.US);
NumberFormat pct  = NumberFormat.getPercentInstance();
pct.setMaximumFractionDigits(0);

double subtotal = 1259.97;
double discount = 0.10;
double discountAmt = subtotal * discount;
double taxRate = 0.08;
double taxAmt = (subtotal - discountAmt) * taxRate;
double total = subtotal - discountAmt + taxAmt;

System.out.println("=== INVOICE ===");
System.out.printf("%-20s %15s%n", "Subtotal",       curr.format(subtotal));
System.out.printf("%-20s %15s%n", "Discount (" + pct.format(discount) + ")",
    "-" + curr.format(discountAmt));
System.out.printf("%-20s %15s%n", "Tax (" + pct.format(taxRate) + ")",
    curr.format(taxAmt));
System.out.printf("%-20s %15s%n", "TOTAL", curr.format(total));

일반적인 주의 사항

다음과 같은 일반적인 서식 지정 실수를 주의합니다:

  • 잘못된 형식 지정자를 사용하여 String.format을 호출하면(예: double에 %d 사용) IllegalFormatConversionException이 발생합니다
  • 로캘별 서식 지정기는 컴퓨터마다 서로 다른 출력을 만들 수 있습니다
  • NumberFormat 인스턴스는 스레드 안전하지 않으므로 스레드마다 하나씩 생성하거나 ThreadLocal을 사용합니다
// Wrong specifier
try {
    String.format("%d", 3.14); // IllegalFormatConversionException
} catch (java.util.IllegalFormatConversionException e) {
    System.out.println("Wrong format specifier!");
}

// Thread-safe pattern using ThreadLocal
ThreadLocal<NumberFormat> localFmt = ThreadLocal
    .withInitial(() -> NumberFormat.getCurrencyInstance(Locale.US));
// each thread gets its own NumberFormat instance

빠른 확인

String.format("%08.2f", 3.5)의 결과는 무엇입니까?

복습: NumberFormat과 형식 지정 출력

핵심 내용:

  • String.format / 형식 지정 출력은 형식 지정자 %d, %f, %s, %.2f를 사용합니다
  • 너비와 정렬 플래그: %10d(오른쪽), %-10d(왼쪽), %010d(0으로 채움)
  • 로캘을 고려한 통화 표시는 NumberFormat.getCurrencyInstance()를 사용합니다
  • 백분율 출력은 NumberFormat.getPercentInstance()를 사용합니다
  • DecimalFormat은 #(선택적)과 0(필수) 숫자 패턴을 사용합니다
  • NumberFormat은 로캘에 맞게 서식 지정된 문자열을 다시 숫자로 구문 분석할 수도 있습니다

자주 묻는 질문

“NumberFormat과 printf” 강의는 무료인가요?

네 — “NumberFormat과 printf” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Java Academy 강의 전체를 잠금 해제할 수 있습니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“NumberFormat과 printf”에서 뭘 배우나요?

NumberFormat, DecimalFormat, printf 형식을 사용해 표시할 숫자를 서식화합니다. 브라우저에서 직접 실행하는 실습 코드로 Java Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Java Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Java Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“NumberFormat과 printf” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Java Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Java Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Math 클래스 핵심
  2. 정수 연산과 오버플로
  3. 금융 계산을 위한 BigDecimal
  4. NumberFormat과 printf
← Java Academy(으)로 돌아가기