+ from_date = formatTime defaultTimeLocale date_format_padded
+
+
+
+-- | Format a number as a string using a comma as the thousands
+-- separator.
+--
+-- Examples:
+--
+-- >>> format_commas 0
+-- "0"
+-- >>> format_commas 10
+-- "10"
+-- >>> format_commas 100
+-- "100"
+-- >>> format_commas 1000
+-- "1,000"
+-- >>> format_commas 10000
+-- "10,000"
+-- >>> format_commas 100000
+-- "100,000"
+-- >>> format_commas 1000000
+-- "1,000,000"
+--
+format_commas :: Int -> String
+format_commas x =
+ reverse (intercalate "," $ chunksOf 3 $ reverse $ show x)
+
+
+-- | Parse \<Earnings\> from an 'AutoRaceResultsListing'. These are
+-- essentially 'Int's, but they look like,
+--
+-- * \<Earnings\>336,826\</Earnings\>
+--
+-- * \<Earnings\>1,000,191\</Earnings\>
+--
+-- * \<Earnings\>TBA\</Earnings\>
+--
+-- Examples:
+--
+-- >>> let tn = text_node "1,000,191"
+-- >>> unpickleDoc xp_earnings tn
+-- Just (Just 1000191)
+--
+-- >>> let tn = text_node "TBA"
+-- >>> unpickleDoc xp_earnings tn
+-- Just Nothing
+--
+xp_earnings :: PU (Maybe Int)
+xp_earnings =
+ (to_earnings, from_earnings) `xpWrap` xpText
+ where
+ strip_commas :: String -> String
+ strip_commas = replace "," ""
+
+ to_earnings :: String -> Maybe Int
+ to_earnings s
+ | s == "TBA" = Nothing
+ | otherwise = Just $ (read . strip_commas) s
+
+ from_earnings :: Maybe Int -> String
+ from_earnings Nothing = "TBA"
+ from_earnings (Just i) = format_commas i
+
+
+
+-- | (Un)pickle an unpadded 'UTCTime'. Used for example on the
+-- \<RaceDate\> elements in an 'AutoRaceResults' message.
+--
+-- Examples:
+--
+-- >>> let tn = text_node "6/1/2014 1:00:00 PM"
+-- >>> unpickleDoc xp_datetime tn
+-- Just 2014-06-01 13:00:00 UTC
+--
+-- >>> let tn = text_node "5/24/2014 2:45:00 PM"
+-- >>> unpickleDoc xp_datetime tn
+-- Just 2014-05-24 14:45:00 UTC
+--
+-- Padded! For some reason it works with only one zero in front. I
+-- dunno man. NOT required (or even desired?) behavior.
+--
+-- >>> let tn = text_node "05/24/2014 2:45:00 PM"
+-- >>> unpickleDoc xp_datetime tn
+-- Just 2014-05-24 14:45:00 UTC
+--
+xp_datetime :: PU UTCTime
+xp_datetime =
+ (to_datetime, from_datetime) `xpWrapMaybe` xpText
+ where
+ format = date_format ++ " " ++ "%-I:%M:%S %p"
+
+ to_datetime :: String -> Maybe UTCTime
+ to_datetime = parseTime defaultTimeLocale format
+
+ from_datetime :: UTCTime -> String
+ from_datetime = formatTime defaultTimeLocale format
+
+
+
+-- | Takes a 'UTCTime', and returns the English suffix that would be
+-- appropriate after the day of the month. For example, if we have a
+-- UTCTime representing Christmas, this would return \"th\" because
+-- \"th\" is the right suffix of \"December 25th\".
+--
+-- Examples:
+--
+-- >>> :{
+-- let parse_date :: String -> Maybe UTCTime;
+-- parse_date = parseTime defaultTimeLocale date_format;
+-- :}
+--
+-- >>> let (Just d1) = parse_date "1/1/1970"
+-- >>> date_suffix d1
+-- "st"
+--
+-- >>> let (Just d2) = parse_date "1/2/1970"
+-- >>> date_suffix d2
+-- "nd"
+--
+-- >>> let (Just d3) = parse_date "1/3/1970"
+-- >>> date_suffix d3
+-- "rd"
+--
+-- >>> let (Just d4) = parse_date "1/4/1970"
+-- >>> date_suffix d4
+-- "th"
+--
+date_suffix :: UTCTime -> String
+date_suffix t =
+ case (reverse daystr) of
+ [] -> []
+ ('1':_) -> "st"
+ ('2':_) -> "nd"
+ ('3':_) -> "rd"
+ _ -> "th"
+ where
+ daystr = formatTime defaultTimeLocale "%d" t
+
+
+-- | (Un)pickle a UTCTime from a weather forecast's gamedate. Example
+-- input looks like,
+--
+-- When unpickling we get rid of the suffixes \"st\", \"nd\", \"rd\", and
+-- \"th\". During pickling, we add them back based on the last digit
+-- of the date.
+--
+-- Examples:
+--
+-- >>> let tn = text_node "Monday, December 30th"
+-- >>> let (Just gd) = unpickleDoc xp_gamedate tn
+-- >>> gd
+-- 1970-12-30 00:00:00 UTC
+-- >>> pickleDoc xp_gamedate gd
+-- NTree (XTag "/" []) [NTree (XText "Wednesday, December 30th") []]
+--
+xp_gamedate :: PU UTCTime
+xp_gamedate =
+ (to_gamedate, from_gamedate) `xpWrapMaybe` xpText
+ where
+ format = "%A, %B %-d"
+
+ to_gamedate :: String -> Maybe UTCTime
+ to_gamedate s =
+ parseTime defaultTimeLocale format s'
+ where
+ s' = case (reverse s) of
+ (c2:c1:cs) -> let suffix = [c1,c2]
+ in
+ if suffix `elem` ["st","nd","rd","th"]
+ then reverse cs
+ else s -- Unknown suffix, leave it alone.
+
+ _ -> s -- The String is less than two characters long,
+ -- leave it alone.
+
+
+ from_gamedate :: UTCTime -> String
+ from_gamedate d = s ++ (date_suffix d)
+ where
+ s = formatTime defaultTimeLocale format d
+
+
+