TZDB
An offline, compiled IANA time zone database for Delphi and FreePascal applications.
What is TZDB?
TZDB is an offline, in-process compiled database for IANA's Time Zone Database, designed for Delphi and FreePascal. It provides reliable time zone conversion and calculation capabilities without requiring external services or runtime dependencies, solving the problem of accurate time zone handling in Pascal applications.
Delphi and FreePascal developers who need to handle time zones accurately in their applications, especially those requiring offline functionality or avoiding external dependencies.
Developers choose TZDB for its simplicity, small footprint, and comprehensive API that includes Windows time zone alias support, making it a robust, self-contained alternative to manual time zone implementations or online services.
Overview
Delphi/FPC Time Zone Database
Use Cases
Best For
- Handling time zone conversions in offline Delphi applications
- Converting between Windows time zone names and IANA identifiers
- Managing daylight saving time (DST) transitions accurately
- Embedding time zone data without external dependencies
- Developing cross-platform Pascal applications with consistent time zone handling
- Avoiding network calls for time zone lookups in desktop software
Not Ideal For
- Applications requiring real-time updates to time zone data, as TZDB's compiled database has a 1-2 week delay after IANA releases.
- Projects handling historical or future dates beyond the database's covered year range, which could trigger EUnknownTimeZoneYear exceptions.
- Teams using programming languages other than Pascal, since TZDB is specifically designed for Delphi and FreePascal only.
- Systems where minimizing exception handling is critical, due to potential for invalid or ambiguous time errors that must be actively managed.
Pros & Cons
Pros
Provides accurate time zone conversions without network dependencies, ensuring functionality in disconnected environments, as highlighted in the offline operation feature.
Single-file implementation with a pre-compiled database makes it easy to add to projects without external dependencies, reducing setup complexity.
Seamlessly converts between Windows time zone names and IANA identifiers using CLDR data, simplifying integration with Windows-based systems.
Includes methods like GetLocalTimeType to check for ambiguous and invalid times during daylight saving transitions, as demonstrated in the common examples.
Cons
The database is updated with a 1-2 week delay after IANA releases, and manual updates require specific tools like the Free Pascal compiler and update-compile.sh script.
Methods may throw EUnknownTimeZoneYear exceptions for dates outside the covered year range, requiring additional error handling in applications.
Restricted to Delphi XE+ and FreePascal 3+, limiting its use in multi-language or non-Pascal projects and ecosystems.
Frequently Asked Questions
Related Projects
LAMWLAMW: Lazarus Android Module Wizard: Form Designer and Components development model!
Markdown Processor for Pascaldelphi-markdown is a Pascal library that processes Markdown text and converts it to HTML. It provides native Markdown processing capabilities for Delphi and Free Pascal (FPC) applications, enabling developers to incorporate rich text formatting without relying on external dependencies. ## Key Features - **Multiple Dialect Support** — Processes Daring Fireball Markdown, CommonMark (partial), and GitHub Flavored Markdown - **Unicode Compatibility** — Works with any Unicode version of Delphi and cross-platform FPC - **Safety Controls** — Optional unsafe mode for active content with security warnings - **Comprehensive Testing** — Includes unit tests and CommonMark specification tests - **Cross-Platform** — Tested on Windows, Linux, and macOS with FPC ## Philosophy The library focuses on providing reliable, well-tested Markdown processing for Pascal developers while maintaining clear safety boundaries around potentially dangerous content.
TRegExprRegular expressions (regex), pascal.
GpDelphiUnitsA collection of my open sourced Delphi units
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.