Chrono.TimeStamp

Documentation

newtype TimeStamp

Number of nanoseconds since the Unix epoch.

The Show instance displays the TimeStamp as seconds with the nanosecond precision expressed as a decimal amount after the interger, ie:

>>> t <- getCurrentTimeNanoseconds
>>> show t
2014-07-31T23:09:35.274387031Z

However this doesn't change the fact the underlying representation counts nanoseconds since epoch:

>>> show $ unTimeStamp t
1406848175274387031

There is a Read instance that is reasonably accommodating.

>>> read "2014-07-31T13:05:04.942089001Z" :: TimeStamp
2014-07-31T13:05:04.942089001Z

>>> read "1406811904.942089001" :: TimeStamp
2014-07-31T13:05:04.942089001Z

>>> read "1406811904" :: TimeStamp
2014-07-31T13:05:04.000000000Z

In case you're wondering, the valid range of nanoseconds that fits into the underlying Int64 is:

>>> show $ minBound :: TimeStamp
1677-09-21T00:12:43.145224192Z

>>> show $ maxBound :: TimeStamp
2262-04-11T23:47:16.854775807Z

so in a quarter millenium's time, yes, you'll have the Y2262 Problem. Haskell code from today will, of course, still be running, so in the mid Twenty-Third century you will need to replace this implementation with something else.

Constructors

TimeStamp

Fields

• unTimeStamp :: Int64

Instances

Bounded TimeStamp

Methods

minBound :: TimeStamp

maxBound :: TimeStamp

Enum TimeStamp

Methods

succ :: TimeStamp -> TimeStamp

pred :: TimeStamp -> TimeStamp

toEnum :: Int -> TimeStamp

fromEnum :: TimeStamp -> Int

enumFrom :: TimeStamp -> [TimeStamp]

enumFromThen :: TimeStamp -> TimeStamp -> [TimeStamp]

enumFromTo :: TimeStamp -> TimeStamp -> [TimeStamp]

enumFromThenTo :: TimeStamp -> TimeStamp -> TimeStamp -> [TimeStamp]

Eq TimeStamp

Methods

(==) :: TimeStamp -> TimeStamp -> Bool

(/=) :: TimeStamp -> TimeStamp -> Bool

Integral TimeStamp

Methods

quot :: TimeStamp -> TimeStamp -> TimeStamp

rem :: TimeStamp -> TimeStamp -> TimeStamp

div :: TimeStamp -> TimeStamp -> TimeStamp

mod :: TimeStamp -> TimeStamp -> TimeStamp

quotRem :: TimeStamp -> TimeStamp -> (TimeStamp, TimeStamp)

divMod :: TimeStamp -> TimeStamp -> (TimeStamp, TimeStamp)

toInteger :: TimeStamp -> Integer

Num TimeStamp

Methods

(+) :: TimeStamp -> TimeStamp -> TimeStamp

(-) :: TimeStamp -> TimeStamp -> TimeStamp

(*) :: TimeStamp -> TimeStamp -> TimeStamp

negate :: TimeStamp -> TimeStamp

abs :: TimeStamp -> TimeStamp

signum :: TimeStamp -> TimeStamp

fromInteger :: Integer -> TimeStamp

Ord TimeStamp

Methods

compare :: TimeStamp -> TimeStamp -> Ordering

(<) :: TimeStamp -> TimeStamp -> Bool

(<=) :: TimeStamp -> TimeStamp -> Bool

(>) :: TimeStamp -> TimeStamp -> Bool

(>=) :: TimeStamp -> TimeStamp -> Bool

max :: TimeStamp -> TimeStamp -> TimeStamp

min :: TimeStamp -> TimeStamp -> TimeStamp

Read TimeStamp

Methods

readsPrec :: Int -> ReadS TimeStamp

readList :: ReadS [TimeStamp]

readPrec :: ReadPrec TimeStamp

readListPrec :: ReadPrec [TimeStamp]

Real TimeStamp

Methods

toRational :: TimeStamp -> Rational

Show TimeStamp

Methods

showsPrec :: Int -> TimeStamp -> ShowS

show :: TimeStamp -> String

showList :: [TimeStamp] -> ShowS

Timeable TimeStamp

Methods

timeGetElapsedP :: TimeStamp -> ElapsedP

timeGetElapsed :: TimeStamp -> Elapsed

timeGetNanoSeconds :: TimeStamp -> NanoSeconds

Time TimeStamp

Methods

timeFromElapsedP :: ElapsedP -> TimeStamp

timeFromElapsed :: Elapsed -> TimeStamp

Unbox TimeStamp

Vector Vector TimeStamp

Methods

basicUnsafeFreeze :: PrimMonad m => Mutable Vector (PrimState m) TimeStamp -> m (Vector TimeStamp)

basicUnsafeThaw :: PrimMonad m => Vector TimeStamp -> m (Mutable Vector (PrimState m) TimeStamp)

basicLength :: Vector TimeStamp -> Int

basicUnsafeSlice :: Int -> Int -> Vector TimeStamp -> Vector TimeStamp

basicUnsafeIndexM :: Monad m => Vector TimeStamp -> Int -> m TimeStamp

basicUnsafeCopy :: PrimMonad m => Mutable Vector (PrimState m) TimeStamp -> Vector TimeStamp -> m ()

elemseq :: Vector TimeStamp -> TimeStamp -> b -> b

MVector MVector TimeStamp

Methods

basicLength :: MVector s TimeStamp -> Int

basicUnsafeSlice :: Int -> Int -> MVector s TimeStamp -> MVector s TimeStamp

basicOverlaps :: MVector s TimeStamp -> MVector s TimeStamp -> Bool

basicUnsafeNew :: PrimMonad m => Int -> m (MVector (PrimState m) TimeStamp)

basicInitialize :: PrimMonad m => MVector (PrimState m) TimeStamp -> m ()

basicUnsafeReplicate :: PrimMonad m => Int -> TimeStamp -> m (MVector (PrimState m) TimeStamp)

basicUnsafeRead :: PrimMonad m => MVector (PrimState m) TimeStamp -> Int -> m TimeStamp

basicUnsafeWrite :: PrimMonad m => MVector (PrimState m) TimeStamp -> Int -> TimeStamp -> m ()

basicClear :: PrimMonad m => MVector (PrimState m) TimeStamp -> m ()

basicSet :: PrimMonad m => MVector (PrimState m) TimeStamp -> TimeStamp -> m ()

basicUnsafeCopy :: PrimMonad m => MVector (PrimState m) TimeStamp -> MVector (PrimState m) TimeStamp -> m ()

basicUnsafeMove :: PrimMonad m => MVector (PrimState m) TimeStamp -> MVector (PrimState m) TimeStamp -> m ()

basicUnsafeGrow :: PrimMonad m => MVector (PrimState m) TimeStamp -> Int -> m (MVector (PrimState m) TimeStamp)

data Vector TimeStamp

data Vector TimeStamp = V_TimeStamp (Vector Int64)

data MVector s TimeStamp

data MVector s TimeStamp = MV_TimeStamp (MVector s Int64)

getCurrentTimeNanoseconds :: IO TimeStamp

Get the current system time, expressed as a TimeStamp (which is to say, number of nanoseconds since the Unix epoch).

data ISO8601_Precise

Format string describing full (nanosecond) precision ISO8601 time,

2014-07-31T23:09:35.274387019Z

Constructors

ISO8601_Precise

Instances

TimeFormat ISO8601_Precise

Methods

toFormat :: ISO8601_Precise -> TimeFormatString