toKRW

한국 원화(KRW)를 위한 빠르고 간편한 숫자 포맷팅 유틸리티 라이브러리입니다.

특징

- 📦 다양한 포맷: 콤마, 한글 단위, 소수점 단위 등 3가지 표시 모드 지원
- 🔧 TypeScript 지원: 완전한 타입 정의 포함
- 📱 범용 호환: CommonJS와 ESM 모두 지원

설치

``bash
npm install tokrw
`

`bash
yarn add tokrw
`

`bash
pnpm add tokrw
`

사용 방법

$3

`javascript
import toKRW from "tokrw";
`

$3

`javascript
const toKRW = require("tokrw");
`

$3

`ts
interface FormatOptions {
/**
* 표시 모드
* - 'comma': 콤마만 추가 (예: 20,000,000원)
* - 'unit': 한글 단위 표시 (예: 2천만원, 1억원, 1억 5천만원)
* - 'decimal': 소수점 단위 표시 (예: 1.5억원)
* @default 'comma'
*/
displayMode?: "comma" | "unit" | "decimal";
}

function toKRW(value: number, options?: FormatOptions): string;
`

$3

숫자를 한국 원화 형식으로 포맷팅합니다.

#### 매개변수

- value (number): 포맷팅할 숫자
- options (FormatOptions, 선택): 포맷팅 옵션
- displayMode ('comma' | 'unit' | 'decimal', 기본값: 'comma'): 표시 모드

#### 반환값

- string: 포맷팅된 문자열 (예: "20,000,000원")

예제

$3

`javascript
toKRW(1000); // '1,000원'
toKRW(20000000); // '20,000,000원'
toKRW(100000000); // '100,000,000원'
toKRW(150000000); // '150,000,000원'
`

$3

`javascript
toKRW(20000000, { displayMode: "unit" }); // '2천만원'
toKRW(100000000, { displayMode: "unit" }); // '1억원'
toKRW(150000000, { displayMode: "unit" }); // '1억 5천만원'
toKRW(123456789, { displayMode: "unit" }); // '1억 2천만 345만 6천 789원'
`

$3

`javascript
toKRW(150000000, { displayMode: "decimal" }); // '1.5억원'
toKRW(25000000, { displayMode: "decimal" }); // '2.5천만원'
toKRW(15000, { displayMode: "decimal" }); // '1.5만원'
toKRW(1500, { displayMode: "decimal" }); // '1.5천원'
`

$3

`javascript
toKRW(0); // '0원'
toKRW(1); // '1원'
toKRW(-1000); // '-1,000원'
toKRW(-20000000, { displayMode: "unit" }); // '-2천만원'
toKRW(-150000000, { displayMode: "decimal" }); // '-1.5억원'
`

표시 모드 상세

$3

숫자에 콤마만 추가합니다. 가장 일반적인 형식입니다.

`javascript
toKRW(20000000); // '20,000,000원'
`

$3

한글 단위(억, 천만, 만, 천)를 사용하여 표시합니다.

`javascript
toKRW(20000000, { displayMode: "unit" }); // '2천만원'
toKRW(100000000, { displayMode: "unit" }); // '1억원'
toKRW(150000000, { displayMode: "unit" }); // '1억 5천만원'
`

$3

소수점을 사용하여 단위를 표시합니다. 소수점 첫째 자리까지만 표시됩니다.

`javascript
toKRW(150000000, { displayMode: "decimal" }); // '1.5억원'
toKRW(123456789, { displayMode: "decimal" }); // '1.2억원' (반올림)
`

개발

$3

`bash
npm run build
`

$3

`bash
npm test
`

$3

`bash
npm run test:watch
`

$3

`bash
npm run test:coverage
``

라이선스

ISC

기여

이슈와 풀 리퀘스트를 환영합니다! 프로젝트를 개선하기 위한 모든 기여에 감사드립니다.

버그 리포트

버그를 발견하셨나요? 이슈를 생성해주세요.