Skip to main content

formatValueWithSymbol

주어진 숫자 또는 문자열에 주어진 기호를 추가하는 함수입니다.

  • 기호는 prefix 또는 suffix 위치에 추가할 수 있습니다.
  • 음수 값의 경우 기호 앞에 -가 추가됩니다.
  • 기호와 값 사이에 공백을 추가할 수 있습니다.

Code​

🔗 실제 구현 코드 확인

Interface​

typescript
interface FormatValueWithSymbolOptions {
  symbol?: string;
  position?: 'prefix' | 'suffix';
  space?: boolean;
}
typescript
function formatValueWithSymbol(
  value: number | string,
  options?: FormatValueWithSymbolOptions
): string;

Usage​

typescript
import { formatValueWithSymbol } from '@modern-kit/utils';

// 통화 기호 추가 (기본 값: '')
formatValueWithSymbol(1000) // '1000'
formatValueWithSymbol(1000, { symbol: '원' }) // '1000원'

// 통호 기호 위치 변경 (기본값: 'suffix')
formatValueWithSymbol(1000, { symbol: '$', position: 'prefix' }) // '$1000'
formatValueWithSymbol(1000, { symbol: '원', position: 'suffix' }) // '1000원'

// 공백 추가 (기본값: false)
formatValueWithSymbol(1000, { symbol: '$', position: 'prefix', space: false }) // '$1000'
formatValueWithSymbol(1000, { symbol: '$', position: 'prefix', space: true }) // '$ 1000'

응용​

typescript
import { 
  formatValueWithSymbol, 
  formatNumberWithCommas, 
  formatNumberWithUnits 
} from '@modern-kit/utils';

const KRW_UNITS = [
  { unit: '조', value: 1_000_000_000_000 },
  { unit: '억', value: 100_000_000 },
  { unit: '만', value: 10_000 },
] as const;

const numberWithCommas = formatNumberWithCommas(1234567); // 1,234,567
const numberWithKRWUnits = formatNumberWithUnits(1230000, { units: KRW_UNITS }); // 123만

formatValueWithSymbol(numberWithKRWUnits, { symbol: '원' }) // '123만원'
formatValueWithSymbol(numberWithCommas, { symbol: '원' }) // '1,234,567원'