shelving/util/datemodule

import { getDate, requireDate, isDate, assertDate } from "shelving/util";

getDate("now");          // current Date
getDate("today");        // midnight today
getDate("tomorrow");     // midnight tomorrow
getDate("2024-03-15");   // Date at that local date
getDate("18:30");        // today at 18:30
getDate(1710000000000);  // Date from Unix ms timestamp
getDate("not a date");   // undefined

requireDate("2024-03-15"); // Date or throws RequiredError
isDate(new Date("bad"));   // false

import { getDateString, getTimeString, getDateTimeString } from "shelving/util";
import { requireDateString, requireTimeString, requireDateTimeString } from "shelving/util";

getDateString("now");      // "2024-03-15"
getTimeString("now");      // "18:30:00"
getDateTimeString("now");  // "2024-03-15T18:30:00"

// Throwing variants — useful when you know the value is valid:
requireDateString("2024-01-01"); // "2024-01-01"

import { getTimestamp, requireTimestamp } from "shelving/util";

getTimestamp("2024-01-01"); // 1704067200000 (ms since epoch)
requireTimestamp("now");    // current time in ms

import { getNow, getToday, getTomorrow, getYesterday, getMidnight, getMonday, getMonthStart } from "shelving/util";

getNow();              // current moment
getToday();            // midnight today
getMidnight("2024-03-15"); // midnight on that date
getMonday();           // midnight on Monday of current week
getMonthStart();       // midnight on the 1st of current month

import { getDay, DAYS } from "shelving/util";

getDay("2024-03-15"); // "Friday"
DAYS[0];              // "Sunday"

import { addDays, addWeeks, addMonths, addYears, addHours, addMinutes, addSeconds, addMilliseconds } from "shelving/util";

addDays(7, "2024-03-01");    // 2024-03-08
addMonths(1, "2024-01-31");  // 2024-02-29 (leap year) or 2024-02-28
addYears(-1, "2024-02-29");  // 2023-02-28 (clamped, not a leap year)
addHours(2, "now");          // 2 hours from now