한국 서비스 서식·검증 함수
매번 검색해서 복사하던 전화번호 하이픈, 사업자등록번호 검증 공식, 주민등록번호 읽기, 마스킹을 함수로 모았어요. 의존성이 없어 React·Vue·Svelte·Node 서버 어디서나 쓰고, 쓰는 함수만 번들에 들어가요(전체 약 2 kB).
npm install @bestow-ui/korean-utils무엇을 하려고 하나요
- 전화번호 하이픈 자동으로 넣기
010·02·031·070·1588 을 구분해 입력하는 동안 하이픈을 넣고, +82 번호도 국내 번호로 바꿔요.
- 사업자등록번호 검증 공식
사업자등록번호 10자리를 가중치 1,3,7,1,3,7,1,3,5 공식으로 확인하고 123-45-67890 형태로 나눠요.
- 금액을 한글 단위로 읽기 (12만 5,000원)
125000 을 “12만 5,000원”, 150000000 을 “1억 5,000만원” 처럼 만·억·조 단위로 바꿔요.
- 주민등록번호 생년월일·성별 읽기와 형식 확인
주민등록번호 앞 7자리로 생년월일·성별·외국인 여부를 읽고, 2020년 10월 이후 번호도 틀리지 않게 확인해요.
- 이름·전화번호·주민번호·카드번호 마스킹
홍*동, 010-****-5678, 900101-1******, 1234-****-****-3456 처럼 화면에 보여 줄 개인정보를 가려요.
- 카드번호 하이픈과 Luhn 검증
카드번호를 4-4-4-4(아메리칸 익스프레스는 4-6-5)로 나누고, Luhn 공식으로 오타를 걸러요.
- 법인등록번호 검증 공식
법인등록번호 13자리를 가중치 1,2 공식으로 확인하고 6-7 자리로 나눠요.
- 은행 코드 목록과 계좌번호 확인
국내 은행 26곳의 금융결제원 표준 코드(카카오뱅크 090, 토스뱅크 092 등)와 계좌번호 자릿수 확인.
- 한국어 날짜와 요일 표시
Date 를 “2026년 10월 15일 목요일” 로 바꾸고, 일요일부터 시작하는 요일 글자를 써요.
- 카카오 우편번호 참고항목 만들기
카카오(다음) 우편번호 서비스 결과로 도로명 주소 뒤의 “(역삼동, 래미안)” 참고항목을 만들어요.
입력 칸까지 필요하면
React 를 쓴다면 이 함수들로 만든 입력 컴포넌트가 @bestow-ui/react 에 있어요. 커서 위치·하이픈 뒤 Backspace·스크린리더 알림까지 처리했고, 접근성 검사를 통과해야 배포돼요. 한국 서비스 키트 문서 보기