{-| For date and time values, we use the standard Day and UTCTime types. A 'SmartDate' is a date which may be partially-specified or relative. Eg 2008/12/31, but also 2008/12, 12/31, tomorrow, last week, next year. We represent these as a triple of strings like ("2008","12",""), ("","","tomorrow"), ("","last","week"). A 'DateSpan' is the span of time between two specific calendar dates, or possibly an open-ended span where one or both dates are missing. We use this term since "period" and "interval" are ambiguous. -} module Ledger.Dates where import Data.Time.Clock import Data.Time.Format import Data.Time.Calendar import Data.Time.Calendar.MonthDay import Data.Time.Calendar.OrdinalDate import Data.Time.Calendar.WeekDate import Data.Time.LocalTime import System.Locale (defaultTimeLocale) import Text.Printf import Data.Maybe import Text.ParserCombinators.Parsec import Text.ParserCombinators.Parsec.Char import Text.ParserCombinators.Parsec.Combinator import Ledger.Types import Ledger.Utils showDate :: Day -> String showDate d = formatTime defaultTimeLocale "%Y/%m/%d" d mkUTCTime :: Day -> TimeOfDay -> UTCTime mkUTCTime day tod = localTimeToUTC utc (LocalTime day tod) today :: IO Day today = do t <- getZonedTime return $ localDay (zonedTimeToLocalTime t) now :: IO UTCTime now = getCurrentTime elapsedSeconds :: Fractional a => UTCTime -> UTCTime -> a elapsedSeconds t1 t2 = realToFrac $ diffUTCTime t1 t2 dayToUTC :: Day -> UTCTime dayToUTC d = localTimeToUTC utc (LocalTime d midnight) -- | Convert a period expression to a date span using the provided reference date. spanFromPeriodExpr refdate = spanFromSmartDateString refdate -- | Convert a smart date string to a date span using the provided reference date. spanFromSmartDateString :: Day -> String -> DateSpan spanFromSmartDateString refdate s = DateSpan (Just b) (Just e) where sdate = fromparse $ parsewith smartdate s (ry,rm,rd) = toGregorian refdate (b,e) = span sdate span :: SmartDate -> (Day,Day) span ("","","today") = (refdate, nextday refdate) span ("","this","day") = (refdate, nextday refdate) span ("","","yesterday") = (prevday refdate, refdate) span ("","last","day") = (prevday refdate, refdate) span ("","","tomorrow") = (nextday refdate, addDays 2 refdate) span ("","next","day") = (nextday refdate, addDays 2 refdate) span ("","last","week") = (prevweek refdate, thisweek refdate) span ("","this","week") = (thisweek refdate, nextweek refdate) span ("","next","week") = (nextweek refdate, startofweek $ addDays 14 refdate) span ("","last","month") = (prevmonth refdate, thismonth refdate) span ("","this","month") = (thismonth refdate, nextmonth refdate) span ("","next","month") = (nextmonth refdate, startofmonth $ addGregorianMonthsClip 2 refdate) span ("","last","quarter") = (prevquarter refdate, thisquarter refdate) span ("","this","quarter") = (thisquarter refdate, nextquarter refdate) span ("","next","quarter") = (nextquarter refdate, startofquarter $ addGregorianMonthsClip 6 refdate) span ("","last","year") = (prevyear refdate, thisyear refdate) span ("","this","year") = (thisyear refdate, nextyear refdate) span ("","next","year") = (nextyear refdate, startofyear $ addGregorianYearsClip 2 refdate) span ("","",d) = (day, nextday day) where day = fromGregorian ry rm (read d) span ("",m,"") = (startofmonth day, nextmonth day) where day = fromGregorian ry (read m) 1 span ("",m,d) = (day, nextday day) where day = fromGregorian ry (read m) (read d) span (y,"","") = (startofyear day, nextyear day) where day = fromGregorian (read y) 1 1 span (y,m,"") = (startofmonth day, nextmonth day) where day = fromGregorian (read y) (read m) 1 span (y,m,d) = (day, nextday day) where day = fromGregorian (read y) (read m) (read d) -- | Convert a smart date string to an explicit yyyy/mm/dd string using -- the provided reference date. fixSmartDateStr :: Day -> String -> String fixSmartDateStr t s = printf "%04d/%02d/%02d" y m d where (y,m,d) = toGregorian $ fixSmartDate t sdate sdate = fromparse $ parsewith smartdate $ map toLower s -- | Convert a SmartDate to an absolute date using the provided reference date. fixSmartDate :: Day -> SmartDate -> Day fixSmartDate refdate sdate = fix sdate where fix :: SmartDate -> Day fix ("","","today") = fromGregorian ry rm rd fix ("","this","day") = fromGregorian ry rm rd fix ("","","yesterday") = prevday refdate fix ("","last","day") = prevday refdate fix ("","","tomorrow") = nextday refdate fix ("","next","day") = nextday refdate fix ("","last","week") = prevweek refdate fix ("","this","week") = thisweek refdate fix ("","next","week") = nextweek refdate fix ("","last","month") = prevmonth refdate fix ("","this","month") = thismonth refdate fix ("","next","month") = nextmonth refdate fix ("","last","quarter") = prevquarter refdate fix ("","this","quarter") = thisquarter refdate fix ("","next","quarter") = nextquarter refdate fix ("","last","year") = prevyear refdate fix ("","this","year") = thisyear refdate fix ("","next","year") = nextyear refdate fix ("","",d) = fromGregorian ry rm (read d) fix ("",m,"") = fromGregorian ry (read m) 1 fix ("",m,d) = fromGregorian ry (read m) (read d) fix (y,"","") = fromGregorian (read y) 1 1 fix (y,m,"") = fromGregorian (read y) (read m) 1 fix (y,m,d) = fromGregorian (read y) (read m) (read d) (ry,rm,rd) = toGregorian refdate prevday :: Day -> Day prevday = addDays (-1) nextday = addDays 1 thisweek = startofweek prevweek = startofweek . addDays (-7) nextweek = startofweek . addDays 7 startofweek day = fromMondayStartWeek y w 1 where (y,_,_) = toGregorian day (w,_) = mondayStartWeek day thismonth = startofmonth prevmonth = startofmonth . addGregorianMonthsClip (-1) nextmonth = startofmonth . addGregorianMonthsClip 1 startofmonth day = fromGregorian y m 1 where (y,m,_) = toGregorian day thisquarter = startofquarter prevquarter = startofquarter . addGregorianMonthsClip (-3) nextquarter = startofquarter . addGregorianMonthsClip 3 startofquarter day = fromGregorian y (firstmonthofquarter m) 1 where (y,m,_) = toGregorian day firstmonthofquarter m = ((m-1) `div` 3) * 3 + 1 thisyear = startofyear prevyear = startofyear . addGregorianYearsClip (-1) nextyear = startofyear . addGregorianYearsClip 1 startofyear day = fromGregorian y 1 1 where (y,_,_) = toGregorian day ---------------------------------------------------------------------- -- parsing -- | Parse a date-time string to a time type, or raise an error. parsedatetime :: String -> UTCTime parsedatetime s = parsetimewith "%Y/%m/%d %H:%M:%S" s $ error $ printf "could not parse timestamp \"%s\"" s -- | Parse a date string to a time type, or raise an error. parsedate :: String -> Day parsedate s = parsetimewith "%Y/%m/%d" s $ error $ printf "could not parse date \"%s\"" s -- | Parse a time string to a time type using the provided pattern, or -- return the default. parsetimewith :: ParseTime t => String -> String -> t -> t parsetimewith pat s def = fromMaybe def $ parseTime defaultTimeLocale pat s {-| Parse a date in any of the formats allowed in ledger's period expressions, and maybe some others: > 2004 > 2004/10 > 2004/10/1 > 10/1 > 21 > october, oct > yesterday, today, tomorrow > (not yet) this/next/last week/day/month/quarter/year Returns a SmartDate, to be converted to a full date later (see fixSmartDate). Assumes any text in the parse stream has been lowercased. -} smartdate :: Parser SmartDate smartdate = do let dateparsers = [ymd, ym, md, y, d, month, mon, today', yesterday, tomorrow, lastthisnextthing ] (y,m,d) <- choice $ map try dateparsers return $ (y,m,d) datesepchar = oneOf "/-." ymd :: Parser SmartDate ymd = do y <- many1 digit datesepchar m <- many1 digit guard (read m <= 12) datesepchar d <- many1 digit guard (read d <= 31) return (y,m,d) ym :: Parser SmartDate ym = do y <- many1 digit guard (read y > 12) datesepchar m <- many1 digit guard (read m <= 12) return (y,m,"") y :: Parser SmartDate y = do y <- many1 digit guard (read y >= 1000) return (y,"","") d :: Parser SmartDate d = do d <- many1 digit guard (read d <= 31) return ("","",d) md :: Parser SmartDate md = do m <- many1 digit guard (read m <= 12) datesepchar d <- many1 digit guard (read d <= 31) return ("",m,d) months = ["january","february","march","april","may","june", "july","august","september","october","november","december"] mons = ["jan","feb","mar","apr","may","jun","jul","aug","sep","oct","nov","dec"] monthIndex s = maybe 0 (+1) $ (map toLower s) `elemIndex` months monIndex s = maybe 0 (+1) $ (map toLower s) `elemIndex` mons month :: Parser SmartDate month = do m <- choice $ map (try . string) months let i = monthIndex m return $ ("",show i,"") mon :: Parser SmartDate mon = do m <- choice $ map (try . string) mons let i = monIndex m return ("",show i,"") today',yesterday,tomorrow :: Parser SmartDate today' = string "today" >> return ("","","today") yesterday = string "yesterday" >> return ("","","yesterday") tomorrow = string "tomorrow" >> return ("","","tomorrow") lastthisnextthing :: Parser SmartDate lastthisnextthing = do r <- choice [ string "last" ,string "this" ,string "next" ] --many1 spacenonewline many spacenonewline -- allow the space to be omitted for easier scripting p <- choice [ string "day" ,string "week" ,string "month" ,string "quarter" ,string "year" ] return ("",r,p)