Skip to content
패키지 목록

i18n 포맷터 패키지

화폐, 날짜, 숫자를 언어별로 포맷팅하는 유틸리티 패키지 모음. i18n-core와 완벽 통합.

Currency
Date
Number
Intl API

@hua-labs/i18n-currency

v1.0.0

화폐 포맷팅 및 현지화

$npm install @hua-labs/i18n-currency

제공 API

useCurrencyFormatter
hook
formatCurrency
function
getDefaultCurrency
function
getCurrencyDecimals
function

사용 예시

tsx
import { useCurrencyFormatter } from '@hua-labs/i18n-currency';

function PriceDisplay({ amount }: { amount: number }) {
  const { format } = useCurrencyFormatter();

  return <span>{format(amount)}</span>;
  // ko: ₩10,000
  // en: $10,000.00
}

@hua-labs/i18n-date

v1.0.0

날짜 포맷팅, 타임존, 상대 시간

$npm install @hua-labs/i18n-date

제공 API

useDateFormatter
hook
formatDate
function
formatDateTime
function
formatRelativeTime
function
getKoreanDate
function
convertToTimezone
function

사용 예시

tsx
import { useDateFormatter } from '@hua-labs/i18n-date';

function DateDisplay({ date }: { date: Date }) {
  const { format, formatRelative } = useDateFormatter();

  return (
    <div>
      <span>{format(date)}</span>
      {/* ko: 2026년 1월 12일 */}
      {/* en: January 12, 2026 */}

      <span>{formatRelative(date)}</span>
      {/* ko: 3일 전 */}
      {/* en: 3 days ago */}
    </div>
  );
}

@hua-labs/i18n-number

v1.0.0

숫자 포맷팅, 퍼센트, 컴팩트 표기

$npm install @hua-labs/i18n-number

제공 API

useNumberFormatter
hook
formatNumber
function
formatCompact
function
formatPercent
function

사용 예시

tsx
import { useNumberFormatter } from '@hua-labs/i18n-number';

function StatsDisplay({ value }: { value: number }) {
  const { format, formatCompact, formatPercent } = useNumberFormatter();

  return (
    <div>
      <span>{format(1234567)}</span>
      {/* ko: 1,234,567 */}

      <span>{formatCompact(1234567)}</span>
      {/* ko: 123만 */}
      {/* en: 1.2M */}

      <span>{formatPercent(0.1234)}</span>
      {/* 12.34% */}
    </div>
  );
}

공통 특징

Intl API 기반

브라우저 내장 Intl API를 사용하여 정확한 현지화 지원

i18n-core 통합

useTranslation의 currentLanguage와 자동 연동

타입 안전

완전한 TypeScript 지원, 옵션 자동완성

서버/클라이언트

SSR과 CSR 모두 지원, 유틸리티 함수는 서버에서도 사용 가능