Skip to content

Releases: ikelaiah/tzbundler

🌍 tzbundler v1.0.0 - Initial Release

28 Jul 09:34
@ikelaiah ikelaiah
v1.0.0
d3e4dcf

Choose a tag to compare

View all tags
🌍 tzbundler v1.0.0 - Initial Release Latest
Latest

🎉 Welcome to tzbundler v1.0.0!

A Python tool that parses IANA timezone database files and converts them into machine-readable formats (JSON and SQLite) with Windows timezone support.

✨ Features

🌍 Core Functionality

  • Parse IANA tzdata files into structured JSON and SQLite formats
  • Windows timezone mappings from Unicode CLDR for cross-platform compatibility
  • Complete historical data including all timezone transitions since 1970
  • DST rule extraction - Raw rule data for custom DST calculations
  • Multiple output formats - Both JSON and SQLite for different use cases

📊 What You Get

  • 400+ timezones with complete metadata (country codes, coordinates, comments)
  • Windows mappings for 100+ timezone names
  • DST rules for accurate daylight saving time calculations
  • Aliases support - Handle alternative timezone names
  • Rich metadata - Coordinates, country codes, descriptions

📦 Quick Start

# Clone the repository
git clone https://github.com/ikelaiah/tzbundler.git
cd tzbundler

# Install dependencies
pip install -r requirements.txt

# Run the bundler
python tzbundler/make_tz_bundle.py

📁 Output Files

  • tzdata/combined.json - All timezone data in JSON format
  • tzdata/combined.sqlite - Normalized SQLite database with 4 tables

🎯 Use Cases

  • Cross-platform applications needing both IANA and Windows timezone support
  • Data analysis of timezone patterns and historical changes
  • Custom DST implementations using raw rule data
  • Research projects involving temporal data
  • Migration between timezone systems

🏗️ Technical Highlights

  • Consumer-driven DST logic - You implement DST calculations as needed

  • Windows compatibility - Official mappings from Unicode CLDR

  • Version tracking - Includes tzdata version information

  • Complete data integrity - Extensive test suite validates all outputs

📚 Documentation

🧪 Tested & Reliable

  • 17 comprehensive tests covering JSON, SQLite, and data consistency
  • Cross-format validation ensuring JSON and SQLite contain identical data

Built with ❤️ for developers who need reliable timezone data

Assets 4
Loading