timezone-olson

A pure Haskell parser and renderer for binary Olson timezone files

http://projects.haskell.org/time-ng/

Version on this page:	0.1.8
LTS Haskell 23.19:	0.2.1
Stackage Nightly 2025-04-24:	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.8@sha256:0ff3d6d9b874989575e5aa61ed6d8a30299edb0934059d61e9faee81049b441d,2236

Module documentation for 0.1.8

Data
- Data.Time
  - Data.Time.LocalTime
    - Data.Time.LocalTime.TimeZone
      - Data.Time.LocalTime.TimeZone.Olson
        Data.Time.LocalTime.TimeZone.Olson.Parse
        
        Data.Time.LocalTime.TimeZone.Olson.Render
        
        Data.Time.LocalTime.TimeZone.Olson.Types

Depends on 6 packages(full list with versions):

base, binary, bytestring, extensible-exceptions, time, timezone-series

timezone-olson

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.

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.