module Duckling.Time.Helpers
(
isADayOfWeek, isAMonth, isAnHourOfDay, isAPartOfDay, isATimeOfDay
, isDOMInteger, isDOMOrdinal, isDOMValue, isGrain, isGrainFinerThan
, isGrainOfTime, isIntegerBetween, isNotLatent, isOrdinalBetween
, isMidnightOrNoon, isNumeralSafeToUse
, cycleLastOf, cycleN, cycleNth, cycleNthAfter, dayOfMonth, dayOfWeek
, daysOfWeekOfMonth, durationAfter, durationAgo, durationBefore, form, hour
, hourMinute, hourMinuteSecond, inDuration, intersect, intersectDOM, interval
, inTimezone, longWEBefore, minute, minutesAfter, minutesBefore, mkLatent
, month, monthDay, notLatent, nthDOWOfMonth, partOfDay, predLastOf, predNth
, predNthAfter, second, timeOfDayAMPM, weekend, withDirection, year
, yearMonthDay
, tt
, getIntValue
) where
import Control.Monad (liftM2)
import Data.Maybe
import Data.Text (Text)
import Prelude
import qualified Data.Time as Time
import qualified Data.Time.Calendar.WeekDate as Time
import qualified Data.Time.LocalTime.TimeZone.Series as Series
import Duckling.Dimensions.Types
import Duckling.Duration.Types (DurationData (DurationData))
import Duckling.Ordinal.Types (OrdinalData (OrdinalData))
import Duckling.Time.TimeZone.Parse (parseTimezone)
import Duckling.Time.Types
( TimeData(TimeData)
, mkSeriesPredicate
, mkSecondPredicate
, mkMinutePredicate
, mkHourPredicate
, mkAMPMPredicate
, mkMonthPredicate
, mkDayOfTheWeekPredicate
, mkDayOfTheMonthPredicate
, mkYearPredicate
, mkIntersectPredicate
, mkTimeIntervalsPredicate
, runPredicate
, AMPM(..)
)
import Duckling.Types
import qualified Duckling.Duration.Types as TDuration
import qualified Duckling.Numeral.Types as TNumeral
import qualified Duckling.Ordinal.Types as TOrdinal
import qualified Duckling.Time.Types as TTime
import qualified Duckling.TimeGrain.Types as TG
getIntValue :: Token -> Maybe Int
getIntValue (Token Numeral nd) = TNumeral.getIntValue $ TNumeral.value nd
getIntValue (Token Ordinal OrdinalData {TOrdinal.value = x}) = Just x
getIntValue _ = Nothing
timeNegPeriod :: DurationData -> DurationData
timeNegPeriod (DurationData v g) = DurationData
{TDuration.grain = g, TDuration.value = negate v}
timeCycle :: TG.Grain -> TTime.Predicate
timeCycle grain = mkSeriesPredicate series
where
series t _ = TTime.timeSequence grain 1 $ TTime.timeRound t grain
timeSecond :: Int -> TTime.Predicate
timeSecond n = mkSecondPredicate n
timeMinute :: Int -> TTime.Predicate
timeMinute n = mkMinutePredicate n
timeHour :: Bool -> Int -> TTime.Predicate
timeHour is12H n = mkHourPredicate is12H n
timeDayOfWeek :: Int -> TTime.Predicate
timeDayOfWeek n = mkDayOfTheWeekPredicate n
timeDayOfMonth :: Int -> TTime.Predicate
timeDayOfMonth n = mkDayOfTheMonthPredicate n
timeMonth :: Int -> TTime.Predicate
timeMonth n = mkMonthPredicate n
timeYear :: Int -> TTime.Predicate
timeYear n = mkYearPredicate n
takeN :: Int -> Bool -> TTime.Predicate -> TTime.Predicate
takeN n notImmediate f = mkSeriesPredicate series
where
series t context =
case slot of
Just nth -> if TTime.timeStartsBeforeTheEndOf t nth
then ([], [nth])
else ([nth], [])
Nothing -> ([], [])
where
baseTime = TTime.refTime context
(past, future) = runPredicate f baseTime context
fut = case future of
(ahead:rest)
| notImmediate && isJust (TTime.timeIntersect ahead baseTime) -> rest
_ -> future
slot = if n >= 0
then case fut of
(start:_) -> case drop n fut of
(end:_) -> Just $ TTime.timeInterval TTime.Open start end
_ -> Nothing
_ -> Nothing
else case past of
(end:_) -> case drop (( n) 1) past of
(start:_) -> Just $ TTime.timeInterval TTime.Closed start end
_ -> Nothing
_ -> Nothing
takeNth :: Int -> Bool -> TTime.Predicate -> TTime.Predicate
takeNth n notImmediate f = mkSeriesPredicate series
where
series t context =
case rest of
[] -> ([], [])
(nth:_) -> if TTime.timeStartsBeforeTheEndOf t nth
then ([], [nth])
else ([nth], [])
where
baseTime = TTime.refTime context
(past, future) = runPredicate f baseTime context
rest = if n >= 0
then case future of
(ahead:_) | notImmediate && isJust (TTime.timeIntersect ahead baseTime)
-> drop (n + 1) future
_ -> drop n future
else drop ( (n + 1)) past
takeNthAfter
:: Int
-> Bool
-> TTime.Predicate
-> TTime.Predicate
-> TTime.Predicate
takeNthAfter n notImmediate cyclicPred basePred =
mkSeriesPredicate $! TTime.timeSeqMap False f basePred
where
f t ctx =
let (past, future) = runPredicate cyclicPred t ctx
rest = if n >= 0
then case future of
(ahead:_) | notImmediate && TTime.timeBefore ahead t
-> drop (n + 1) future
_ -> drop n future
else drop ( (n + 1)) past
in case rest of
[] -> Nothing
(nth:_) -> Just nth
takeLastOf :: TTime.Predicate -> TTime.Predicate -> TTime.Predicate
takeLastOf cyclicPred basePred =
mkSeriesPredicate $! TTime.timeSeqMap False f basePred
where
f :: TTime.TimeObject -> TTime.TimeContext -> Maybe TTime.TimeObject
f t ctx =
case runPredicate cyclicPred (TTime.timeStartingAtTheEndOf t) ctx of
(nth:_, _) -> Just nth
_ -> Nothing
timeCompose :: TTime.Predicate -> TTime.Predicate -> TTime.Predicate
timeCompose pred1 pred2 = mkIntersectPredicate pred1 pred2
shiftDuration :: TTime.Predicate -> DurationData -> TTime.Predicate
shiftDuration pred1 (DurationData n g) =
mkSeriesPredicate $! TTime.timeSeqMap False f pred1
where
grain = case g of
TG.Second -> TG.Second
TG.Year -> TG.Month
TG.Month -> TG.Day
_ -> pred g
f x _ = Just $ TTime.timePlus (TTime.timeRound x grain) g $ toInteger n
shiftTimezone :: Series.TimeZoneSeries -> TTime.Predicate -> TTime.Predicate
shiftTimezone providedSeries pred1 =
mkSeriesPredicate $! TTime.timeSeqMap False f pred1
where
f x@(TTime.TimeObject s _ _) ctx =
let Time.TimeZone ctxOffset _ _ =
Series.timeZoneFromSeries (TTime.tzSeries ctx) s
Time.TimeZone providedOffset _ _ =
Series.timeZoneFromSeries providedSeries s
in Just . TTime.timePlus x TG.Minute . toInteger $
ctxOffset providedOffset
isGrain :: TG.Grain -> Predicate
isGrain value (Token TimeGrain grain) = grain == value
isGrain _ _ = False
isGrainFinerThan :: TG.Grain -> Predicate
isGrainFinerThan value (Token Time (TimeData {TTime.timeGrain = g})) = g < value
isGrainFinerThan _ _ = False
isGrainOfTime :: TG.Grain -> Predicate
isGrainOfTime value (Token Time (TimeData {TTime.timeGrain = g})) = g == value
isGrainOfTime _ _ = False
isADayOfWeek :: Predicate
isADayOfWeek (Token Time td) = case TTime.form td of
Just TTime.DayOfWeek -> True
_ -> False
isADayOfWeek _ = False
isATimeOfDay :: Predicate
isATimeOfDay (Token Time td) = case TTime.form td of
Just (TTime.TimeOfDay _ _) -> True
_ -> False
isATimeOfDay _ = False
isAPartOfDay :: Predicate
isAPartOfDay (Token Time td) = case TTime.form td of
Just TTime.PartOfDay -> True
_ -> False
isAPartOfDay _ = False
isAMonth :: Predicate
isAMonth (Token Time td) = case TTime.form td of
Just (TTime.Month _) -> True
_ -> False
isAMonth _ = False
isAnHourOfDay :: Predicate
isAnHourOfDay (Token Time td) = case TTime.form td of
Just (TTime.TimeOfDay (Just _) _) | TTime.timeGrain td > TG.Minute -> True
_ -> False
isAnHourOfDay _ = False
isMidnightOrNoon :: Predicate
isMidnightOrNoon (Token Time td) = case TTime.form td of
Just (TTime.TimeOfDay (Just x) _) -> x == 0 || x == 12
_ -> False
isMidnightOrNoon _ = False
isNotLatent :: Predicate
isNotLatent (Token Time td) = not $ TTime.latent td
isNotLatent _ = False
isIntegerBetween :: Int -> Int -> Predicate
isIntegerBetween low high (Token Numeral nd) =
TNumeral.isIntegerBetween (TNumeral.value nd) low high
isIntegerBetween _ _ _ = False
isNumeralSafeToUse :: Predicate
isNumeralSafeToUse (Token Numeral nd) = TNumeral.okForAnyTime nd
isNumeralSafeToUse _ = False
isOrdinalBetween :: Int -> Int -> Predicate
isOrdinalBetween low high (Token Ordinal od) =
TOrdinal.isBetween (TOrdinal.value od) low high
isOrdinalBetween _ _ _ = False
isDOMOrdinal :: Predicate
isDOMOrdinal = isOrdinalBetween 1 31
isDOMInteger :: Predicate
isDOMInteger = isIntegerBetween 1 31
isDOMValue :: Predicate
isDOMValue = liftM2 (||) isDOMOrdinal isDOMInteger
intersect :: TimeData -> TimeData -> Maybe TimeData
intersect td1 td2 =
case intersect' (td1, td2) of
TTime.TimeData { TTime.timePred = pred }
| TTime.isEmptyPredicate pred -> Nothing
res -> Just res
intersect' :: (TimeData, TimeData) -> TimeData
intersect' (TimeData pred1 _ g1 _ _ d1, TimeData pred2 _ g2 _ _ d2)
| g1 < g2 = TTime.timedata'
{ TTime.timePred = timeCompose pred1 pred2
, TTime.timeGrain = g1
, TTime.direction = dir
}
| otherwise = TTime.timedata'
{ TTime.timePred = timeCompose pred2 pred1
, TTime.timeGrain = g2
, TTime.direction = dir
}
where
dir = case catMaybes [d1, d2] of
[] -> Nothing
(x:_) -> Just x
hour :: Bool -> Int -> TimeData
hour is12H n = timeOfDay (Just n) is12H $ TTime.timedata'
{TTime.timePred = timeHour is12H n, TTime.timeGrain = TG.Hour}
minute :: Int -> TimeData
minute n = TTime.timedata'
{TTime.timePred = timeMinute n, TTime.timeGrain = TG.Minute}
second :: Int -> TimeData
second n = TTime.timedata'
{TTime.timePred = timeSecond n, TTime.timeGrain = TG.Second}
dayOfWeek :: Int -> TimeData
dayOfWeek n = form TTime.DayOfWeek $ TTime.timedata'
{ TTime.timePred = timeDayOfWeek n
, TTime.timeGrain = TG.Day
, TTime.notImmediate = True
}
dayOfMonth :: Int -> TimeData
dayOfMonth n = TTime.timedata'
{TTime.timePred = timeDayOfMonth n, TTime.timeGrain = TG.Day}
month :: Int -> TimeData
month n = form TTime.Month {TTime.month = n} $ TTime.timedata'
{TTime.timePred = timeMonth n, TTime.timeGrain = TG.Month}
year :: Int -> TimeData
year n = TTime.timedata' {TTime.timePred = timeYear n, TTime.timeGrain = TG.Year}
yearMonthDay :: Int -> Int -> Int -> TimeData
yearMonthDay y m d = intersect' (intersect' (year y, month m), dayOfMonth d)
monthDay :: Int -> Int -> TimeData
monthDay m d = intersect' (month m, dayOfMonth d)
hourMinute :: Bool -> Int -> Int -> TimeData
hourMinute is12H h m = timeOfDay (Just h) is12H $
intersect' (hour is12H h, minute m)
hourMinuteSecond :: Bool -> Int -> Int -> Int -> TimeData
hourMinuteSecond is12H h m s = timeOfDay (Just h) is12H $
intersect' (intersect' (hour is12H h, minute m), second s)
cycleN :: Bool -> TG.Grain -> Int -> TimeData
cycleN notImmediate grain n = TTime.timedata'
{ TTime.timePred = takeN n notImmediate $ timeCycle grain
, TTime.timeGrain = grain
}
cycleNth :: TG.Grain -> Int -> TimeData
cycleNth grain n = TTime.timedata'
{TTime.timePred = takeNth n False $ timeCycle grain, TTime.timeGrain = grain}
cycleNthAfter :: Bool -> TG.Grain -> Int -> TimeData -> TimeData
cycleNthAfter notImmediate grain n TimeData {TTime.timePred = p} =
TTime.timedata'
{ TTime.timePred = takeNthAfter n notImmediate (timeCycle grain) p
, TTime.timeGrain = grain
}
cycleLastOf :: TG.Grain -> TimeData -> TimeData
cycleLastOf grain TimeData {TTime.timePred = p} = TTime.timedata'
{ TTime.timePred = takeLastOf (timeCycle grain) p
, TTime.timeGrain = grain
}
predLastOf :: TimeData -> TimeData -> TimeData
predLastOf TimeData {TTime.timePred = cyclicPred, TTime.timeGrain = g} base =
TTime.timedata'
{ TTime.timePred = takeLastOf cyclicPred $ TTime.timePred base
, TTime.timeGrain = g
}
predNth :: Int -> Bool -> TimeData -> TimeData
predNth n notImmediate TimeData {TTime.timePred = p, TTime.timeGrain = g} =
TTime.timedata'
{TTime.timePred = takeNth n notImmediate p, TTime.timeGrain = g}
predNthAfter :: Int -> TimeData -> TimeData -> TimeData
predNthAfter n TimeData {TTime.timePred = p, TTime.timeGrain = g} base =
TTime.timedata'
{ TTime.timePred = takeNthAfter n True p $ TTime.timePred base
, TTime.timeGrain = g
}
interval' :: TTime.TimeIntervalType -> (TimeData, TimeData) -> TimeData
interval' intervalType (TimeData p1 _ g1 _ _ _, TimeData p2 _ g2 _ _ _) =
TTime.timedata'
{ TTime.timePred = mkTimeIntervalsPredicate intervalType' p1 p2
, TTime.timeGrain = min g1 g2
}
where
intervalType'
| g1 == g2 && g1 == TG.Day = TTime.Closed
| otherwise = intervalType
interval :: TTime.TimeIntervalType -> TimeData -> TimeData -> Maybe TimeData
interval intervalType td1 td2 =
case interval' intervalType (td1, td2) of
TTime.TimeData { TTime.timePred = pred }
| TTime.isEmptyPredicate pred -> Nothing
res -> Just res
durationAgo :: DurationData -> TimeData
durationAgo dd = inDuration $ timeNegPeriod dd
durationAfter :: DurationData -> TimeData -> TimeData
durationAfter dd TimeData {TTime.timePred = pred1} = TTime.timedata'
{ TTime.timePred = shiftDuration pred1 dd
, TTime.timeGrain = TDuration.grain dd}
durationBefore :: DurationData -> TimeData -> TimeData
durationBefore dd pred1 = durationAfter (timeNegPeriod dd) pred1
inDuration :: DurationData -> TimeData
inDuration dd = TTime.timedata'
{ TTime.timePred = shiftDuration (takeNth 0 False $ timeCycle TG.Second) dd
, TTime.timeGrain = TDuration.grain dd
}
inTimezone :: Text -> TimeData -> Maybe TimeData
inTimezone input td@TimeData {TTime.timePred = p} = do
tz <- parseTimezone input
Just $ td {TTime.timePred = shiftTimezone (Series.TimeZoneSeries tz []) p}
mkLatent :: TimeData -> TimeData
mkLatent td = td {TTime.latent = True}
notLatent :: TimeData -> TimeData
notLatent td = td {TTime.latent = False}
form :: TTime.Form -> TimeData -> TimeData
form f td = td {TTime.form = Just f}
partOfDay :: TimeData -> TimeData
partOfDay td = form TTime.PartOfDay td
timeOfDay :: Maybe Int -> Bool -> TimeData -> TimeData
timeOfDay h is12H = form TTime.TimeOfDay {TTime.hours = h, TTime.is12H = is12H}
timeOfDayAMPM :: TimeData -> Bool -> TimeData
timeOfDayAMPM tod isAM = timeOfDay Nothing False $ intersect' (tod, ampm)
where
ampm = TTime.timedata'
{ TTime.timePred = ampmPred
, TTime.timeGrain = TG.Hour
}
ampmPred = if isAM then mkAMPMPredicate AM else mkAMPMPredicate PM
withDirection :: TTime.IntervalDirection -> TimeData -> TimeData
withDirection dir td = td {TTime.direction = Just dir}
longWEBefore :: TimeData -> TimeData
longWEBefore monday = interval' TTime.Open (start, end)
where
start = intersect' (fri, hour False 18)
end = intersect' (tue, hour False 0)
fri = cycleNthAfter False TG.Day ( 3) monday
tue = cycleNthAfter False TG.Day 1 monday
weekend :: TimeData
weekend = interval' TTime.Open (fri, mon)
where
fri = intersect' (dayOfWeek 5, hour False 18)
mon = intersect' (dayOfWeek 1, hour False 0)
daysOfWeekOfMonth :: Int -> Int -> TimeData
daysOfWeekOfMonth dow m = intersect' (dayOfWeek dow, month m)
nthDOWOfMonth :: Int -> Int -> Int -> TimeData
nthDOWOfMonth n dow m = intersect' (dowsM, week)
where
dowsM = daysOfWeekOfMonth dow m
week = cycleNthAfter False TG.Week n $ monthDay m 1
intersectDOM :: TimeData -> Token -> Maybe TimeData
intersectDOM td token = do
n <- getIntValue token
intersect (dayOfMonth n) td
minutesBefore :: Int -> TimeData -> Maybe TimeData
minutesBefore n TimeData {TTime.form = Just (TTime.TimeOfDay (Just 0) is12H)} =
Just $ hourMinute is12H 23 (60 n)
minutesBefore n TimeData {TTime.form = Just (TTime.TimeOfDay (Just 1) True)} =
Just $ hourMinute True 12 (60 n)
minutesBefore n TimeData {TTime.form = Just (TTime.TimeOfDay (Just h) is12H)} =
Just $ hourMinute is12H (h 1) (60 n)
minutesBefore _ _ = Nothing
minutesAfter :: Int -> TimeData -> Maybe TimeData
minutesAfter n TimeData {TTime.form = Just (TTime.TimeOfDay (Just h) is12H)} =
Just $ hourMinute is12H h n
minutesAfter _ _ = Nothing
tt :: TimeData -> Maybe Token
tt = Just . Token Time