Swift Scheduling
Turn a delivery promise made at a meeting, such as “ASAP”, “EOW”, “11M” or “Q3”, into the date and time the delivery is due.
Adapted from Exercism’s problem specification (MIT). Listed under Dates & Time.
// FILE: swift_scheduling.nomi
//# The delivery date a description such as `NOW`, `EOW` or `2Q` stands for.
import std::calendar.{Date, Days, Hours, Months, NaiveDateTime, Weekday}
/// A delivery date description: one of the three fixed words, or the N-th
/// month or quarter.
enum Description
Now
Asap
EndOfWeek
Month Int
Quarter Int
end
/// Why a description gives no delivery date.
pub enum Error
UnknownDescription String
end
/// When a delivery promised at a meeting that started at `meeting_start` is
/// due, by its `description`: `NOW`, `ASAP`, `EOW`, `<N>M` for a month from
/// 1 to 12 or `Q<N>` for a quarter from 1 to 4.
pub fn delivery_date(
meeting_start: NaiveDateTime,
description: String,
) -> Result<NaiveDateTime, Error>
today = NaiveDateTime.to_date(meeting_start)
year = Date.year(today)
case parse(description)?
.Now ->
Ok(meeting_start + Hours(2))
.Asap when NaiveDateTime.hour(meeting_start) < 13 ->
Ok(at(today, 17))
.Asap ->
Ok(at(today + Days(1), 13))
.EndOfWeek ->
Ok(end_of_week(today))
.Month(month) ->
due_year = if Date.month(today) < month then
year
else
year + 1
end
Ok(at(first_workday(due_year, month), 8))
.Quarter(quarter) ->
due_year = if Date.month(today) |> quarter_of() <= quarter then
year
else
year + 1
end
Ok(at(last_workday_of_quarter(due_year, quarter), 8))
end
end
/// The description `text` names, or `UnknownDescription`.
fn parse(text: String) -> Result<Description, Error>
case text
"NOW" -> Ok(.Now)
"ASAP" -> Ok(.Asap)
"EOW" -> Ok(.EndOfWeek)
_ -> numbered(text) |> Maybe.to_result(.UnknownDescription(text))
end
end
/// `<N>M` for a month from 1 to 12, or `Q<N>` for a quarter from 1 to 4.
fn numbered(text: String) -> Maybe<Description>
month = String.strip_suffix(text, "M") |> Maybe.flat_map(String.to_int)
quarter = String.strip_prefix(text, "Q") |> Maybe.flat_map(String.to_int)
case (month, quarter)
(Some(n), _) when n in 1..=12 -> Some(.Month(n))
(_, Some(n)) when n in 1..=4 -> Some(.Quarter(n))
_ -> None
end
end
/// Friday at 17:00 for a meeting from Monday to Wednesday, and Sunday at
/// 20:00 for one later in the week.
fn end_of_week(today: Date) -> NaiveDateTime
case Date.weekday(today)
.Monday or .Tuesday or .Wednesday -> at(next_on(today, .Friday), 17)
.Thursday or .Friday or .Saturday or .Sunday -> at(next_on(today, .Sunday), 20)
end
end
/// The first day from `day` on, `day` included, that falls on `weekday`.
fn next_on(day: Date, weekday: Weekday) -> Date
Some(found) =
0..7
|> Iter.map(&(day + Days(&1)))
|> Iter.find(&(Date.weekday(&1) == weekday))
else
unreachable "seven days in a row fall on every weekday"
end
found
end
/// The first Monday to Friday of `month` in `year`.
fn first_workday(year: Int, month: Int) -> Date
first = Date.new(year, month, 1)!
Some(found) =
0..7
|> Iter.map(&(first + Days(&1)))
|> Iter.find(is_workday)
else
unreachable "seven days in a row hold five workdays"
end
found
end
/// The last Monday to Friday of `quarter` in `year`.
fn last_workday_of_quarter(year: Int, quarter: Int) -> Date
last_month = Date.new(year, quarter * 3, 1)!
last_day = last_month + Months(1) - Days(1)
Some(found) =
0..7
|> Iter.map(&(last_day - Days(&1)))
|> Iter.find(is_workday)
else
unreachable "seven days in a row hold five workdays"
end
found
end
fn is_workday(day: Date) -> Bool
not Date.weekday(day) is (.Saturday or .Sunday)
end
/// The quarter, 1 to 4, that `month` falls in.
fn quarter_of(month: Int) -> Int
(month - 1) / 3 + 1
end
/// `day` at `hour` o'clock.
fn at(day: Date, hour: Int) -> NaiveDateTime
NaiveDateTime.at_midnight(day) + Hours(hour)
end
// FILE: swift_scheduling_test.nomi
import
std::calendar.NaiveDateTime
swift_scheduling
end
test "delivery date"
[
(
"NOW translates to two hours later",
NaiveDateTime"2012-02-13T09:00:00",
"NOW",
NaiveDateTime"2012-02-13T11:00:00",
),
(
"ASAP before one in the afternoon translates to today at five in the afternoon",
NaiveDateTime"1999-06-03T09:45:00",
"ASAP",
NaiveDateTime"1999-06-03T17:00:00",
),
(
"ASAP at one in the afternoon translates to tomorrow at one in the afternoon",
NaiveDateTime"2008-12-21T13:00:00",
"ASAP",
NaiveDateTime"2008-12-22T13:00:00",
),
(
"ASAP after one in the afternoon translates to tomorrow at one in the afternoon",
NaiveDateTime"2008-12-21T14:50:00",
"ASAP",
NaiveDateTime"2008-12-22T13:00:00",
),
(
"EOW on Monday translates to Friday at five in the afternoon",
NaiveDateTime"2025-02-03T16:00:00",
"EOW",
NaiveDateTime"2025-02-07T17:00:00",
),
(
"EOW on Tuesday translates to Friday at five in the afternoon",
NaiveDateTime"1997-04-29T10:50:00",
"EOW",
NaiveDateTime"1997-05-02T17:00:00",
),
(
"EOW on Wednesday translates to Friday at five in the afternoon",
NaiveDateTime"2005-09-14T11:00:00",
"EOW",
NaiveDateTime"2005-09-16T17:00:00",
),
(
"EOW on Thursday translates to Sunday at eight in the evening",
NaiveDateTime"2011-05-19T08:30:00",
"EOW",
NaiveDateTime"2011-05-22T20:00:00",
),
(
"EOW on Friday translates to Sunday at eight in the evening",
NaiveDateTime"2022-08-05T14:00:00",
"EOW",
NaiveDateTime"2022-08-07T20:00:00",
),
(
"EOW translates to leap day",
NaiveDateTime"2008-02-25T10:30:00",
"EOW",
NaiveDateTime"2008-02-29T17:00:00",
),
(
"2M before the second month of this year translates to the first workday of the second month of this year",
NaiveDateTime"2007-01-02T14:15:00",
"2M",
NaiveDateTime"2007-02-01T08:00:00",
),
(
"11M in the eleventh month translates to the first workday of the eleventh month of next year",
NaiveDateTime"2013-11-21T15:30:00",
"11M",
NaiveDateTime"2014-11-03T08:00:00",
),
(
"4M in the ninth month translates to the first workday of the fourth month of next year",
NaiveDateTime"2019-11-18T15:15:00",
"4M",
NaiveDateTime"2020-04-01T08:00:00",
),
(
"Q1 in the first quarter translates to the last workday of the first quarter of this year",
NaiveDateTime"2003-01-01T10:45:00",
"Q1",
NaiveDateTime"2003-03-31T08:00:00",
),
(
"Q4 in the second quarter translates to the last workday of the fourth quarter of this year",
NaiveDateTime"2001-04-09T09:00:00",
"Q4",
NaiveDateTime"2001-12-31T08:00:00",
),
(
"Q3 in the fourth quarter translates to the last workday of the third quarter of next year",
NaiveDateTime"2022-10-06T11:00:00",
"Q3",
NaiveDateTime"2023-09-29T08:00:00",
),
(
"Q2 starting in the last month of the second quarter translates to the last workday of the second quarter of this year",
NaiveDateTime"2019-06-15T09:50:00",
"Q2",
NaiveDateTime"2019-06-28T08:00:00",
),
]
|> subtests (description, meeting_start, text, expected), description
assert swift_scheduling.delivery_date(meeting_start, text) == Ok(expected)
end
end
test "descriptions that name no delivery date"
meeting_start = NaiveDateTime"2012-02-13T09:00:00"
subtests ["LATER", "0M", "13M", "Q5", "Q", "M"], text
assert swift_scheduling.delivery_date(meeting_start, text) == Err(.UnknownDescription(text))
end
endok delivery date (17 cases)
ok descriptions that name no delivery date (6 cases)
test result: ok. 23 passed, 0 failed
How it’s written
Section titled “How it’s written”- The meeting start and the answer are std/calendar
NaiveDateTimes, the canonical data’s dates with no zone, and the expected values areNaiveDateTime"..."literals, so the table compares datetimes, not strings. - The description is parsed once into a private enum,
Description, with the three fixed words and the two numbered forms,Month(n)andQuarter(n);delivery_dateis then onecaseover it, with awhenguard for ASAP before 13:00. A number out of range or any other text isError.UnknownDescription, which the canonical data never gives; the test file adds six such cases. numberedreads both numbered forms at once,strip_suffix“M” andstrip_prefix“Q” each thenString.to_int, and onecaseover the pair with range guards picks the form.- Every date step is calendar arithmetic,
Days,HoursandMonthsadded to aDateorNaiveDateTime, so month lengths and leap days (the canonical “EOW translates to leap day”) are the calendar’s business. A quarter’s last day is the first of its last month, plus a month, less a day. - The first or last workday is
Iter.findover seven days in a row from the month’s first day or the quarter’s last, and the end of the week is the next Friday or Sunday found the same way. Seven days in a row hold every weekday, so eachNoneis anunreachablethat says so. - The canonical data gives meetings from Monday to Friday only; a Saturday or Sunday meeting’s EOW is that week’s Sunday at 20:00, the later rule’s answer.