国データライブラリ徹底比較：i18n-iso-countries vs countries-and-timezones vs others

フロントエンド開発において、国名選択プルダウン、ユーザーの地域設定、ログのタイムゾーン処理などは頻出する要件です。しかし、国に関するデータは単なる名前リストではなく、ISO コード、タイムゾーン、通貨、電話コードなど多岐にわたります。今回は、代表的な 6 つのパッケージ（countries-and-timezones、countries-list、country-data、country-list、i18n-iso-countries、iso-3166-1）を比較し、それぞれの適切な使いどころを明確にします。

🌍 データの取得方法：オブジェクト参照 vs 関数呼び出し

パッケージによって、データへのアクセス方法が異なります。静的なオブジェクトをエクスポートするものと、関数を呼び出してデータを取得するものに分かれます。

countries-and-timezones は、静的なオブジェクトをエクスポートします。

• countries オブジェクトから直接データにアクセスできます。
• タイムゾーン情報が国コードに紐付いて管理されています。

// countries-and-timezones
import cctz from 'countries-and-timezones';

const country = cctz.countries['JP'];
console.log(country.name); // "Japan"
console.log(country.timezones); // ["Asia/Tokyo"]

countries-list も同様に静的なオブジェクトを提供します。

• 国コードをキーとしたシンプルな構造です。
• 名前、通貨、言語などの基本情報を含みます。

// countries-list
import { countries } from 'countries-list';

const country = countries['JP'];
console.log(country.name); // "Japan"
console.log(country.currency); // "JPY"

country-data は、配列形式でデータをエクスポートします。

• all 配列からフィルタリングして使用するスタイルです。
• 電話コードや通貨記号など、詳細なメタデータが含まれます。

// country-data
import data from 'country-data';

const japan = data.countries.all.find(c => c.alpha2 === 'JP');
console.log(japan.name); // "Japan"
console.log(japan.countryCallingCodes); // ["+81"]

country-list は、変換関数を提供するスタイルです。

• getCode や getName といった関数を使って変換します。
• リストそのものよりも、変換ロジックに重点を置いています。

// country-list
import { getCode, getName } from 'country-list';

const code = getCode('Japan'); // "JP"
const name = getName('JP'); // "Japan"

i18n-iso-countries は、言語を指定して名前を取得する関数を提供します。

• 多言語対応がコア機能です。
• registerLocale 言語パックを登録してから使用します。

// i18n-iso-countries
import countries from 'i18n-iso-countries';
import ja from 'i18n-iso-countries/langs/ja.json';

countries.registerLocale(ja);
console.log(countries.getName('JP', 'ja')); // "日本"

iso-3166-1 は、リストと検索関数の両方を提供します。

• 公式の ISO 標準データに準拠しています。
• alpha2、alpha3、numeric コードのすべてを扱えます。

// iso-3166-1
import { alpha2, alpha3 } from 'iso-3166-1';

const country = alpha2.get('JP');
console.log(country.name); // "Japan"
console.log(country.alpha3); // "JPN"

🗣️ 多言語対応（i18n）：ネイティブ対応 vs 追加設定

グローバルなアプリケーションでは、国名をユーザーの言語で表示する必要があります。この対応状況はパッケージ間で大きな差があります。

i18n-iso-countries は、多言語対応に最も優れています。

• 60 以上の言語パックが用意されています。
• 言語を切り替えるだけで、国名が自動的に変更されます。

// i18n-iso-countries
import en from 'i18n-iso-countries/langs/en.json';
import fr from 'i18n-iso-countries/langs/fr.json';

countries.registerLocale(en);
countries.registerLocale(fr);

console.log(countries.getName('DE', 'en')); // "Germany"
console.log(countries.getName('DE', 'fr')); // "Allemagne"

countries-and-timezones は、英語名が基本です。

• 多言語パックは公式には提供されていません。
• 自分で翻訳データを管理する必要があるため、国際化プロジェクトには追加コストがかかります。

// countries-and-timezones
const country = cctz.countries['DE'];
console.log(country.name); // "Germany" (英語のみ)
// 他言語にするには独自の実装が必要

countries-list は、英語名が基本です。

• 一部のメタデータ（通貨など）はコードですが、国名は英語固定です。
• 多言語対応が必要な場合は、別の i18n ライブラリと組み合わせる必要があります。

// countries-list
const country = countries['DE'];
console.log(country.name); // "Germany" (英語のみ)

country-data は、英語名が基本です。

• 豊富なメタデータがありますが、国名の多言語化には対応していません。
• 電話コードや通貨など、言語に依存しないデータを使うのに適しています。

// country-data
const country = data.countries.all.find(c => c.alpha2 === 'DE');
console.log(country.name); // "Germany" (英語のみ)

country-list は、英語名が基本です。

• 変換関数も英語名を前提としています。
• 単一言語の国内向けアプリケーションであれば問題ありません。

// country-list
console.log(getName('DE')); // "Germany" (英語のみ)

iso-3166-1 は、英語名が基本です。

• 規格定義そのものが英語ベースです。
• 多言語対応は目的外であり、コード管理に特化しています。

// iso-3166-1
const country = alpha2.get('DE');
console.log(country.name); // "Germany" (英語のみ)

🕒 タイムゾーンと地理データ：特化型 vs 汎用型

国データと共にタイムゾーンを扱いたい場合、パッケージの選択がアーキテクチャに大きく影響します。

countries-and-timezones は、この分野で最も強力です。

• 国コードからタイムゾーン一覧が即座に取得できます。
• 都市名とタイムゾーンの紐付けも含まれています。

// countries-and-timezones
const tz = cctz.countries['US'].timezones;
console.log(tz); // ["America/New_York", "America/Chicago", ...]

const city = cctz.getCityByTimezone('Asia/Tokyo');
console.log(city); // { name: "Tokyo", country: "JP" }

countries-list は、タイムゾーンデータを含みません。

• 国名、通貨、言語などの基本情報のみです。
• タイムゾーンが必要な場合は、luxon や date-fns-tz など別のライブラリと組み合わせる必要があります。

// countries-list
const country = countries['US'];
console.log(country.timezones); // undefined (存在しない)

country-data は、タイムゾーンデータを含みません。

• 電話コードや通貨記号など、通信や決済に関するデータに強みがあります。
• 地理位置情報よりも、ビジネスロジック向けのメタデータが充実しています。

// country-data
const country = data.countries.all.find(c => c.alpha2 === 'US');
console.log(country.timezones); // undefined (存在しない)

country-list は、タイムゾーンデータを含みません。

• コードと名前の相互変換に特化しています。
• 地理的な拡張データは期待できません。

// country-list
// タイムゾーン関連のメソッドは存在しません

i18n-iso-countries は、タイムゾーンデータを含みません。

• 国名の多言語化に専念しています。
• 時間処理は、別のライブラリに任せる設計思想です。

// i18n-iso-countries
// タイムゾーン関連のメソッドは存在しません

iso-3166-1 は、タイムゾーンデータを含みません。

• ISO 規格のコード定義のみを扱います。
• 実運用データというよりは、データ検証の基準として使われます。

// iso-3166-1
// タイムゾーン関連のメソッドは存在しません

⚠️ 保守状況と非推奨パッケージ

オープンソースパッケージを選ぶ際、メンテナンス状況は重要な判断基準です。一部のパッケージは更新が止まっているか、非推奨のアナウンスがあります。

country-data は、メンテナンスが停滞しています。

• 最終更新から時間が経過しており、新しい国名変更やコード追加に対応できていない可能性があります。
• 新規プロジェクトでの使用は避け、i18n-iso-countries などの活発なパッケージへの移行を推奨します。

// country-data (非推奨のリスクあり)
// 新規プロジェクトでは使用を避けるべきです
import data from 'country-data'; 

countries-list と country-list は、シンプルなため更新頻度は低めです。

• 機能追加は少ないですが、既存機能は安定しています。
• 大規模な変更がない限り、引き続き使用可能です。

// countries-list / country-list
// 安定したシンプルなライブラリとして利用可能
import { countries } from 'countries-list';

i18n-iso-countries と countries-and-timezones は、活発にメンテナンスされています。

• 定期的な更新があり、新しい言語パックやデータ修正が反映されます。
• 長期的なプロジェクトで安心して採用できます。

// i18n-iso-countries / countries-and-timezones
// 積極的にメンテナンスされているため推奨
import countries from 'i18n-iso-countries';

iso-3166-1 は、規格変更がない限り更新は少ないです。

• 標準規格自体が安定しているため、頻繁な更新は不要です。
• 特殊な要件がない限り、他のパッケージで代用可能です。

// iso-3166-1
// 規格準拠が必要な特殊ケースで使用
import { alpha2 } from 'iso-3166-1';

🧩 実装パターン：フォームとバリデーション

実際のユースケースとして、国選択フォームと電話番号バリデーションを実装する場合の違いを見てみましょう。

i18n-iso-countries を使った多言語フォームの場合：

• ユーザーの言語設定に合わせて国名リストを動的に生成します。

// i18n-iso-countries
const getCountryOptions = (lang) => {
  return countries.getNames(lang).map(code => ({
    value: code,
    label: countries.getName(code, lang)
  }));
};

// 使用例：日本語
const jaOptions = getCountryOptions('ja');

countries-and-timezones を使ったタイムゾーン連動フォームの場合：

• 国を選択すると、対応するタイムゾーンが自動表示されます。

// countries-and-timezones
const getTimezonesForCountry = (code) => {
  return cctz.countries[code].timezones;
};

// 使用例：アメリカのタイムゾーン
const usTimezones = getTimezonesForCountry('US');

country-data を使った電話番号バリデーションの場合：

• 国コードに基づいて、正しい電話番号フォーマットを検証します。
• （※前述の通り、保守状況に注意が必要です）

// country-data
const getPhoneCode = (alpha2) => {
  const country = data.countries.all.find(c => c.alpha2 === alpha2);
  return country ? country.countryCallingCodes[0] : null;
};

// 使用例：日本の国番號
const jpCode = getPhoneCode('JP'); // "+81"

countries-list / country-list / iso-3166-1 の場合：

• 基本的な国名とコードの表示に使用します。
• 追加機能が必要な場合は、他のライブラリと組み合わせます。

// countries-list
const getCountryName = (code) => countries[code]?.name || '';

// country-list
const name = getName('JP');

// iso-3166-1
const country = alpha2.get('JP');
const name = country ? country.name : '';

📊 選定ガイド：ユースケース別ベストプラクティス

💡 結論：アーキテクチャに合わせた選択を

国データライブラリの選択は、単に「国名が欲しい」だけでなく、プロジェクトの国際化戦略やデータ要件に依存します。

i18n-iso-countries は、現代の Web アプリケーションにおいて最もバランスの取れた選択肢です。多言語対応が標準となりつつある現在、このパッケージの柔軟性は大きなメリットになります。保守状況も良好で、長期的な視点でも安心できます。

countries-and-timezones は、タイムゾーン処理が重要なアプリケーション（スケジューラー、ログ分析、グローバルチームツールなど）で真価を発揮します。国コードからタイムゾーンを即座に解決できるため、実装コストを大幅に削減できます。

country-data は豊富なメタデータを持っていますが、メンテナンスの停滞が懸念されます。電話コードや通貨データがどうしても必要な場合は、公式の API や他の信頼できるデータソースとの併用を検討すべきです。

countries-list、country-list、iso-3166-1 は、特定のシンプルな要件や、規格準拠が求められる特殊なケースで有効です。しかし、汎用的なアプリケーションでは、より機能豊富なパッケージを選ぶ方が、将来的な拡張性を確保できます。

最終的には、プロジェクトの「国際化の必要性」と「必要なメタデータの範囲」を明確に定義した上で、適切なパッケージを選定することが重要です。