useCurrencyFormatter

훅

@hua-labs/i18n-formatters

화폐 포맷팅 기능을 제공하는 훅입니다. 언어에 맞는 기본 통화와 다양한 화폐 형식을 지원합니다.

설치

Terminalbash

npm install @hua-labs/i18n-formatters

Importtsx

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

기본 사용법

tsx

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

function PriceTag() {
  const { formatCurrency, defaultCurrency } = useCurrencyFormatter();

  return (
    <div>
      <p>Price: {formatCurrency(10000)}</p>
      {/* ko: ₩10,000 | en: $10,000 */}

      <p>Default currency: {defaultCurrency}</p>
      {/* ko: KRW | en: USD */}
    </div>
  );
}

라이브 데모

defaultCurrency

현재 언어 기반 기본 통화

KRW

formatCurrency() - 기본 통화

formatCurrency(1,000)

₩1,000

formatCurrency(10,000)

₩10,000

formatCurrency(100,000)

₩100,000

formatCurrency(1,000,000)

₩1,000,000

formatCurrency() - 다양한 통화

KRW₩50,000

USDUS$50,000.00

JPYJP¥50,000

EUR€50,000.00

API 레퍼런스

반환값

이름	타입	설명
formatCurrency	(value: number, options?: CurrencyFormatterOptions) => string	docs:i18n.use-currency-formatter.returns.formatCurrency
defaultCurrency	string	docs:i18n.use-currency-formatter.options.defaultCurrency
currentLanguage	string	docs:i18n.use-currency-formatter.options.currentLanguage

코드 예시

docs:i18n.use-currency-formatter.examples.i18nexamplesmulticurrency

tsx

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

function InternationalPricing() {
  const { formatCurrency } = useCurrencyFormatter();
  const price = 50000;

  return (
    <div className="space-y-2">
      <p>KRW: {formatCurrency(price, { currency: 'KRW' })}</p>
      {/* ₩50,000 */}

      <p>USD: {formatCurrency(price / 1300, { currency: 'USD' })}</p>
      {/* $38.46 */}

      <p>JPY: {formatCurrency(price / 9, { currency: 'JPY' })}</p>
      {/* ¥5,556 */}

      <p>EUR: {formatCurrency(price / 1400, { currency: 'EUR' })}</p>
      {/* €35.71 */}
    </div>
  );
}

사용 사례

이커머스 가격

상품 가격을 통화 기호와 함께 표시

금융 대시보드

다양한 통화의 금액 표시

인보이스 생성

정확한 통화 형식의 청구서 생성

다중 통화 지원

여러 통화를 동시에 표시

useNumberFormatter createCoreI18n