countries-and-timezones vs countries-list vs country-data vs world-countries
フロントエンドにおける国・地域データとタイムゾーン管理の最適化
パッケージを検索...
countries-and-timezonescountries-listcountry-dataworld-countries類似パッケージ:

フロントエンドにおける国・地域データとタイムゾーン管理の最適化

countries-and-timezones、countries-list、country-data、world-countries は、いずれもアプリケーションで国名、通貨、タイムゾーン、電話番号などの地理情報を扱うための npm パッケージです。これらは、静的なデータセットを提供することで、外部 API に依存せずにフォームのドロップダウンリストやユーザープロファイルの表示を実装できるようにします。ただし、データの鮮度、メンテナンス状況、そして提供する情報の詳細さには大きな違いがあります。

npmのダウンロードトレンド

3 年

GitHub Starsランキング

統計詳細

パッケージ
ダウンロード数
Stars
サイズ
Issues
公開日時
ライセンス
countries-and-timezones0272316 kB151年前MIT
countries-list01,308274 kB91ヶ月前MIT
country-data0518-359年前MIT
world-countries06,19220.6 MB131年前-

国・地域データライブラリ徹底比較：countries-and-timezones vs countries-list vs country-data vs world-countries

フロントエンド開発において、ユーザーの国籍選択、タイムゾーン設定、通貨表示などは頻繁に発生する要件です。外部 API を毎回叩くのはパフォーマンスの無駄であり、ローカルで完結する静的データパッケージの利用が一般的です。しかし、npm には類似パッケージが溢れており、どれを選ぶべきか迷うことが多いでしょう。

ここでは、countries-and-timezones、countries-list、country-data、world-countries の 4 つを取り上げ、実務的な観点から技術的な違いを明確にします。

📦 データの構造と取得方法

パッケージごとにデータの持ち方が異なります。これは、コンポーネント内でデータをどう展開するかに直接影響します。

countries-and-timezones 国とタイムゾーンが統合されたオブジェクトを提供します。国コードをキーに、関連するタイムゾーン配列を直接取得できます。

import c from 'countries-and-timezones';

// 国コードからタイムゾーンを取得
const timezones = c.getTimezonesForCountry('JP');
// 出力: ['Asia/Tokyo']

// 全ての国リストを取得
const countries = c.getCountries();

countries-list シンプルな配列またはオブジェクトで国情報を返します。構造は平坦で、タイムゾーン情報は含まれていないことがほとんどです。

import { countries } from 'countries-list';

// 国リストをイテレート
Object.values(countries).forEach(country => {
  console.log(country.name, country.iso2);
});

country-data 階層的なデータ構造を持ち、通貨や電話番号など詳細な情報を含みます。ただし、データの取得には特定のメソッドチェーンが必要です。

import countries from 'country-data';

// 国コードで検索
countries.countries['JP'].name;

// 通貨情報を取得
countries.countries['JP'].currencies;

world-countries JSON データセットをそのままエクスポートする形式が多く、それをインポートして使用します。ラッパー関数よりもデータそのものを扱う感覚に近いです。

import countries from 'world-countries';

// 配列として直接アクセス
const japan = countries.find(c => c.cca2 === 'JP');
console.log(japan.name.common);

🕒 タイムゾーン情報の統合度

グローバルアプリケーションでは、国選択後に適切なタイムゾーンを表示する必要があります。ここで各パッケージの差が顕著になります。

countries-and-timezones 名前の通り、この機能がコアです。国コードからタイムゾーンへのマッピングが最初から用意されています。

import c from 'countries-and-timezones';

const tzList = c.getTimezonesForCountry('US');
// ['America/New_York', 'America/Chicago', ...]

countries-list タイムゾーンデータは含まれていません。別途 moment-timezone などのライブラリと組み合わせる必要があり、実装コストが増加します。

import { countries } from 'countries-list';
// タイムゾーン取得機能は存在しない
// 別途実装が必要：const tz = moment.tz.guess();

country-data 国データにタイムゾーンが含まれている場合がありますが、配列形式での取得が面倒な場合があります。データ構造が古く、最新の IANA タイムゾーンデータベースと一致しないリスクがあります。

import countries from 'country-data';
// 直接タイムゾーン配列を取得する標準メソッドは乏しい
// 生データから抽出する必要がある場合が多い

world-countries 地理情報に焦点を当てており、タイムゾーン情報は含まれていないか、限定的です。地理座標（緯度・経度）などのデータは豊富ですが、タイムゾーン管理には向きません。

import countries from 'world-countries';
// 地理データは豊富だが、タイムゾーンリストは提供されない
const coords = countries.find(c => c.cca2 === 'JP').latlng;

🛠️ メンテナンス状況と信頼性

オープンソースパッケージを選ぶ際、メンテナンスされているかはバグ修正やデータ更新の観点で最重要です。

countries-and-timezones 定期的に更新されており、新しい国名の変更やタイムゾーンの修正に対応しています。TypeScript の型定義もパッケージに含まれているか、別途充実しており、開発体験が良いです。

// TypeScript で型推論が効く
import c from 'countries-and-timezones';
const name: string = c.getCountry('JP').name; // ✅ 型安全

countries-list 更新頻度は低く、機能追加もほとんどありません。シンプルであることは利点ですが、国際情勢の変化（国名の正式名称変更など）への追従が遅れる可能性があります。

// 更新が止まっていると、新しい国コードに対応できない
// 例：国名変更などが反映されないリスク

country-data ⚠️ 非推奨のリスク大。多くのレポジトリで更新が止まっており、npm 上でも非推奨（deprecated）として警告される場合があります。新しいプロジェクトで採用すると、将来的な技術的負債になります。

// 警告：メンテナンスされていない可能性が高い
// 依存関係に問題が生じた場合、修正が困難

world-countries コミュニティによって維持されている側面がありますが、更新のタイミングは一定ではありません。データソースが明確な場合（例えば UN や ISO 基準）は信頼できますが、パッケージごとの差異を確認する必要があります。

// データソースの確認が必要
// ISO 3166 基準などに準拠しているか README を確認

🌐 実装シナリオ別推奨

実際の開発現場では、要件に応じて使い分けます。

シナリオ 1：ユーザー登録フォーム（国＋タイムゾーン）

ユーザーに国とタイムゾーンを選ばせる場合、2 つのパッケージを組み合わせるのは非効率です。

  • ✅ 推奨: countries-and-timezones
  • 理由：1 つのパッケージで両方のデータが揃うため、状態管理がシンプルになります。
import c from 'countries-and-timezones';

function RegistrationForm() {
  const countries = c.getCountries();
  // 国選択時にタイムゾーンも即座に取得可能
}

シナリオ 2：シンプルな国名ドロップダウン

タイムゾーン不要で、とにかく軽量な国名リストだけが欲しい場合です。

  • ✅ 推奨: countries-list
  • 理由：余計なデータが含まれておらず、バンドルサイズを抑制できます（概念上）。
import { countries } from 'countries-list';

function CountrySelect() {
  return Object.values(countries).map(c => (
    <option value={c.iso2}>{c.name}</option>
  ));
}

シナリオ 3：レガシーシステムの維持

既に country-data に依存しているコードベースのリファクタリング前です。

  • ⚠️ 注意: country-data
  • 理由：既存コードとの互換性のため一時的に使用しますが、移行計画を立てるべきです。
// 既存のラッパー関数に依存している場合、即時変更はリスク大
import countries from 'country-data';

シナリオ 4：地理情報可视化（マップ表示など）

国境線や緯度経度データが必要な場合です。

  • ✅ 推奨: world-countries
  • 理由：地理座標データが含まれているため、マップライブラリとの相性が良いです。
import countries from 'world-countries';

// マップの初期位置などに使用
const center = countries.find(c => c.cca2 === 'FR').latlng;

📊 比較サマリー

特徴countries-and-timezonescountries-listcountry-dataworld-countries
主要用途国＋タイムゾーン管理簡易国リスト詳細国情報（通貨等）地理情報データ
タイムゾーン✅ 統合済み❌ 非対応⚠️ 限定的❌ 非対応
メンテナンス✅ 活発⚠️ 低頻度❌ 停止リスク🟡 中程度
TypeScript✅ 対応⚠️ 外部定義⚠️ 外部定義🟡 対応
新規推奨度🌟 高い🟡 普通❌ 非推奨🟡 特殊用途

💡 結論：どれを選ぶべきか

迷ったら countries-and-timezones を選んでください。

フロントエンドアプリケーションにおいて、国データとタイムゾーンはセットで扱われることがほとんどです。これを別々のパッケージで管理するのは、コードの複雑化とデータ不整合のリスクを生みます。countries-and-timezones はその課題を解決し、かつ積極的にメンテナンスされています。

country-data は過去の遺産として扱い、新規プロジェクトでは避けるのが賢明です。countries-list や world-countries は、タイムゾーンが不要な場合や、地理座標データが明確に必要な場合など、特定のニッチな要件がある時にのみ検討しましょう。

データはアプリケーションの基盤です。更新が止まったデータソースに依存することは、将来的なバグやセキュリティ問題の元になります。信頼性の高いパッケージを選ぶことが、結果的に開発コストの削減につながります。

選び方: countries-and-timezones vs countries-list vs country-data vs world-countries

  • countries-and-timezones:

    最新のデータと積極的なメンテナンスを重視する場合は countries-and-timezones が最適です。国データとタイムゾーンデータが統合されており、TypeScript 定義も充実しているため、モダンなフロントエンド開発において最も信頼性の高い選択肢となります。

  • countries-list:

    非常にシンプルな国リストのみが必要で、タイムゾーンや通貨などの追加データが不要な場合に countries-list を検討できます。ただし、機能が限定的であり、複雑な要件には対応できないため、小規模なプロジェクト向けです。

  • country-data:

    country-data はかつて人気でしたが、現在はメンテナンスが停止している可能性が高いため、新しいプロジェクトでの使用は避けるべきです。既に導入されているレガシーシステムでのみ使用を検討し、新規採用の場合は代替パッケージへの移行を計画してください。

  • world-countries:

    特定のデータフォーマットや軽量なセットを必要とする場合 world-countries が候補になりますが、コミュニティの規模と更新頻度は countries-and-timezones に劣ります。特殊な要件がない限り、より標準的なパッケージを選ぶのが無難です。

countries-and-timezonesと類似したnpmパッケージ

countries-and-timezones は、国とタイムゾーンに関するデータを提供する npm パッケージです。このライブラリは、国コード（ISO 3166）、国名、および関連するタイムゾーン情報を簡単に取得できるように設計されており、日付や時刻を国ごとに扱う必要があるアプリケーションに便利です。countries-and-timezones には代替となる他のパッケージも存在します。以下にいくつかの選択肢を紹介します：

  • countries-list は、国に関する包括的な情報（国名、通貨、言語、電話コードなど）を提供する軽量なパッケージです。このライブラリは、多言語対応やローカライズされた国名を必要とするアプリケーションに適しています。シンプルな API と豊富なメタデータが特徴です。
  • country-data は、国コード、通貨、電話プレフィックスなどの基本的な国情報を含むデータセットを提供します。主に静的な国データを必要とするプロジェクト向けで、依存関係が少なく使いやすいのが利点です。
  • world-countries は、GeoJSON 形式を含む世界中の国の地理的・政治的情報を提供するパッケージです。地図表示や地理空間データを扱うアプリケーションに最適で、国境や座標情報も含まれています。

比較はこちら：countries-and-timezones vs countries-list vs country-data vs world-countries

countries-listと類似したnpmパッケージ

countries-listは、国の情報を提供するためのシンプルで使いやすいnpmパッケージです。このパッケージは、国名、ISOコード、通貨、言語などの情報を含む国のリストを提供します。国に関するデータを必要とするアプリケーションにとって、非常に便利なツールです。しかし、他にも同様の機能を持つライブラリがいくつかあります。以下はその代替案です。

  • countries-and-timezonesは、国とそのタイムゾーンに関する情報を提供するパッケージです。このライブラリは、国名、ISOコード、タイムゾーン情報を含むデータを提供し、特に日時や地域に関連するアプリケーションに役立ちます。国とタイムゾーンの情報を一緒に扱いたい場合に最適です。
  • country-dataは、国に関する詳細なデータを提供するライブラリで、国名、ISOコード、通貨、言語、地理情報などを含んでいます。このパッケージは、国に関する豊富な情報を必要とするアプリケーションに適しています。特に、国の詳細なデータを扱う必要がある場合に便利です。
  • country-listは、国名とISOコードのリストを提供するシンプルなライブラリです。基本的な国情報を必要とする場合に適しており、軽量で使いやすいです。特に、国名やISOコードを簡単に取得したい場合に役立ちます。
  • i18n-iso-countriesは、国名を国際化するためのライブラリで、ISOコードに基づいて国名を多言語で提供します。国名を多言語で表示する必要があるアプリケーションに最適です。
  • iso-3166-1は、ISO 3166-1標準に基づく国コードを提供するライブラリです。このパッケージは、国コードの標準化されたリストを必要とする場合に役立ちます。

これらのパッケージの比較については、こちらをご覧ください: Comparing countries-and-timezones vs countries-list vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1。

country-dataと類似したnpmパッケージ

country-dataは、国に関するデータを提供するnpmパッケージです。このライブラリは、国名、ISOコード、通貨、言語などの情報を簡単に取得できるように設計されています。国に関連するデータを扱うアプリケーションやサービスにとって非常に便利です。しかし、country-dataには他にもいくつかの代替ライブラリがあります。以下はそのいくつかです。

  • countries-listは、国のリストとそれに関連する情報を提供するシンプルなライブラリです。国名やISOコードを簡単に取得できるため、国に関連するデータを扱う際に便利です。軽量で使いやすいこのライブラリは、特に基本的な国情報が必要なプロジェクトに適しています。
  • country-code-lookupは、国コードを簡単に検索できるライブラリです。ISO 3166-1の国コードを使用して、国名やその他の情報を取得することができます。特に国コードに特化した機能を必要とする場合に役立ちます。
  • country-listは、国名とそのISOコードのリストを提供するライブラリです。シンプルで使いやすく、国に関する基本的な情報を迅速に取得できるため、軽量なアプリケーションやプロジェクトに適しています。
  • i18n-iso-countriesは、国名を多言語で提供するライブラリです。国名を異なる言語で取得できるため、国際化対応のアプリケーションに非常に便利です。特に、複数の言語に対応する必要があるプロジェクトに最適です。

これらのパッケージの比較については、こちらをご覧ください: Comparing countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries。

countries-and-timezones のREADME

countries-and-timezones

GitHub Actions Status NPM Downloads License: MIT

Minimalistic library to work with countries and timezones data. Updated with the IANA timezones database.

Usage

NodeJS

Install with npm or yarn:

npm install --save countries-and-timezones

Browser

Add the following script to your project (only ~9kb):

<!-- Latest version -->
<script
  src="https://cdn.jsdelivr.net/gh/manuelmhtr/countries-and-timezones@latest/dist/index.min.js"
  type="text/javascript"
></script>

<!-- Or specify a version -->
<script
  src="https://cdn.jsdelivr.net/gh/manuelmhtr/countries-and-timezones@v3.8.0/dist/index.min.js"
  type="text/javascript"
></script>

<!-- This will export a variable named "ct": -->
<script type="text/javascript">
  var data = ct.getCountry("MX");
  console.log(data);
</script>

API

.getCountry(id, options = {})

Returns a country referenced by its id.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const country = ct.getCountry("DE");
console.log(country);

/*
Prints:

{
  id: 'DE',
  name: 'Germany',
  timezones: [ 'Europe/Berlin', 'Europe/Zurich' ]
}

*/

.getTimezone(name)

Returns a timezone referenced by its name.

Example

const ct = require("countries-and-timezones");

const timezone = ct.getTimezone("America/Los_Angeles");
console.log(timezone);

/*
Prints:

{
  name: 'America/Los_Angeles',
  countries: [ 'US' ],
  utcOffset: -480,
  utcOffsetStr: '-08:00',
  dstOffset: -420,
  dstOffsetStr: '-07:00',
  aliasOf: null
}

*/

.getAllCountries(options = {})

Returns an object with the data of all countries.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const countries = ct.getAllCountries();
console.log(countries);

/*
Prints:

{
  AD: {
    id: 'AD',
    name: 'Andorra',
    timezones: [ 'Europe/Andorra' ]
  },
  AE: {
    id: 'AE',
    name: 'United Arab Emirates',
    timezones: [ 'Asia/Dubai' ]
  },
  AF: {
    id: 'AF',
    name: 'Afghanistan',
    timezones: [ 'Asia/Kabul' ]
  },
  AG: {
    id: 'AG',
    name: 'Antigua and Barbuda',
    timezones: [ 'America/Puerto_Rico' ]
  },
  ...
}

*/

.getAllTimezones(options = {})

Returns an object with the data of all timezones.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const timezones = ct.getAllTimezones();
console.log(timezones);

/*
Prints:

{
  "Africa/Abidjan": {
    "name": "Africa/Abidjan",
    "countries": [
      "CI", "BF", "GH",
      "GM", "GN", "ML",
      "MR", "SH", "SL",
      "SN", "TG"
    ],
    "utcOffset": 0,
    "utcOffsetStr": "+00:00",
    "dstOffset": 0,
    "dstOffsetStr": "+00:00",
    "aliasOf": null
  },
  "Africa/Algiers": {
    "name": "Africa/Algiers",
    "countries": [
      "DZ"
    ],
    "utcOffset": 60,
    "utcOffsetStr": "+01:00",
    "dstOffset": 60,
    "dstOffsetStr": "+01:00",
    "aliasOf": null
  },
  "Africa/Bissau": {
    "name": "Africa/Bissau",
    "countries": [
      "GW"
    ],
    "utcOffset": 0,
    "utcOffsetStr": "+00:00",
    "dstOffset": 0,
    "dstOffsetStr": "+00:00",
    "aliasOf": null
  },
  ...
}

*/

.getTimezonesForCountry(id, options = {})

Returns an array with all the timezones of a country given its id.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const timezones = ct.getTimezonesForCountry("MX");
console.log(timezones);

/*
Prints:

[
  {
    "name": "America/Bahia_Banderas",
    "countries": [ "MX" ],
    "utcOffset": -360,
    "utcOffsetStr": "-06:00",
    "dstOffset": -300,
    "dstOffsetStr": "-05:00",
    "aliasOf": null
  },
  {
    "name": "America/Cancun",
    "countries": [ "MX" ],
    "utcOffset": -300,
    "utcOffsetStr": "-05:00",
    "dstOffset": -300,
    "dstOffsetStr": "-05:00",
    "aliasOf": null
  },
  {
    "name": "America/Chihuahua",
    "countries": [ "MX" ],
    "utcOffset": -420,
    "utcOffsetStr": "-07:00",
    "dstOffset": -360,
    "dstOffsetStr": "-06:00",
    "aliasOf": null
  },
  ...
}

*/

.getCountriesForTimezone(name, options = {})

Returns a list of the countries that uses a timezone given its name. When a timezone has multiple countries the first element is more relevant due to its geographical location.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const timezone = ct.getCountriesForTimezone("Europe/Zurich");
console.log(timezone);

/*
Prints:

[
  {
    "id": "CH",
    "name": "Switzerland",
    "timezones": [
      "Europe/Zurich"
    ]
  },
  {
    "id": "DE",
    "name": "Germany",
    "timezones": [
      "Europe/Berlin",
      "Europe/Zurich"
    ]
  },
  {
    "id": "LI",
    "name": "Liechtenstein",
    "timezones": [
      "Europe/Zurich"
    ]
  }
]

*/

.getCountryForTimezone(name, options = {})

Returns a the most relevant country (due to its geographical location) that uses a timezone given its name.

Accepts a parameter with options.

Example

const ct = require("countries-and-timezones");

const timezone = ct.getCountryForTimezone("Europe/Zurich");
console.log(timezone);

/*
Prints:

{
  "id": "CH",
  "name": "Switzerland",
  "timezones": [
    "Europe/Zurich"
  ]
}

*/

options

Available options for functions are:

ParameterTypeDescription
deprecatedBooleanIndicates if the result should include deprecated timezones or not. By default no deprecated timezones are included.

Data models

Country

A country is defined by the following parameters:

ParameterTypeDescription
idStringThe country ISO 3166-1 code.
nameStringPreferred name of the country.
timezonesArray[String]The list of timezones used in the country.
{
  id: 'MX',
  name: 'Mexico',
  timezones: [
    'America/Bahia_Banderas',
    'America/Cancun',
    'America/Chihuahua',
    'America/Hermosillo',
    'America/Matamoros',
    'America/Mazatlan',
    'America/Merida',
    'America/Mexico_City',
    'America/Monterrey',
    'America/Ojinaga',
    'America/Tijuana'
  ]
}

Timezone

A timezone is defined by the following parameters:

ParameterTypeDescription
nameStringThe name of the timezone, from tz database.
countries[String]A list of ISO 3166-1 codes of the countries where it's used. Etc/*, GMT and UTC timezones don't have associated countries.
utcOffsetNumberThe difference in minutes between the timezone and UTC.
utcOffsetStrStringThe difference in hours and minutes between the timezone and UTC, expressed as string with format: ±[hh]:[mm].
dstOffsetNumberThe difference in minutes between the timezone and UTC during daylight saving time (DST). When utcOffset and dstOffset are the same, means that the timezone does not observe a daylight saving time.
dstOffsetStrStringThe difference in hours and minutes between the timezone and UTC during daylight saving time (DST, expressed as string with format: ±[hh]:[mm].
aliasOfStringThe name of a primary timezone in case this is an alias. null means this is a primary timezone.
deprecatedBooleantrue when the timezone has been deprecated, otherwise this property is not returned.
{
  name: 'Asia/Tel_Aviv',
  countries: [ 'IL' ],
  utcOffset: 120,
  utcOffsetStr: '+02:00',
  dstOffset: 180,
  dstOffsetStr: '+03:00',
  aliasOf: 'Asia/Jerusalem',
  deprecated: true
}

Related projects

Support

Consider sponsoring this project.

Working on something more complex?

Meet Spott:

  • Search any city, country or administrative division in the world. By full strings or autocompletion.
  • Find a place by an IP address.
  • Access to more than 240,000 geographical places. In more than 20 languages.

Spott API for cities, countries and administrative divisions

License

MIT

npm-compare.com is an independent website designed to help developers choose the most suitable npm packages. We are not affiliated with npm, Inc, the official website for the npm registry. Note that npm is a registered trademark of npm, Inc. Please share your feedback via our GitHub repository. For more details, please refer to our Terms & Privacy.