PHP의 number_format() 함수는 숫자를 천 단위마다 구분 기호로 묶어 사람이 읽기 쉬운 형태로 포맷팅할 때 사용합니다. 금액 표시, 통계 데이터 출력 등에서 가독성을 크게 높여주는 필수 함수입니다.
문법
number_format(num, decimals, decimal_pt, separator)
매개변수
num − 포맷팅할 숫자입니다.
decimals − 소수점 이하 자릿수를 지정합니다.
decimal_pt − 소수점을 표시할 때 사용할 문자열입니다.
separator − 천 단위 구분 기호로 사용할 문자열입니다.
반환 값
number_format() 함수는 포맷팅된 숫자를 문자열(string) 형태로 반환합니다.
예제 1: 기본 사용법
두 번째 매개변수를 생략하고 호출하면 소수점 없이 천 단위마다 쉼표(,)가 자동으로 추가됩니다.
<?php
echo number_format("10000000");
?>
출력 결과
10,000,000
예제 2: 소수점 자릿수 지정
두 번째 매개변수로 소수점 이하 자릿수를 지정하면, 해당 자릿수만큼 반올림되어 표시됩니다.
<?php
echo number_format("3999.9", 2);
?>
출력 결과
3,999.90
참고 사항
- decimals를 지정하면 소수점은 마침표(.), 천 단위 구분자는 쉼표(,)가 기본값으로 적용됩니다.
- 세 번째와 네 번째 매개변수를 활용하면 유럽식 표기(예: 1.000.000,00)처럼 구분 기호를 자유롭게 변경할 수 있습니다.
- 반환값은 항상 문자열이므로, 이후 산술 연산에 사용하려면 (float) 또는 (int)로 형 변환이 필요할 수 있습니다.