한국 원화(KRW)를 위한 빠르고 간편한 숫자 포맷팅 유틸리티
npm install tokrw한국 원화(KRW)를 위한 빠르고 간편한 숫자 포맷팅 유틸리티 라이브러리입니다.
- 📦 다양한 포맷: 콤마, 한글 단위, 소수점 단위 등 3가지 표시 모드 지원
- 🔧 TypeScript 지원: 완전한 타입 정의 포함
- 📱 범용 호환: CommonJS와 ESM 모두 지원
``bash`
npm install tokrw
`bash`
yarn add tokrw
`bash`
pnpm add tokrw
`javascript`
import toKRW from "tokrw";
`javascript`
const toKRW = require("tokrw");
`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;
`
숫자를 한국 원화 형식으로 포맷팅합니다.
#### 매개변수
- value (number): 포맷팅할 숫자options
- (FormatOptions, 선택): 포맷팅 옵션displayMode
- ('comma' | 'unit' | 'decimal', 기본값: 'comma'): 표시 모드
#### 반환값
- string: 포맷팅된 문자열 (예: "20,000,000원")
`javascript`
toKRW(1000); // '1,000원'
toKRW(20000000); // '20,000,000원'
toKRW(100000000); // '100,000,000원'
toKRW(150000000); // '150,000,000원'
`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원'
`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천원'
`javascript`
toKRW(0); // '0원'
toKRW(1); // '1원'
toKRW(-1000); // '-1,000원'
toKRW(-20000000, { displayMode: "unit" }); // '-2천만원'
toKRW(-150000000, { displayMode: "decimal" }); // '-1.5억원'
숫자에 콤마만 추가합니다. 가장 일반적인 형식입니다.
`javascript`
toKRW(20000000); // '20,000,000원'
한글 단위(억, 천만, 만, 천)를 사용하여 표시합니다.
`javascript`
toKRW(20000000, { displayMode: "unit" }); // '2천만원'
toKRW(100000000, { displayMode: "unit" }); // '1억원'
toKRW(150000000, { displayMode: "unit" }); // '1억 5천만원'
소수점을 사용하여 단위를 표시합니다. 소수점 첫째 자리까지만 표시됩니다.
`javascript`
toKRW(150000000, { displayMode: "decimal" }); // '1.5억원'
toKRW(123456789, { displayMode: "decimal" }); // '1.2억원' (반올림)
`bash`
npm run build
`bash`
npm test
`bash`
npm run test:watch
`bash``
npm run test:coverage
ISC
이슈와 풀 리퀘스트를 환영합니다! 프로젝트를 개선하기 위한 모든 기여에 감사드립니다.
버그를 발견하셨나요? 이슈를 생성해주세요.