숫자 서식 지정

항목	값
화면 이름	Format number
식별자	`formatNumberV1`
지원 실행 방식	Batch, Faster, Streaming
범주	자료형 변환 (Cast), 숫자 (Numeric), 문자열 (String)
반환 자료형	`String`

숫자를 지정한 소수 자릿수로 서식 지정합니다.

입력 인자

이름	지정 여부	자료형	의미와 조건
`Decimal places`	필수	`Literal<Integer>`	소수 자릿수입니다.
`Number`	필수	`Expression<Numeric>`	서식 지정할 숫자입니다.

입출력 예시

예시 1: 기본 동작

숫자를 소수 둘째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 2
Number: 1234.5678

출력: 1,234.57

예시 2: 기본 동작

Byte 숫자를 소수 첫째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 1
Number: 42

출력: 42.0

예시 3: 기본 동작

Float 숫자를 소수 첫째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 1
Number: 1234.56

출력: 1,234.6

예시 4: 기본 동작

정수를 소수 자릿수 없이 서식 지정합니다.

인자 값:

Decimal places: 2
Number: 1234

출력: 1,234.00

예시 5: 기본 동작

큰 숫자를 소수 둘째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 2
Number: 123456789.123456789

출력: 123,456,789.12

예시 6: 기본 동작

Long 숫자를 소수 첫째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 1
Number: 4242424242424242

출력: 4,242,424,242,424,242.0

예시 7: 기본 동작

숫자를 소수 자릿수 없이 서식 지정합니다.

인자 값:

Decimal places: 0
Number: 1234.5678

출력: 1,235

예시 8: 기본 동작

Short 숫자를 소수 첫째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 1
Number: 42

출력: 42.0

예시 9: 기본 동작

큰 숫자를 소수 둘째 자리까지 서식 지정합니다.

인자 값:

Decimal places: 2
Number: 123456789123456789123456.0

출력: 123,456,789,123,456,789,123,456.00

예시 10: null 처리

null 입력을 처리하는 경우입니다.

인자 값:

Decimal places: 2
Number: number

number	출력
null	null

예시 11: 경계 조건

숫자를 소수점 아래 50자리까지 서식 지정합니다.

인자 값:

Decimal places: 50
Number: 1234.0

출력: 1,234.00000000000000000000000000000000000000000000000000