packagesutilsnumberformatPhoneNumber

formatPhoneNumber

전화번호를 하이픈(-)이 포함된 형식으로 포맷팅하는 유틸리티 함수입니다.

Parameters

이름타입설명기본값
valuestring포맷팅할 전화번호-

Return

string - 포맷팅된 전화번호

Usage

import { formatPhoneNumber } from '@teamsparta/utils';
 
// 기본 사용법
formatPhoneNumber('01012345678'); // '010-1234-5678'
formatPhoneNumber('0101234567'); // '010-123-4567'
formatPhoneNumber('021234567'); // '02-123-4567'

Example

휴대폰 번호 포맷팅

function PhoneNumberInput({ value, onChange }) {
  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    const formatted = formatPhoneNumber(e.target.value);
    onChange(formatted);
  };
 
  return (
    <input
      type="tel"
      value={value}
      onChange={handleChange}
      placeholder="전화번호 입력"
    />
  );
}

전화번호 목록 포맷팅

const phoneNumbers = ['01012345678', '0212345678', '0311234567'];
const formattedNumbers = phoneNumbers.map(formatPhoneNumber);
// ['010-1234-5678', '02-1234-5678', '031-123-4567']

주의사항

  • 입력값이 없거나 빈 문자열인 경우 그대로 반환됩니다.
  • 숫자가 아닌 문자(하이픈 등)는 자동으로 제거됩니다.
  • 전화번호 길이에 따라 자동으로 적절한 포맷이 적용됩니다.
    • 11자리: 010-1234-5678 형식
    • 10자리: 02-1234-5678 형식
    • 그 외: 입력된 숫자에 따라 자동 포맷팅
randomIntisArray