| Haskell Hierarchical Libraries (time package) | Source code | Contents | Index
Data.Time.LocalTime
Contents
Time zones Time of day Local Time
Synopsis
data TimeZone = TimeZone {
timeZoneMinutes :: Int
timeZoneSummerOnly :: Bool
timeZoneName :: String
}
timeZoneOffsetString :: TimeZone -> String
minutesToTimeZone :: Int -> TimeZone
hoursToTimeZone :: Int -> TimeZone
utc :: TimeZone
getTimeZone :: UTCTime -> IO TimeZone
getCurrentTimeZone :: IO TimeZone
data TimeOfDay = TimeOfDay {
todHour :: Int
todMin :: Int
todSec :: Pico
}
midnight :: TimeOfDay
midday :: TimeOfDay
utcToLocalTimeOfDay :: TimeZone -> TimeOfDay -> (Integer, TimeOfDay)
localToUTCTimeOfDay :: TimeZone -> TimeOfDay -> (Integer, TimeOfDay)
timeToTimeOfDay :: DiffTime -> TimeOfDay
timeOfDayToTime :: TimeOfDay -> DiffTime
dayFractionToTimeOfDay :: Rational -> TimeOfDay
timeOfDayToDayFraction :: TimeOfDay -> Rational
data LocalTime = LocalTime {
localDay :: Day
localTimeOfDay :: TimeOfDay
}
utcToLocalTime :: TimeZone -> UTCTime -> LocalTime
localTimeToUTC :: TimeZone -> LocalTime -> UTCTime
ut1ToLocalTime :: Rational -> UniversalTime -> LocalTime
localTimeToUT1 :: Rational -> LocalTime -> UniversalTime
data ZonedTime = ZonedTime {
zonedTimeToLocalTime :: LocalTime
zonedTimeZone :: TimeZone
}
utcToZonedTime :: TimeZone -> UTCTime -> ZonedTime
zonedTimeToUTC :: ZonedTime -> UTCTime
getZonedTime :: IO ZonedTime
utcToLocalZonedTime :: UTCTime -> IO ZonedTime
Time zones
data TimeZone
A TimeZone is a whole number of minutes offset from UTC, together with a name and a "just for summer" flag.
Constructors
TimeZone |
timeZoneMinutes :: Int | The number of minutes offset from UTC. Positive means local time will be later in the day than UTC.
timeZoneSummerOnly :: Bool | Is this time zone just persisting for the summer?
timeZoneName :: String | The name of the zone, typically a three- or four-letter acronym.
Instances
Eq TimeZone
FormatTime TimeZone
Ord TimeZone
ParseTime TimeZone
Read TimeZone
Show TimeZone
timeZoneOffsetString :: TimeZone -> String
Text representing the offset of this timezone, such as "-0800" or "+0400" (like %z in formatTime)
minutesToTimeZone :: Int -> TimeZone
Create a nameless non-summer timezone for this number of minutes
hoursToTimeZone :: Int -> TimeZone
Create a nameless non-summer timezone for this number of hours
utc :: TimeZone
The UTC time zone
getTimeZone :: UTCTime -> IO TimeZone
Get the local time-zone for a given time (varying as per summertime adjustments)
getCurrentTimeZone :: IO TimeZone
Get the current time-zone
Time of day
data TimeOfDay
Time of day as represented in hour, minute and second (with picoseconds), typically used to express local time of day.
Constructors
TimeOfDay |
todHour :: Int | range 0 - 23
todMin :: Int | range 0 - 59
todSec :: Pico | Note that 0 <= todSec < 61, accomodating leap seconds. Any local minute may have a leap second, since leap seconds happen in all zones simultaneously
Instances
Eq TimeOfDay
FormatTime TimeOfDay
Ord TimeOfDay
ParseTime TimeOfDay
Read TimeOfDay
Show TimeOfDay
midnight :: TimeOfDay
Hour zero
midday :: TimeOfDay
Hour twelve
utcToLocalTimeOfDay :: TimeZone -> TimeOfDay -> (Integer, TimeOfDay)
Convert a ToD in UTC to a ToD in some timezone, together with a day adjustment.
localToUTCTimeOfDay :: TimeZone -> TimeOfDay -> (Integer, TimeOfDay)
Convert a ToD in some timezone to a ToD in UTC, together with a day adjustment.
timeToTimeOfDay :: DiffTime -> TimeOfDay
Get a TimeOfDay given a time since midnight. Time more than 24h will be converted to leap-seconds.
timeOfDayToTime :: TimeOfDay -> DiffTime
Find out how much time since midnight a given TimeOfDay is.
dayFractionToTimeOfDay :: Rational -> TimeOfDay
Get a TimeOfDay given the fraction of a day since midnight.
timeOfDayToDayFraction :: TimeOfDay -> Rational
Get the fraction of a day since midnight given a TimeOfDay.
Local Time
data LocalTime
A simple day and time aggregate, where the day is of the specified parameter, and the time is a TimeOfDay. Conversion of this (as local civil time) to UTC depends on the time zone. Conversion of this (as local mean time) to UT1 depends on the longitude.
Constructors
LocalTime |
localDay :: Day |
localTimeOfDay :: TimeOfDay |
Instances
Eq LocalTime
FormatTime LocalTime
Ord LocalTime
ParseTime LocalTime
Read LocalTime
Show LocalTime
utcToLocalTime :: TimeZone -> UTCTime -> LocalTime
show a UTC time in a given time zone as a LocalTime
localTimeToUTC :: TimeZone -> LocalTime -> UTCTime
find out what UTC time a given LocalTime in a given time zone is
ut1ToLocalTime :: Rational -> UniversalTime -> LocalTime
1st arg is observation meridian in degrees, positive is East
localTimeToUT1 :: Rational -> LocalTime -> UniversalTime
1st arg is observation meridian in degrees, positive is East
data ZonedTime
A local time together with a TimeZone.
Constructors
ZonedTime |
zonedTimeToLocalTime :: LocalTime |
zonedTimeZone :: TimeZone |
Instances
FormatTime ZonedTime
ParseTime ZonedTime
Read ZonedTime
Show ZonedTime
utcToZonedTime :: TimeZone -> UTCTime -> ZonedTime
zonedTimeToUTC :: ZonedTime -> UTCTime
getZonedTime :: IO ZonedTime
utcToLocalZonedTime :: UTCTime -> IO ZonedTime
Produced by Haddock version 0.8