자바, Format 클래스

주의 사항!

• 이 글은 제가 직접 공부하는 중에 작성되고 있습니다.
• 따라서 제가 이해하는 그대로의 내용이 포함됩니다.
• 따라서 이 글은 사실과는 다른 내용이 포함될 수 있습니다.

정수 세 자리마다 쉼표(,)를 넣고 싶다면, 정수를 문자열로 변환한 다음, 세 자리씩 끊어서 쉼표를 넣을 수 있을 것입니다. 하지만 이 작업은 매우 귀찮은 작업이고 코드가 지저분해집니다. 다른 예로 많은 수의 점수를 리스트화해서 출력할 때 소수점 한 자리로 일정하게 맞추는 것도, 날짜를 년, 월, 일 과 같이 원하는 형식으로 맞추려면 역시 작업이 귀찮아지고 코드가 지저분해집니다.

 

자바에서는 이 문제를 쉽게 해결할 수 있는 방법을 제공하는데, 이것이 형식 클래스입니다. 이 클래스는 java.text 패키지에 포함되어 있는데, 숫자 형식을 위해 DecimalFormat, 날짜 형식을 위해 SimpleDateFormat, 매개 변수화된 문자열 형식을 위해 MessageFormat 등을 제공합니다.

 

숫자 형식 클래스(DecimalFormat)

DecimalFormat은 숫자 데이터를 원하는 형식으로 표현하기 위해서 패턴을 사용하는데 다음 표는 패턴의 예를 보여줍니다.

기호	의미	패턴 예	1234567.89를 변환한 결과
0	10진수(빈자리는0으로 채움)	0 0.0 0000000000.00000	1234568 1234567.9 0001234567.89000
#	10진수(빈자리는 채우지 않음)	# #.# ##########.#####	1234568 1234567.9 1234567.89
.	소수점	#.0	1234567.9
-	음수 기호	+#.0 -#.0	+1234567.9 -1234567.9
,	단위 구분	#,###.0	1,234,567.9
E	지수 문자	0.0E0	1.2E6
;	양수와 음수의 패턴을 모두 기술할 경우, 패턴 구분자	+#,###;-#,###	+1,234,568(양수일 때) -1,234,568(음수일 때)
%	100을 곱한 후에 % 문자 붙임	#.#%	123456789%
\u00A4	통화 기호	\u00A4 #,###	￦ 1,234,568

적용할 패턴을 선택했다면 DecimalFormat 생성자 매개 값으로 지정해서 객체를 생성하면 됩니다. 그러고 나서 format() 메서드를 호출해서 패턴이 적용된 문자열을 얻으면 됩니다.

DecimalFormat df = new DecimalFormat("#,###.0");
String result = df.format(1234567.89);

//result == 1,234,567.9

다음 예제는 다양한 패턴을 적용해서 얻은 문자열을 출력하는 예제입니다.

//Main.java
package Example;

import java.text.DecimalFormat;

public class Main {
	public static void main(String[] args) {		
		double num = 1234567.89;
		
		DecimalFormat df = new DecimalFormat("0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("0.0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("0000000000.00000");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("#");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("#.#");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("##########.#####");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("#.0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("+#.0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("-#.0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("#,###.0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("0.0E0");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("+#,###;-#,###");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("#.#%");
		System.out.println(df.format(num));
		
		df = new DecimalFormat("\u00A4 #,###");
		System.out.println(df.format(num));
	}
}

/*
실행결과

1234568
1234567.9
0001234567.89000
1234568
1234567.9
1234567.89
1234567.9
+1234567.9
-1234567.9
1,234,567.9
1.2E6
+1,234,568
123456789%
? 1,234,568

*/

 

날짜 형식 클래스(SimpleDateFormat)

Date 클래스의 toString() 메서드는 영문으로 된 날짜를 리턴하는데 만약 특정 문자열 포맷으로 얻고 싶다면 java.text.SimpleDateFormat 클래스를 이용하면 됩니다. SimpleDateFormat 클래스도 날짜를 원하는 형식으로 표현하기 위해서 패턴을 사용하는데 다음 표는 SimpleDateFormat의 패턴 작성에 사용되는 기호들입니다.

패턴 문자	의미	패턴 문자	의미
y	년	H	시(0~23)
M	월	h	시(1~12)
d	일	K	시(0~11)
D	월 구분이 없는 일(1~365)	k	시(1_24)
E	요일	m	분
a	오전/오후	s	초
w	년의 몇 번째 주	S	밀리세컨드(1/1000초)
W	월의 몇 번째 주

패턴에는 자릿수에 맞게 기호를 반복해서 작성할 수 있습니다. 예를 들어 yyyy는 년도를 4자리로 표시하라는 의미이고, MM, dd는 각각 월과 일을 2자리로 표시하라는 의미입니다. 적용할 패턴을 작성했다면 이 패턴을 SimpleDateFormat의 생성자 매개 값으로 지정해서 객체를 생성하면 됩니다. 그러고 나서 format() 메서드를 호출해서 패턴이 적용된 문자열을 얻으면 됩니다.

SimpleDateFormat sdf = new SimpleDateFormat("yyyy년 MM월 dd일");
String strDate = sdf.format(new Date());

다음은 다양한 패턴을 적용해서 얻은 문자열을 출력하는 예제입니다.

//Main.java
package Example;

import java.text.SimpleDateFormat;
import java.util.Date;

public class Main {
	public static void main(String[] args) {		
		Date now = new Date();
		
		SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
		System.out.println(sdf.format(now));
		
		sdf = new SimpleDateFormat("yyyy년 MM월 dd일");
		System.out.println(sdf.format(now));
		
		sdf = new SimpleDateFormat("yyyy.MM.dd a hh:mm:ss");
		System.out.println(sdf.format(now));
		
		sdf = new SimpleDateFormat("오늘은 E요일");
		System.out.println(sdf.format(now));

		sdf = new SimpleDateFormat("올해의 D번째 날");
		System.out.println(sdf.format(now));
		
		sdf = new SimpleDateFormat("이달의 d번째 날");
		System.out.println(sdf.format(now));
	}
}

/*
실행결과

2021-04-21
2021년 04월 21일
2021.04.21 오후 05:35:00
오늘은 수요일
올해의 111번째 날
이달의 21번째 날

*/

 

문자열 형식 클래스(MessageFormat)

데이터를 파일에 저장하거나, 네트워크로 전송할 때, 그리고 데이터베이스 SQL문을 작성할 때 등 많은 부분에서 일정한 형식의 문자열을 사용합니다. MessageFormat 클래스를 사용하면 문자열에 데이터가 들어갈 자리를 표시해 두고, 프로그램이 실행하면서 동적으로 데이터를 삽입해 문자열을 완성시킬 수 있습니다.

 

예를 들어 다음과 같이 회원 정보를 출력한다고 가정해 보겠습니다.

회원 ID : KOEY
회원 이름 : 이순신
회원 전화 : 010-1234-5689

만약 id, name, tel이라는 변수에 회원 정보가 저장되어 있을 경우 다음과 같이 문자열 연결 연산자로 출력할 문자열을 생성할 수 있을 것입니다.

String result = "회원 ID : " + id + "\n회원 이름 : " + name + "\n회원 전화 : " + tel;

이 방법도 나쁜 방법은 아니지만, + 연산자로 인해 복잡해 보이고, 전체 문자열을 파악하기 힘듭니다.

 

반면 다음과 같이 MessageFormat 클래스를 사용하면 좀 더 깔끔하게 데이터를 삽입시켜주고 전체 문자열을 쉽게 예측할 수 있습니다.

String message = "회원 ID : {0} \n회원 이름 : {1} \n회원 전화 : {2}";
String result = MessageFormat.format(message,id,name,tel);

MessageFormat은 다른 형식 클래스와는 다르게 정적 format() 메서드를 호출해서 완성된 문자열을 리턴합니다. format() 메서드의 첫 번째 매개 값은 매개 변수화된 문자열을 지정하고, 두 번째 이후의 매개 값은 인덱스 순서에 맞게 값을 나열하면 됩니다. 값을 나열하는 대신, 다음과 같이 배열을 대입해도 좋습니다.

String message = "회원 ID : {0} \n회원 이름 : {1} \n회원 전화 : {2}";
Object[] arguments = {id, name, tel};
String result = MessageFormat.format(message, arguments);

다음은 매개 변수화된 문자열을 이용해서 회원 정보 및 SQL문을 콘솔에 출력하는 예제입니다.

//Main.java
package Example;

import java.text.MessageFormat;

public class Main {
	public static void main(String[] args) {		
		String id = "java";
		String name = "KOEY";
		String tel = "010-1234-5689";
		
		String text = "회원 ID : {0} \n회원 이름 : {1} \n회원 전화 : {2}";
		String result1 = MessageFormat.format(text,  id, name, tel);
		System.out.println(result1);
		System.out.println();
		
		String sql = "insert into member values( {0}, {1}, {2} )";
		Object[] arguments = {"java", "KOEY", "010-1234-5689"};
		String result2 = MessageFormat.format(sql, arguments);
		System.out.println(result2);
	}
}

/*
실행결과

회원 ID : java 
회원 이름 : KOEY 
회원 전화 : 010-1234-5689

insert into member values( java, KOEY, 010-1234-5689 )

*/