Data.Time.ZoneInfo

Provides access to the Olson zone-info database, using an adapted version of the Olson zone-info library.

Documentation

type Olson = ForeignPtr COlson

class ZoneInfo a where

Methods

zoneInfoName :: a -> Bool -> IO String

Returns the zone-name for either the standard or daylight saving zone, depending on the isdst boolean argument; an IOError will be thrown if this information is unavailable.

zoneInfoMinutes :: a -> Bool -> IO Int

Returns the UTC offset for either the standard or daylight saving zone, depending on the isdst boolean argument; an IOError will be thrown if this information is unavailable.

posixToZonedTime :: a -> POSIXTime -> IO ZonedTime

Convert from POSIXTime to zoned LocalTime.

utcToZonedTime' :: a -> UTCTime -> IO ZonedTime

Convert from UTCTime to zoned LocalTime.

localToPOSIXZoned :: a -> LocalTime -> IO (POSIXTime, TimeZone)

Convert LocalTime to a daylight saving adjusted pair.

localToUTCZoned :: a -> LocalTime -> IO (UTCTime, TimeZone)

Convert LocalTime to a daylight saving adjusted pair.

convertTimeZone :: ZoneInfo b => a -> LocalTime -> b -> IO ZonedTime

Convert the LocalTime argument from the source to destination TimeZone.

Instances

ZoneInfo TimeZone

TimeZone implementation.

ZoneInfo OlsonZone

OlsonZone implementation.

newOlson :: Maybe String -> IO Olson

Create an Olson context object. A path to the zone-info database may be specified. Otherwise, the TZDIR environment variable or a reasonable default will be used. An IOError will be thrown on failure.

newOlsonZone :: Olson -> String -> IO OlsonZone

Obtain an OlsonZone object based on the specified Olson identifier or time-zone. If the zone-info database cannot be found, or the time-zone not recognised, then an IOError will be thrown. Calls to this function for a given Olson object must be serialised across threads.

utcOlsonZone :: Olson -> OlsonZone

OlsonZone for the UTC time-zone.