複数形・日付・数値を扱う

値・単位・タイムゾーンはアプリケーションで管理し、文法や書式はロケールに合わせて選びます。

項目数を表す際には、アプリケーションがどの数値を意図しているかと、読み手の言語でその数量をどう表すかという、二つの判断が必要です。日付や金額も同じように分けて考えます。描画するまでは値を構造化したまま保持し、文法・区切り文字・通貨・タイムゾーンを意図に沿って選べるようにしましょう。

以下の例では@lingo.dev/reactを使います。各プラットフォーム固有のリソースシステムには、それぞれ独自のメッセージ構文と生成ツールがあります。ICUに似た記法を使っていても、すべてのランタイムを相互に置き換えられるわけではありません。

フォーマッターにはメッセージ全体を渡す #

LingoProvider配下のコンポーネント内で、件数を数値として複数形メッセージに渡します。

tsx
const l = useLingo();

const label = l.plural(
  count,
  { one: "# item", other: "# items" },
  { context: "Number of items in the shopping cart" },
);

@lingo.dev/reactからuseLingoをインポートします。countはアプリケーションが持つ数値です。ランタイムはICUメッセージを組み立て、現在のロケールに合わせてカタログ内の翻訳を書式設定します。oneとotherは文法上のカテゴリーです。書式設定済みの数値の後ろに翻訳した名詞をつなげるだけでは、カテゴリーの選択も語順の変更もできなくなります。

pluralヘルパーは、名前付きのCLDRカテゴリーを組み立てます。=0のように特定の数値に一致する分岐は含まれません。ゼロ件の場合に製品独自のメッセージを表示するには、テキスト用の処理経路でICU式を明示的に指定します。

ts
l.text("{count, plural, =0 {No items} one {# item} other {# items}}", {
  context: "Cart count with a distinct empty state",
  values: { count },
});

翻訳先の言語によっては、英語より多くのカテゴリーが必要です。すべての言語を原文の分岐に無理に当てはめず、翻訳されたメッセージを確認し、そのロケールで選ばれる形式を実際に試してください。対応する形式と抽出時の動作については、複数形と選択分岐を参照してください。

意味に応じて表現を切り替える場合は、固定の選択値を使います。

ts
l.select(role, {
  admin: "Manage team settings",
  member: "View team settings",
  other: "View settings",
}, { context: "Settings action for the user's team role" });

アプリケーションからroleを渡します。admin、member、必須のフォールバックであるotherはそのまま保持し、各分岐のメッセージを翻訳します。未知の値にはotherが使われます。

序数が表す位置と基数が表す数量を区別する #

序数は位置を表します。次のようなメッセージには、テキスト用の処理経路で、複雑なICU式に対応したフォーマッターを使います。

ts
l.text("You finished {position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}", {
  context: "Participant's finishing position in a competition",
  values: { position },
});

これらの接尾辞は英語の原文に固有のもので、すべての言語に共通する規則ではありません。翻訳では、その言語に合った方法で位置を表す必要があります。valuesを渡すと、テキスト用の処理経路で書式設定が有効になります。生成された宣言は、呼び出しが仕様に適合しているかを確認しますが、入れ子になったICUの分岐をすべて検証するわけではありません。

通貨とパーセントの単位を明示する #

金額の数値と、対応する通貨コードを使います。

ts
const price = l.currency(1234.5, "EUR");
const discount = l.percent(0.15);

最初の呼び出しはユーロの金額を書式設定するもので、別の通貨からユーロに換算するものではありません。二つ目は、入力値が割合を表す小数なので、十五パーセントを表します。15を渡すと、別の数量を意味します。これらの書式設定済み文字列を文に挿入するときは、新しい原文文字列を組み立てず、名前付きのvaluesを通して渡してください。

書式設定ヘルパーは、数値・単位・リストなど、Intlを利用する値にも対応しています。各ヘルパーの既定値と対応オプションを確認してください。ロケールに合わせて書式設定しても、独自の単位ラベルがすべて翻訳されるわけではありません。また、無効なオプションを指定するとエラーになることがあります。

日付の意味と表示用タイムゾーンを選ぶ #

タイムスタンプは特定の瞬間を表します。一方、暦上の日付は、タイムゾーンを伴わない一日を表すことがあります。製品上の意味に合わない限り、日付だけで示された期限を、午前零時という特定の瞬間に変換しないでください。

特定の瞬間を表示する場合は、意図した表示用タイムゾーンを指定します。

ts
const instant = new Date("2026-01-02T00:30:00Z");

const date = l.date(instant, { timeZone: "UTC" });
const time = l.time(instant, { timeZone: "UTC" });

これらのヘルパーは、表示形式には現在のロケールを、表示用タイムゾーンにはUTCを使います。基盤となる標準APIを直接使うこともできます。

ts
new Intl.NumberFormat("de-DE", {
  style: "currency", currency: "EUR",
}).format(1234.5);

new Intl.DateTimeFormat("en-US", {
  dateStyle: "medium", timeZone: "UTC",
}).format(new Date("2026-01-02T00:30:00Z"));

リッチメッセージでは対応する文法の範囲を守る #

l.richは、名前付きタグをReactコンポーネントに対応付け、単純なプレースホルダーに値を埋め込みます。l.textの複雑なICU式に対応したフォーマッターは使いません。「{region}の<link>配送ポリシー</link>をお読みください」のような文は、コードからリンクの描画処理と地域の値を渡せば、この処理経路で扱えます。その中に複数形や序数を追加しても、ICUが使えるようにはなりません。

操作の定義はコード内に保持し、リッチな構造と文法を組み合わせる場合は、対応範囲に収まるメッセージ設計を選んでください。未知のタグはそのまま文字列として残ります。また、同名のタグを入れ子にした場合、開始タグと終了タグの対応付けには制限があります。操作可能なリッチメッセージを参照してください。

意味が変わるケースを確認する #

件数が0、1、2、それより大きい数になる場合を試し、製品で小数を許容する場合は小数も確認してください。英語の序数には、1、2、3、11、12、13、21を含めます。翻訳先では、各ロケールに合った表現を期待値にしてください。未知の選択値、意味のある場合は負の金額、さらに午前零時に近い同じ瞬間を二つのタイムゾーンで表示した場合もテストしてください。

これらの確認では、実際の翻訳先カタログを読み込んでください。翻訳が存在しない場合や空の場合は原文にフォールバックすることがあるため、出力がもっともらしく見えるだけでは、翻訳先をカバーできているとは判断できません。描画された値を、意図した数量・日付・メッセージと照合したうえで、言語表現そのものをレビューしてください。