A pure Haskell parser and renderer for binary Olson timezone files


Version on this page:0.1.9
LTS Haskell 22.29:0.2.1
Stackage Nightly 2024-07-17:0.2.1
Latest on Hackage:0.2.1

See all snapshots timezone-olson appears in

BSD-3-Clause licensed by Yitzchak Gale
Maintained by [email protected]
This version can be pinned in stack with:timezone-olson-0.1.9@sha256:012a4c60825907c5cb1d6be6a270cf8e0d9250afe9f3ca36880907038d3b8874,2278

Module documentation for 0.1.9

  • Data
    • Data.Time
      • Data.Time.LocalTime
        • Data.Time.LocalTime.TimeZone


On Hackage: timezone-olson

This package provides a parser and renderer for binary Olson timezone files whose format is specified by the tzfile(5) man page on Unix-like systems. For more information about this format, see the IANA timezone database site.

Functions are provided for converting the parsed data into TimeZoneSeries objects from the timezone-series package. On many platforms, binary Olson timezone files suitable for use with this package are available in the directory /usr/share/zoneinfo and its subdirectories on your computer.

See also the timezone-olson-th package for a way to include timezone informaton from a binary Olson timezone file at compile time.

Copyright (c) 2010-2018 Yitzchak Gale. All rights reserved.

For licensing information, see the BSD3-style license in the file LICENSE that was originally distributed by the author together with this file.

This package is part of the time-ng project.

Testing utilities

This package also provides two Haskell files, each of which can be compiled into a command-line utility that might be helpful for testing purposes.

zhdump.hs: A clone of zdump(8), including most of its bugs, that is usually present on systems that have an Olson timezone database, except hzdump takes paths to timezone files instead of timezone identifiers on the command line.

catTZ: Read and parse a timezone file, then render it. With the -i flag, interprets the timezone data as a TimeZoneSeries object before rendering.