hourglass
simple performant time related library
https://github.com/vincenthz/hs-hourglass
| LTS Haskell 22.41: | 0.2.12@rev:1 |
| Stackage Nightly 2024-11-12: | 0.2.12@rev:1 |
| Latest on Hackage: | 0.2.12@rev:1 |
Maintained by [email protected]
This version can be pinned in stack with:
hourglass-0.2.12@sha256:85c46cb6cd30c84546929926d4402a534f723651198e5945c9e59b9e699a8979,3197Module documentation for 0.2.12
Depends on 2 packages(full list with versions):
Used by 10 packages in nightly-2024-11-12(full list with versions):
hourglass
Hourglass is a simple time library.
Documentation: hourglass on hackage
Design
Key parts of the design are the Timeable and Time typeclasses. Time representations of the same time values are interchangeable and easy to convert between each other. This also allows the user to define new time types that interact with the same functions as the built-in types.
For example:
let dateTime0 =
DateTime { dtDate = Date { dateYear = 1970, dateMonth = January, dateDay = 1 }
, dtTime = TimeOfDay {todHour = 0, todMin = 0, todSec = 0, todNSec = 0 }}
elapsed0 = Elasped 0
> timeGetElapsed elapsed0 == timeGetElapsed dateTime0
True
> timeGetDate elapsed0 == timeGetDate dateTime0
True
> timePrint "YYYY-MM" elapsed0
"1970-01"
> timePrint "YYYY-MM" dateTime0
"1970-01"
Hourglass has the same limitations as your system:
- On 32 bit linux, you can’t get a date after the year 2038.
- In Windows 7, you can’t get the date before the year 1601.
Comparaison with time
- Getting posix time:
-- With time
import Data.Time.Clock.POSIX
ptime <- getPOSIXTime
-- With hourglass
import System.Hourglass
ptime <- timeCurrent
- Getting the current year:
-- With time
import Data.Time.Clock
import Data.Time.Calendar
currentYear <- (\(y,_,_) -> y) . toGregorian . utcDay <$> getCurrentTime
-- With hourglass
import System.Hourglass
import Data.Time
currentYear <- dateYear . timeGetDate <$> timeCurrent
- Representating “4th May 1970 15:12:24”
-- With time
import Data.Time.Clock
import Date.Time.Calendar
let day = fromGregorian 1970 5 4
diffTime = secondsToDiffTime (15 * 3600 + 12 * 60 + 24)
in UTCTime day diffTime
-- With hourglass
import Date.Time
DateTime (Date 1970 May 4) (TimeOfDay 15 12 24 0)