Cabal-2.0.1.0: A framework for packaging Haskell software

Safe Haskell | None
Language | Haskell2010

Distribution.Compat.Time

Synopsis

- newtype ModTime = ModTime Word64
- getModTime :: FilePath -> NoCallStackIO ModTime
- getFileAge :: FilePath -> NoCallStackIO Double
- getCurTime :: NoCallStackIO ModTime
- posixSecondsToModTime :: Int64 -> ModTime
- calibrateMtimeChangeDelay :: IO (Int, Int)

# Documentation

newtype ModTime #

An opaque type representing a file's modification time, represented internally as a 64-bit unsigned integer in the Windows UTC format.

Constructors

ModTime Word64 |

Instances

Bounded ModTime # |
Methods minBound :: ModTime Source # maxBound :: ModTime Source #
Eq ModTime # |
Methods (==) :: ModTime -> ModTime -> Bool # (/=) :: ModTime -> ModTime -> Bool #
Ord ModTime # |
Methods compare :: ModTime -> ModTime -> Ordering # (<) :: ModTime -> ModTime -> Bool # (<=) :: ModTime -> ModTime -> Bool # (>) :: ModTime -> ModTime -> Bool # (>=) :: ModTime -> ModTime -> Bool # max :: ModTime -> ModTime -> ModTime # min :: ModTime -> ModTime -> ModTime #
Read ModTime # |
Methods readsPrec :: Int -> ReadS ModTime Source # readList :: ReadS [ModTime] Source # readPrec :: ReadPrec ModTime Source # readListPrec :: ReadPrec [ModTime] Source #
Show ModTime # |
Methods showsPrec :: Int -> ModTime -> ShowS Source # show :: ModTime -> String Source # showList :: [ModTime] -> ShowS Source #
Binary ModTime # |
Methods put :: ModTime -> Put Source # get :: Get ModTime Source # putList :: [ModTime] -> Put Source #

getModTime :: FilePath -> NoCallStackIO ModTime #

Return modification time of the given file. Works around the low clock resolution problem that `getModificationTime` has on GHC < 7.8.

This is a modified version of the code originally written for Shake by Neil Mitchell. See module Development.Shake.FileInfo.

getFileAge :: FilePath -> NoCallStackIO Double #

Return age of given file in days.

getCurTime :: NoCallStackIO ModTime #

Return the current time as `ModTime`.

posixSecondsToModTime :: Int64 -> ModTime #

Convert POSIX seconds to ModTime.

calibrateMtimeChangeDelay :: IO (Int, Int) #

Based on code written by Neil Mitchell for Shake. See `sleepFileTimeCalibrate` in `Type`. Returns a pair of microsecond values: first, the maximum delay seen, and the recommended delay to use before testing for file modification change. The returned delay is never smaller than 10 ms, but never larger than 1 second.