Data.Time.ZoneInfo

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

Documentation

type ZoneInfo = ForeignPtr CZoneInfo

initZoneInfo :: Maybe String -> IO ()

Initialise the zone-info library. 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.

utcZoneInfo :: ZoneInfo

ZoneInfo for the UTC time-zone.

newZoneInfo :: String -> IO ZoneInfo

Create new ZoneInfo, given a suitable Olson identifier or time-zone specification. If the zone-info database cannot be found, or the time-zone not recognised, then an IOError will be thrown.

getZoneName :: ZoneInfo -> Bool -> IO String

Returns the zone-name for either the standard or daylight saving zone, depending on the isdst argument.

getZoneMinutes :: ZoneInfo -> Bool -> IO Int

Returns the UTC offset for either the standard or daylight saving zone, depending on the isdst argument.

posixToZonedTime :: ZoneInfo -> POSIXTime -> IO ZonedTime

Convert from POSIXTime to zoned LocalTime.

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

Convert from UTCTime to zoned LocalTime.

localToPOSIXZoned :: ZoneInfo -> LocalTime -> IO (POSIXTime, ZonedTime)

Convert LocalTime to a daylight saving adjusted pair.

localToUTCZoned :: ZoneInfo -> LocalTime -> IO (UTCTime, ZonedTime)

Convert LocalTime to a daylight saving adjusted pair.

convertTimeZone :: ZoneInfo -> LocalTime -> ZoneInfo -> IO ZonedTime

Convert the LocalTime argument from the source to destination TimeZone.