@hua-labs/i18n-formatters

v2.1.0

Intl

Date

Currency

Locale-aware date, number, and currency formatters with hooks and subpath exports.

$npm install @hua-labs/i18n-formatters

Package structure

Root exports

@hua-labs/i18n-formatters

Shared helpers and hooks across date, number, and currency formatting.

useDateFormatteruseNumberFormatteruseCurrencyFormatter

Date module

@hua-labs/i18n-formatters/date

Locale-aware date, date-time, and relative time formatting helpers.

formatDateformatDateTimeformatRelativeTime

Number module

@hua-labs/i18n-formatters/number

Compact number, percentage, and plain numeric formatting helpers.

formatNumberformatCompactformatPercent

Currency module

@hua-labs/i18n-formatters/currency

Currency-aware formatting with locale-sensitive symbol placement and decimals.

formatCurrencygetDefaultCurrencygetCurrencyDecimals

빠른 시작

1. Root hooks

tsx

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

function Summary() {
  const { formatCurrency } = useCurrencyFormatter();
  const { formatDate } = useDateFormatter();
  const { formatCompact } = useNumberFormatter();

  return (
    <div>
      <p>{formatCurrency(12900)}</p>
      <p>{formatDate(new Date())}</p>
      <p>{formatCompact(1250000)}</p>
    </div>
  );
}

2. Subpath imports

typescript

import { formatDateTime, formatRelativeTime } from '@hua-labs/i18n-formatters/date';
import { formatPercent } from '@hua-labs/i18n-formatters/number';
import { formatCurrency } from '@hua-labs/i18n-formatters/currency';

const createdAt = formatDateTime(new Date(), { locale: 'en-US' });
const relative = formatRelativeTime(Date.now() - 3600_000, { locale: 'ko-KR' });
const growth = formatPercent(0.128, { locale: 'en-US' });
const price = formatCurrency(19900, { locale: 'ko-KR', currency: 'KRW' });

3. Locale-aware output