Date Utilities

import {
  formatDate,
  formatTime,
  formatDateTime,
  formatRelative,
  timeAgo,
  timeUntil,
  extractDate,
  startOfDay,
  endOfDay,
  minDate,
  maxDate,
  isFuture,
  isPast,
  isToday,
  isWithinInterval,
  toDate,
} from "@explita/utils";

import { formatDate } from "@explita/utils";
 
const date = new Date("2024-01-25T14:30:05");
 
formatDate(date); // "25/01/2024" (default pattern: DD/MM/YYYY)
formatDate(date, "YYYY-MM-DD"); // "2024-01-25"
formatDate(date, "MMMM D, YYYY"); // "January 25, 2024"
formatDate(date, "ddd, MMM DD"); // "Thu, Jan 25"
formatDate(date, "[Year:] YYYY"); // "Year: 2024" (brackets escape literals)

import { formatTime } from "@explita/utils";
 
const date = new Date("2024-01-25T14:30:05");
 
formatTime(date); // "02:30PM" (default: hh:mmA)
formatTime(date, "HH:mm:ss"); // "14:30:05" (24-hour)
formatTime(date, "h:mm a"); // "2:30 pm"

import { formatRelative } from "@explita/utils";
 
formatRelative(new Date()); // "Today at 02:30PM"
formatRelative(Date.now() - 86400000); // "Yesterday at 02:30PM"
formatRelative(Date.now() + 86400000); // "Tomorrow at 02:30PM"
formatRelative("2024-01-25T14:30:00"); // "25/01/2024 at 02:30PM"

import { timeAgo } from "@explita/utils";
 
timeAgo(new Date(Date.now() - 10000)); // "a few seconds ago"
timeAgo(Date.now() - 5 * 60 * 1000); // "5 minutes ago"
timeAgo("2024-01-01"); // "X months ago"

import { timeUntil } from "@explita/utils";
 
timeUntil(Date.now() + 10 * 60 * 1000); // "in 10 minutes"
timeUntil(Date.now() + 2 * 3600 * 1000); // "in 2 hours"
timeUntil("2099-01-01"); // "in 75 years"

import { extractDate } from "@explita/utils";
 
extractDate(new Date("2024-01-25T14:30:00")); // "2024-01-25"

import { isFuture, isPast } from "@explita/utils";
 
// Exact timestamp comparison (default: includeTime = true)
isFuture(new Date(Date.now() + 5000)); // true
isPast(new Date(Date.now() - 5000)); // true
 
// Date-only comparison (includeTime = false)
// isFuture treats today as valid until the day ends
isFuture("2099-01-01", false); // true
isPast("2000-01-01", false); // true

import { isToday, isTomorrow, isYesterday } from "@explita/utils";
 
isToday(new Date()); // true
isTomorrow(new Date(Date.now() + 86400000)); // true
isYesterday(new Date(Date.now() - 86400000)); // true

import { isWithinInterval } from "@explita/utils";
 
isWithinInterval("2024-01-15", {
  start: "2024-01-01",
  end: "2024-01-31",
  ignoreTime: true,
}); // true

import { daysBetween, hoursBetween, minutesBetween } from "@explita/utils";
 
daysBetween("2024-01-01", "2024-01-11"); // 10
hoursBetween("2024-01-01T00:00:00", "2024-01-01T05:00:00"); // 5
minutesBetween("2024-01-01T12:00:00", "2024-01-01T12:45:00"); // 45

import { minDate, maxDate } from "@explita/utils";
 
const dates = ["2024-01-01", new Date("2024-06-01"), Date.now()];
 
minDate(dates); // Date object for "2024-01-01"
maxDate(dates); // Date object for latest timestamp
minDate([]); // null

import { startOfDay, endOfDay } from "@explita/utils";
 
const d = new Date("2024-05-15T18:30:00");
 
startOfDay(d); // 2024-05-15 00:00:00.000
endOfDay(d); // 2024-05-15 23:59:59.999

import { shiftDays, shiftMonths, shiftYears, shiftTime } from "@explita/utils";
 
const baseDate = new Date("2024-01-15");
 
shiftDays(baseDate, 5); // 2024-01-20
shiftDays(baseDate, -5); // 2024-01-10
shiftMonths(baseDate, 1); // 2024-02-15
shiftYears(baseDate, 1); // 2025-01-15
 
// Shift multiple units at once
shiftTime({ days: 2, hours: 3 }, baseDate);

import { toDate } from "@explita/utils";
 
toDate("2024-01-25"); // Date instance
toDate(1706189400000); // Date instance
toDate("invalid-string"); // null
toDate(null); // null