git.iko.soy/typeable/timezone-olson
on master help sign in
typeable/timezone-olson/README.md
43 lines 1.8 kB history raw
1# timezone-olson
3On Hackage: [timezone-olson](http://hackage.haskell.org/package/timezone-olson)
5This package provides a parser and renderer for binary Olson timezone
6files whose format is specified by the tzfile(5) man page on Unix-like
7systems. For more information about this format, see
8[the IANA timezone database site](https://www.iana.org/time-zones).
10Functions are provided for
11converting the parsed data into `TimeZoneSeries` objects from the
12[timezone-series](http://hackage.haskell.org/package/timezone-series)
13package. On many platforms, binary Olson timezone
14files suitable for use with this package are available in the
15directory `/usr/share/zoneinfo` and its subdirectories on your computer.
17See also the
18[timezone-olson-th](http://hackage.haskell.org/package/timezone-olson-th)
19package for a way to include timezone informaton from a binary Olson
20timezone file at compile time.
22Copyright (c) 2010-2018 Yitzchak Gale. All rights reserved.
24For licensing information, see the BSD3-style license in the file
25LICENSE that was originally distributed by the author together with
26this file.
28This package is part of the [time-ng project](http://projects.haskell.org/time-ng/).
30## Testing utilities
32This package also provides two Haskell files, each of which can be
33compiled into a command-line utility that might be helpful for testing
34purposes.
36zhdump.hs: A clone of zdump(8), including most of its bugs, that
37 is usually present on systems that have an Olson timezone
38 database, except hzdump takes paths to timezone files
39 instead of timezone identifiers on the command line.
41catTZ: Read and parse a timezone file, then render it. With the
42 -i flag, interprets the timezone data as a TimeZoneSeries
43 object before rendering.