Moduleold-time-1.1.1.0Haskell2010

System.Time

The standard time library from Haskell 98. This library is deprecated, please look at Data.Time in the time package instead.

System.Time provides functionality for clock times, including timezone information (i.e, the functionality of "time.h", adapted to the Haskell environment). It follows RFC 1129 in its use of Coordinated Universal Time (UTC).

5 types
12 values

Packageold-time-1.1.1.0
Exports17
LanguageHaskell2010
LicenceBSD-3-Clause
SourceTime.hsc

Clock times

2 declarations

datadata ClockTime

A representation of the internal clock time. Clock times may be compared, converted to strings, or converted to an external calendar time CalendarTime for I/O or other manipulations.

Constructors

TOD Integer Integer
Construct a clock time. The arguments are a number of seconds since 00:00:00 (UTC) on 1 January 1970, and an additional number of picoseconds.
In Haskell 98, the ClockTime type is abstract.

Instances3Eq, Ord, Show

Eq ClockTimeDefined in old-time-1.1.1.0 · System.Time
Ord ClockTimeDefined in old-time-1.1.1.0 · System.Time
Show ClockTimeDefined in old-time-1.1.1.0 · System.Time

valuegetClockTime :: IO ClockTime

Time differences

7 declarations

datadata TimeDiff

records the difference between two clock times in a user-readable way.

Constructors

TimeDiff
- tdYear :: Int
- tdMonth :: Int
- tdDay :: Int
- tdHour :: Int
- tdMin :: Int
- tdSec :: Int
- tdPicosec :: Integer

Instances4Eq, Ord, Read, Show

Eq TimeDiffDefined in old-time-1.1.1.0 · System.Time
Ord TimeDiffDefined in old-time-1.1.1.0 · System.Time
Read TimeDiffDefined in old-time-1.1.1.0 · System.Time
Show TimeDiffDefined in old-time-1.1.1.0 · System.Time

valuenoTimeDiff :: TimeDiff

null time difference.

valuediffClockTimes :: ClockTime -> ClockTime -> TimeDiff

diffClockTimes t1 t2 returns the difference between two clock times t1 and t2 as a TimeDiff.

valueaddToClockTime :: TimeDiff -> ClockTime -> ClockTime

addToClockTime d t adds a time difference d and a clock time t to yield a new clock time. The difference d may be either positive or negative.

Strange things can happen when TimeDiff has non-zero months and years, including but not limited to ±1 hour jump when passing in and out daylight saving time.

valuenormalizeTimeDiff :: TimeDiff -> TimeDiff

Converts a time difference to normal form.

This function assumes that each month contains exactly 30 days and each year contains exactly 365 days, which is not true.

valuetimeDiffToString :: TimeDiff -> String

formats time differences using local conventions.

valueformatTimeDiff :: TimeLocale -> String -> TimeDiff -> String

formats time differences using local conventions and a formatting string. The formatting string is that understood by the ISO C strftime() function.

Calendar times

8 declarations

datadata CalendarTime

CalendarTime is a user-readable and manipulable representation of the internal ClockTime type.

Constructors

CalendarTime
- ctYear :: Int
  Year (pre-Gregorian dates are inaccurate)
- ctMonth :: Month
  Month of the year
- ctDay :: Int
  Day of the month (1 to 31)
- ctHour :: Int
  Hour of the day (0 to 23)
- ctMin :: Int
  Minutes (0 to 59)
- ctSec :: Int
  Seconds (0 to 61, allowing for up to two leap seconds)
- ctPicosec :: Integer
  Picoseconds
- ctWDay :: Day
  Day of the week
- ctYDay :: Int
  Day of the year (0 to 364, or 365 in leap years)
- ctTZName :: String
  Name of the time zone
- ctTZ :: Int
  Variation from UTC in seconds
- ctIsDST :: Bool
  True if Daylight Savings Time would be in effect, and False otherwise

Instances4Eq, Ord, Read, Show

Eq CalendarTimeDefined in old-time-1.1.1.0 · System.Time
Ord CalendarTimeDefined in old-time-1.1.1.0 · System.Time
Read CalendarTimeDefined in old-time-1.1.1.0 · System.Time
Show CalendarTimeDefined in old-time-1.1.1.0 · System.Time

datadata Month

A month of the year.

January February March April May June July August September October November December

Instances7Bounded, Enum, Eq, Ord, Read, Show, …

Bounded MonthDefined in old-time-1.1.1.0 · System.Time
Enum MonthDefined in old-time-1.1.1.0 · System.Time
Eq MonthDefined in old-time-1.1.1.0 · System.Time
Ord MonthDefined in old-time-1.1.1.0 · System.Time
Read MonthDefined in old-time-1.1.1.0 · System.Time
Show MonthDefined in old-time-1.1.1.0 · System.Time
Ix MonthDefined in old-time-1.1.1.0 · System.Time

datadata Day

A day of the week.

Sunday Monday Tuesday Wednesday Thursday Friday Saturday

Instances7Bounded, Enum, Eq, Ord, Read, Show, …

Bounded DayDefined in old-time-1.1.1.0 · System.Time
Enum DayDefined in old-time-1.1.1.0 · System.Time
Eq DayDefined in old-time-1.1.1.0 · System.Time
Ord DayDefined in old-time-1.1.1.0 · System.Time
Read DayDefined in old-time-1.1.1.0 · System.Time
Show DayDefined in old-time-1.1.1.0 · System.Time
Ix DayDefined in old-time-1.1.1.0 · System.Time

valuetoCalendarTime :: ClockTime -> IO CalendarTime

converts an internal clock time to a local time, modified by the timezone and daylight savings time settings in force at the time of conversion. Because of this dependence on the local environment, toCalendarTime is in the IO monad.

valuetoUTCTime :: ClockTime -> CalendarTime

converts an internal clock time into a CalendarTime in standard UTC format.

valuetoClockTime :: CalendarTime -> ClockTime

converts a CalendarTime into the corresponding internal ClockTime, ignoring the contents of the ctWDay, ctYDay, ctTZName and ctIsDST fields.

valuecalendarTimeToString :: CalendarTime -> String

formats calendar times using local conventions.

valueformatCalendarTime :: TimeLocale -> String -> CalendarTime -> String

formats calendar times using local conventions and a formatting string. The formatting string is that understood by the ISO C strftime() function.