//! Relative times in the game's wording (`core.cfg`, `years-ago` … `seconds-ago`, `time-future`).
const MINUTE: i64 = 60;
const HOUR: i64 = 60 * MINUTE;
const DAY: i64 = 24 * HOUR;
/// Seconds since the Unix epoch for `2024-10-17T09:30:00.123000Z` (or a space instead of `T`).
/// Offsets other than `Z` are not used by the portal and are rejected.
pub fn parse_timestamp(text: &str) -> Option<i64> {
let (date, time) = text.trim().split_once(['T', ' '])?;
if date.len() != 10 || !date.bytes().all(|b| b.is_ascii_digit() || b == b'-') {
return None;
}
let mut d = date.splitn(3, '-').map(|p| p.parse::<i64>().ok());
let (year, month, day) = (d.next()??, d.next()??, d.next()??);
let time = time.strip_suffix('Z').unwrap_or(time);
let mut t = time.splitn(3, ':');
let hour: i64 = t.next()?.parse().ok()?;
let minute: i64 = t.next()?.parse().ok()?;
let seconds = t.next()?;
let (seconds, fraction) = seconds.split_once('.').unwrap_or((seconds, "0"));
if fraction.is_empty() || !fraction.bytes().all(|b| b.is_ascii_digit()) {
return None;
}
let second: i64 = seconds.parse().ok()?;
let leap = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0);
let days_in_month = match month {
2 => {
if leap {
29
} else {
28
}
}
4 | 6 | 9 | 11 => 30,
1 | 3 | 5 | 7 | 8 | 10 | 12 => 31,
_ => return None,
};
if !(1..=days_in_month).contains(&day)
|| !(0..=23).contains(&hour)
|| !(0..=59).contains(&minute)
|| !(0..=59).contains(&second)
{
return None;
}
// Days from civil (Howard Hinnant's algorithm).
let y = if month <= 2 { year - 1 } else { year };
let era = y.div_euclid(400);
let yoe = y - era * 400;
let doy = (153 * (if month > 2 { month - 3 } else { month + 9 }) + 2) / 5 + day - 1;
let doe = yoe * 365 + yoe / 4 - yoe / 100 + doy;
let days = era * 146097 + doe - 719468;
Some(days * DAY + hour * HOUR + minute * MINUTE + second)
}
/// One unit, rounded down: "5 minutes ago", "1 hour ago", "2 weeks ago", "1 year ago".
pub fn relative_time(now: i64, then: i64) -> String {
let elapsed = now.saturating_sub(then);
if elapsed < 0 {
return "In the future".into();
}
let (count, unit) = if elapsed >= 365 * DAY {
(elapsed / (365 * DAY), "year")
} else if elapsed >= 30 * DAY {
((elapsed / (30 * DAY)).min(11), "month")
} else if elapsed >= 7 * DAY {
(elapsed / (7 * DAY), "week")
} else if elapsed >= DAY {
(elapsed / DAY, "day")
} else if elapsed >= HOUR {
(elapsed / HOUR, "hour")
} else if elapsed >= MINUTE {
(elapsed / MINUTE, "minute")
} else {
(elapsed.max(1), "second")
};
format!("{count} {unit}{} ago", if count == 1 { "" } else { "s" })
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn parses_portal_timestamps() {
assert_eq!(parse_timestamp("1970-01-01T00:00:00Z"), Some(0));
assert_eq!(
parse_timestamp("2000-03-01T00:00:00.000Z"),
Some(951_868_800)
);
assert_eq!(
parse_timestamp("2024-10-17T09:30:00.123000Z"),
Some(1_729_157_400)
);
assert_eq!(parse_timestamp("2024-10-17 09:30:00"), Some(1_729_157_400));
assert_eq!(parse_timestamp("1969-12-31T23:59:59Z"), Some(-1));
assert_eq!(parse_timestamp(""), None);
assert_eq!(parse_timestamp("2024-13-01T00:00:00Z"), None);
assert_eq!(parse_timestamp("2024-10-17"), None);
assert!(parse_timestamp("2024-02-29T12:30:00Z").is_some());
for invalid in [
"2023-02-29T00:00:00Z",
"2024-04-31T00:00:00Z",
"2024-00-01T00:00:00Z",
"2024-01-00T00:00:00Z",
"2024-01-01T-1:00:00Z",
"2024-01-01T24:00:00Z",
"2024-01-01T00:-1:00Z",
"2024-01-01T00:60:00Z",
"2024-01-01T00:00:-1Z",
"2024-01-01T00:00:60Z",
"2024-01-01T00:00:00.abcZ",
"2024-01-01T00:00:00+01:00",
] {
assert_eq!(parse_timestamp(invalid), None, "{invalid}");
}
}
#[test]
fn rounds_down_to_one_unit_in_the_game_wording() {
let ago = |s: i64| relative_time(10_000_000_000, 10_000_000_000 - s);
assert_eq!(ago(0), "1 second ago");
assert_eq!(ago(59), "59 seconds ago");
assert_eq!(ago(60), "1 minute ago");
assert_eq!(ago(5 * 60 + 59), "5 minutes ago");
assert_eq!(ago(HOUR), "1 hour ago");
assert_eq!(ago(23 * HOUR + 3599), "23 hours ago");
assert_eq!(ago(DAY), "1 day ago");
assert_eq!(ago(6 * DAY), "6 days ago");
assert_eq!(ago(7 * DAY), "1 week ago");
assert_eq!(ago(29 * DAY), "4 weeks ago");
assert_eq!(ago(30 * DAY), "1 month ago");
assert_eq!(ago(75 * DAY), "2 months ago");
assert_eq!(ago(364 * DAY), "11 months ago");
assert_eq!(ago(365 * DAY), "1 year ago");
assert_eq!(ago(800 * DAY), "2 years ago");
assert_eq!(ago(-5), "In the future");
assert_eq!(relative_time(i64::MIN, i64::MAX), "In the future");
assert!(relative_time(i64::MAX, i64::MIN).ends_with("years ago"));
}
}