日付と数値の書式
複数形や日付、数値の書式にはIntlをそのまま使います。ロケールの集合が、今のロケールに合わせたIntlのオブジェクトを返します。
このページの内容
Intlを返すメンバー
src/components/price.tsximport { 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.DateTimeFormatnumberFormat(options?):Intl.NumberFormatrelativeTimeFormat(options?):Intl.RelativeTimeFormatpluralRules(options?):Intl.PluralRuleslistFormat(options?):Intl.ListFormat
Intlのオブジェクトをそのまま返すので、formatやformatToParts、formatRangeも使えます。オプションもIntlのものを渡します。
ここに無いIntl.CollatorやIntl.DisplayNamesは、locales.getLocale()のタグを渡して自分で作ります。
日付
src/components/published-at.tsximport { 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を直接使い、ブラウザだけで描画する部分に置きます。
タイムゾーンのデモ
同じ瞬間(協定世界時の2026年3月5日15時30分)を、ロケールのtimeZoneとブラウザのタイムゾーンで表示して比べます。
locales.dateTimeFormat(…)- 2026年3月6日 0:30Asia/Tokyo
new Intl.DateTimeFormat(locales.getLocale(), …)- ブラウザで描画したあとに表示します
試してみる
- 上の行は、このページのロケールの
timeZoneで表示します。このサイトのlocalesは、jaをAsia/Tokyo、enをUTCで定義しています。日本語のページは3月6日、英語のページは3月5日になります。 - 下の行は、ブラウザで描画したあとに、このブラウザのタイムゾーンで表示します。ページのタイムゾーンと違えば、時刻や日付が上の行と食い違います。
- ヘッダーの言語の切り替えで別の言語を選ぶと、上の行のタイムゾーンと日付が変わります。下の行のタイムゾーンは変わりません。
文言の中の複数形と日付
src/messages/cart.tsimport { 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つ作られますが、結果は変わりません。