@gitsunmin/k-number

k-number

숫자를 입력하면 한글 수사로 반환하는 기능을 제공하는 라이브러리입니다. 예를들면, 10000을 입력하면 만으로 반환합니다.

Install

npm install @gitsunmin/k-number

Usage

import { kNumber } from '@gitsunmin/k-number';

const result = kNumber(39_393_382);
console.log('result:', result);
// result: 삼천구백삼십구만삼천삼백팔십이

const unitOnlyResult = kNumber(39_393_382, { format: 'unit-only' });
console.log('unitOnlyResult:', unitOnlyResult);
// unitOnlyResult: 3천9백3십9만3천3백8십2

• ⚠️ 소수점 입력을 지원하지 않습니다. [integer only]
• ⚠️ 최대값 9_007_199_254_740_991까지만 입력이 가능합니다.
• ⚠️ 최소값 -9_007_199_254_740_991까지만 입력이 가능합니다.

KNumber

input

• Number
  • type: number (integer only)
  • example:

    kNumber(123_123)

• Config
  • type: KNumberConfig

    {
      format?: 'korean-only' | 'unit-only';
    }

  • example:

    kNumber(123_123, { format: 'unit-only' })

output

• type: string
• example:

  const koreanNumber = kNumber(123_123, { format: 'unit-only' });
  console.log(koreanNumber); // 1십2만3천1백2십3

Types & Constants

• type.ts
• constants.ts
• errors.ts

License

MIT