@k8ordo/i18n

日付と数値の書式

複数形や日付、数値の書式にはIntlをそのまま使います。ロケールの集合が、今のロケールに合わせたIntlのオブジェクトを返します。

このページの内容

Intlを返すメンバー

src/components/price.tsx
import { locales } from '../i18n';

export function Price({ amount }: { amount: number }) {
  const yen = locales.numberFormat({
今のロケールの`Intl.NumberFormat`
    style: 'currency',
    currency: 'JPY',
  });
  return <span>{yen.format(amount)}</span>;
}

そのメンバーは次の5つです。どれもフックではないので、Server ComponentでもClient Componentでも呼べます。

  • dateTimeFormat(options?):Intl.DateTimeFormat
  • numberFormat(options?):Intl.NumberFormat
  • relativeTimeFormat(options?):Intl.RelativeTimeFormat
  • pluralRules(options?):Intl.PluralRules
  • listFormat(options?):Intl.ListFormat

Intlのオブジェクトをそのまま返すので、formatやformatToParts、formatRangeも使えます。オプションもIntlのものを渡します。

ここに無いIntl.CollatorやIntl.DisplayNamesは、locales.getLocale()のタグを渡して自分で作ります。

日付

src/components/published-at.tsx
import { locales } from '../i18n';

export function PublishedAt({ date }: { date: Date }) {
  return (
    <time dateTime={date.toISOString()}>
      {locales.dateTimeFormat({ dateStyle: 'medium' }).format(date)}
ロケールの`timeZone`で表示する
    </time>
  );
}

dateTimeFormatは、ロケールに定義したtimeZoneで日付を表示します。実行環境のタイムゾーンは使いません。サーバーのHTMLとブラウザでの描画で、日付をそろえるためです。ロケールごとのタイムゾーンの決め方は、ロケールのページの「タイムゾーン」を見てください。

オプションの型はtimeZoneを受け付けません。asで型を通しても、ロケールのtimeZoneで上書きされます。

情報

メモ

訪問者のタイムゾーンでの時刻や、今からの相対時間は、サーバーとブラウザで表示が食い違うことがあります。こうした表示はIntlを直接使い、ブラウザだけで描画する部分に置きます。

Playground

タイムゾーンのデモ

同じ瞬間(協定世界時の2026年3月5日15時30分)を、ロケールのtimeZoneとブラウザのタイムゾーンで表示して比べます。

locales.dateTimeFormat(…)
2026年3月6日 0:30Asia/Tokyo
new Intl.DateTimeFormat(locales.getLocale(), …)
ブラウザで描画したあとに表示します

試してみる

  1. 上の行は、このページのロケールのtimeZoneで表示します。このサイトのlocalesは、jaをAsia/Tokyo、enをUTCで定義しています。日本語のページは3月6日、英語のページは3月5日になります。
  2. 下の行は、ブラウザで描画したあとに、このブラウザのタイムゾーンで表示します。ページのタイムゾーンと違えば、時刻や日付が上の行と食い違います。
  3. ヘッダーの言語の切り替えで別の言語を選ぶと、上の行のタイムゾーンと日付が変わります。下の行のタイムゾーンは変わりません。

文言の中の複数形と日付

src/messages/cart.ts
import { message } from '@k8ordo/i18n';

import { locales } from '../i18n';

const long = () => locales.dateTimeFormat({ dateStyle: 'long' });

export const items = message({
  ja: (count: number) => `${String(count)}件`,
  en: (count) =>
    locales.pluralRules().select(count) === 'one'
英語の複数形を`Intl.PluralRules`で選ぶ
      ? `${String(count)} item`
      : `${String(count)} items`,
});

export const updated = message({
  ja: (date: Date) => `${long().format(date)}に更新`,
  en: (date) => `Updated ${long().format(date)}`,
});

値を差し込む文言の関数の中で呼ぶと、複数形や日付も文言の一部にできます。関数は自分のロケールを今のロケールにした状態で呼ばれるので、Intlもそのロケールのものになります。

英語のpluralRules().select(1)はoneを返します。日本語では数にかかわらずotherを返すので、日本語の文は1つで済みます。

オブジェクトの再利用

Intlのオブジェクトは、ロケールとオプションの組ごとに1つだけ作られ、2回目からは同じものを返します。描画のたびに呼んでかまいません。

オプションはJSONの文字列にして、キャッシュのキーにします。同じオプションを違う順に書くと2つ作られますが、結果は変わりません。

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。