kr-format

한국 개발자를 위한 필수 포맷팅 유틸리티

간단하고 직관적인 API로 한국에서 자주 사용하는 데이터 형식을 쉽게 포맷팅하고 마스킹할 수 있습니다.

설치

npm install kr-format

사용법

import { pad, mask, format } from 'kr-format';
// 또는
const { pad, mask, format } = require('kr-format');

API

📱 pad - 데이터 포맷팅

pad.phone(phone)

전화번호를 하이픈으로 구분된 형식으로 변환합니다.

pad.phone('01012345678')    // '010-1234-5678'
pad.phone('0212345678')     // '02-1234-5678'
pad.phone('0311234567')     // '031-123-4567'

pad.business(business)

사업자등록번호를 표준 형식으로 변환합니다.

pad.business('1234567890')  // '123-45-67890'

pad.card(card)

카드번호를 4자리씩 구분합니다.

pad.card('1234567890123456')  // '1234-5678-9012-3456'

🔒 mask - 민감정보 마스킹

mask.rrn(rrn, visibleDigits?)

주민등록번호를 마스킹 처리합니다.

mask.rrn('9001011234567')     // '900101-*******'
mask.rrn('900101-1234567', 1) // '900101-******7'

mask.phone(phone, maskLength?)

전화번호 중간 자리를 마스킹합니다.

mask.phone('01012345678')  // '010-****-5678'

mask.email(email)

이메일 주소를 마스킹합니다.

mask.email('[email protected]')  // 'te**@example.com'

💰 format - 숫자 및 날짜 포맷팅

format.currency(amount, withUnit?)

숫자를 한국 통화 형식으로 변환합니다.

format.currency(1234567)        // '1,234,567원'
format.currency(1234567, false) // '1,234,567'
format.currency(-500000)        // '-500,000원'

format.number(number)

숫자를 천 단위 쉼표로 구분합니다.

format.number(1234567)  // '1,234,567'

format.date(date, separator?)

날짜를 한국 형식으로 변환합니다.

format.date('2024-01-15')       // '2024.01.15'
format.date('2024-01-15', '-')  // '2024-01-15'
format.date('2024-01-15', '/')  // '2024/01/15'

format.fileSize(bytes)

파일 크기를 읽기 쉬운 형식으로 변환합니다.

format.fileSize(1024)       // '1.0KB'
format.fileSize(1048576)    // '1.0MB'
format.fileSize(1073741824) // '1.0GB'

TypeScript 지원

이 패키지는 TypeScript 타입 정의를 포함하고 있습니다.

import { pad, mask, format } from 'kr-format';

const phoneNumber: string = pad.phone('01012345678');
const maskedEmail: string = mask.email('[email protected]');
const price: string = format.currency(10000);

실사용 예제

고객 정보 표시

const customer = {
  name: '홍길동',
  phone: '01012345678',
  rrn: '9001011234567',
  email: '[email protected]'
};

console.log(`
이름: ${customer.name}
전화: ${pad.phone(customer.phone)}
주민번호: ${mask.rrn(customer.rrn)}
이메일: ${mask.email(customer.email)}
`);

// 출력:
// 이름: 홍길동
// 전화: 010-1234-5678
// 주민번호: 900101-*******
// 이메일: hon*@example.com

주문 정보 포맷팅

const order = {
  orderNo: '20240115001',
  amount: 125000,
  date: '2024-01-15',
  card: '1234567890123456'
};

console.log(`
주문번호: ${order.orderNo}
금액: ${format.currency(order.amount)}
날짜: ${format.date(order.date)}
카드: ${mask.card(order.card)}
`);

테스트

npm test

라이선스

MIT

기여

이슈와 PR은 언제나 환영합니다!

left-pad처럼 간단하고 필수적인 유틸리티

이 패키지는 한국 개발자들이 매일 반복적으로 작성하는 코드를 간단한 함수로 제공합니다. 복잡한 정규식이나 로직 없이 단 한 줄로 한국 특화 데이터를 포맷팅하세요!

Project tango down by Devguru-J