🌍 Countries and Timezones: The Ultimate Dataset

Welcome to the most comprehensive, hand-checked, and community-driven country and timezone dataset! Whether you're building a global app, validating user input, or just love world data, you've found your new favorite resource. 🚀

---

✨ What You'll Find Here

• 244 countries with official ISO codes, timezones, locales, phone codes, and more
• Data validated and cross-checked with multiple authoritative sources
• Ready-to-use JSON for your projects

---

🔗 Authoritative Sources & References (2024)

• Country Codes (ISO 3166): ISO Official Site
• Timezones: IANA Time Zone Database | PHP Timezones
• Phone Codes: Wikipedia: List of Country Calling Codes
• Locale Codes: Unicode CLDR | LocalePlanet
• Currency Codes (ISO 4217): ISO 4217 Currency Codes
• Comprehensive Datasets: dr5hn/countries-states-cities-database | GeoPostcodes Free Datasets
• Country Data APIs: CountryLayer | dev.me Country API

---

🚀 How to Use This Data

Example: Load and Query in Python

import json
with open('data/country.json') as f:
    countries = json.load(f)
# Find all countries in Europe
european_countries = [c for c in countries if 'Europe' in str(c.get('timezones', ''))]
print(european_countries)

Example: Validate a Country Code

const countries = require('./data/country.json');
function isValidCountryCode(code) {
  return countries.some(c => c.code === code);
}

---

🌐 Recommended APIs and Datasets

• CountryLayer API — Real-time, developer-friendly country data
• dr5hn/countries-states-cities-database — Open-source, multi-format world data
• GeoPostcodes Free Datasets — Timezones, currencies, languages, and more
• dev.me Country API — Fast, easy-to-integrate JSON API

---

🛠️ Validation

Our JSON is validated and passes all major validators:

• Toptal JSON Formatter
• CuriousConcept JSON Validator
• JSONLint
• CodeBeautify JSON Validator

You can (and should!) verify it yourself. If you spot an issue, let us know!

---

🤝 Contributing

We love community contributions! If you spot an error, want to add a country, or have a suggestion, open an issue or pull request. Your help makes this project better for everyone. 🌟

---

🎉 Fun Facts

• There are more official timezones than you might think—some countries have over 10!
• The smallest country by area (Vatican City) and the largest (Russia) are both included.
• Some countries share phone codes, but have unique timezones and locales.
• The IANA timezone database is updated several times a year to reflect real-world changes.

---

🙏 Thank You!

If this project saved you time or helped your work, please give it a ⭐ on GitHub! Your support keeps this data free and up-to-date for everyone.

---

Happy coding! 🌏🕒