@catbee/utils 0.0.8-rc.0 → 0.0.8-rc.2

package/build/esnext/utils/date.utils.js

@@ -1,384 +0,0 @@
-/*
- * The MIT License
- *
- * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-/**
- * Format a date according to the specified format pattern.
- *
- * @param date - Date to format
- * @param options - Formatting options
- * @returns Formatted date string
- *
- * @example
- * ```typescript
- * // Format as ISO date
- * formatDate(new Date(), { format: 'yyyy-MM-dd' }); // '2023-05-15'
- *
- * // Format with time
- * formatDate(new Date(), { format: 'yyyy-MM-dd HH:mm:ss' }); // '2023-05-15 14:30:22'
- *
- * // Format with locale
- * formatDate(new Date(), { format: 'PPPP', locale: 'fr-FR' }); // 'lundi 15 mai 2023'
- * ```
- */
-export function formatDate(date, options = {}) {
-    const { format = 'yyyy-MM-dd', locale, timeZone } = options;
-    const d = date instanceof Date ? date : new Date(date);
-    // Custom formatter for common patterns
-    if (format === 'yyyy-MM-dd') {
-        const yyyy = d.getFullYear();
-        const mm = String(d.getMonth() + 1).padStart(2, '0');
-        const dd = String(d.getDate()).padStart(2, '0');
-        return `${yyyy}-${mm}-${dd}`;
-    }
-    if (format === 'yyyy-MM-dd HH:mm:ss') {
-        const yyyy = d.getFullYear();
-        const mm = String(d.getMonth() + 1).padStart(2, '0');
-        const dd = String(d.getDate()).padStart(2, '0');
-        const HH = String(d.getHours()).padStart(2, '0');
-        const MM = String(d.getMinutes()).padStart(2, '0');
-        const SS = String(d.getSeconds()).padStart(2, '0');
-        return `${yyyy}-${mm}-${dd} ${HH}:${MM}:${SS}`;
-    }
-    if (format === 'relative') {
-        return formatRelativeTime(date);
-    }
-    // Fallback to Intl.DateTimeFormat for other formats
-    return new Intl.DateTimeFormat(locale, {
-        timeZone,
-        year: format.includes('yyyy') || format.includes('y') ? 'numeric' : undefined,
-        month: format.includes('MM') || format.includes('M') ? 'numeric' : undefined,
-        day: format.includes('dd') || format.includes('d') ? 'numeric' : undefined,
-        hour: format.includes('HH') || format.includes('H') ? 'numeric' : undefined,
-        minute: format.includes('mm') || format.includes('m') ? 'numeric' : undefined,
-        second: format.includes('ss') || format.includes('s') ? 'numeric' : undefined,
-        hour12: !format.includes('HH') && !format.includes('H')
-    }).format(d);
-}
-/**
- * Format a date as relative time (e.g., "5 minutes ago", "in 3 days").
- *
- * @param date - Date to format
- * @param now - Reference date (default: current time)
- * @param locale - Locale to use for formatting
- * @returns Formatted relative time string
- */
-export function formatRelativeTime(date, now = new Date(), locale) {
-    const d1 = date instanceof Date ? date : new Date(date);
-    const d2 = now instanceof Date ? now : new Date(now);
-    const diffMs = d1.getTime() - d2.getTime();
-    const diffSecs = Math.round(diffMs / 1000);
-    const diffMins = Math.round(diffSecs / 60);
-    const diffHours = Math.round(diffMins / 60);
-    const diffDays = Math.round(diffHours / 24);
-    const diffMonths = Math.round(diffDays / 30);
-    const diffYears = Math.round(diffDays / 365);
-    const formatter = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
-    if (Math.abs(diffSecs) < 60)
-        return formatter.format(diffSecs, 'second');
-    if (Math.abs(diffMins) < 60)
-        return formatter.format(diffMins, 'minute');
-    if (Math.abs(diffHours) < 24)
-        return formatter.format(diffHours, 'hour');
-    if (Math.abs(diffDays) < 30)
-        return formatter.format(diffDays, 'day');
-    if (Math.abs(diffMonths) < 12)
-        return formatter.format(diffMonths, 'month');
-    return formatter.format(diffYears, 'year');
-}
-/**
- * Parse a date string or timestamp into a Date object.
- *
- * @param input - Date string or timestamp to parse
- * @param fallback - Fallback date if parsing fails
- * @returns Parsed Date object or fallback
- *
- * @example
- * ```typescript
- * parseDate('2023-05-15'); // Date object for May 15, 2023
- * parseDate('invalid', new Date()); // Returns current date as fallback
- * ```
- */
-export function parseDate(input, fallback) {
-    if (typeof input === 'number') {
-        return new Date(input);
-    }
-    try {
-        const date = new Date(input);
-        // Check if date is valid
-        if (isNaN(date.getTime())) {
-            return fallback || null;
-        }
-        return date;
-    }
-    catch (_a) {
-        return fallback || null;
-    }
-}
-/**
- * Calculate the difference between two dates in the specified unit.
- *
- * @param date1 - First date
- * @param date2 - Second date (default: current time)
- * @param unit - Unit of time for the difference
- * @returns Difference in the specified unit
- *
- * @example
- * ```typescript
- * // Get difference in days
- * dateDiff(new Date('2023-05-15'), new Date('2023-05-10'), 'days'); // 5
- *
- * // Get difference in hours
- * dateDiff(new Date('2023-05-15T10:00:00'), new Date('2023-05-15T06:00:00'), 'hours'); // 4
- * ```
- */
-export function dateDiff(date1, date2 = new Date(), unit = 'days') {
-    const d1 = date1 instanceof Date ? date1 : new Date(date1);
-    const d2 = date2 instanceof Date ? date2 : new Date(date2);
-    const diffMs = d1.getTime() - d2.getTime();
-    switch (unit) {
-        case 'milliseconds':
-            return diffMs;
-        case 'seconds':
-            return diffMs / 1000;
-        case 'minutes':
-            return diffMs / (1000 * 60);
-        case 'hours':
-            return diffMs / (1000 * 60 * 60);
-        case 'days':
-            return diffMs / (1000 * 60 * 60 * 24);
-        case 'months':
-            return (d1.getFullYear() - d2.getFullYear()) * 12 + d1.getMonth() - d2.getMonth();
-        case 'years':
-            return d1.getFullYear() - d2.getFullYear();
-        default:
-            throw new Error(`Unsupported unit: ${unit}`);
-    }
-}
-/**
- * Add a specified amount of time to a date.
- *
- * @param date - Base date
- * @param amount - Amount to add (can be negative)
- * @param unit - Unit of time to add
- * @returns New date with the addition
- *
- * @example
- * ```typescript
- * // Add 5 days
- * addToDate(new Date('2023-05-15'), 5, 'days'); // Date for May 20, 2023
- *
- * // Subtract 2 hours
- * addToDate(new Date('2023-05-15T10:00:00'), -2, 'hours'); // Date for May 15, 2023 08:00:00
- * ```
- */
-export function addToDate(date, amount, unit) {
-    const d = date instanceof Date ? new Date(date) : new Date(date);
-    switch (unit) {
-        case 'milliseconds':
-            d.setMilliseconds(d.getMilliseconds() + amount);
-            break;
-        case 'seconds':
-            d.setSeconds(d.getSeconds() + amount);
-            break;
-        case 'minutes':
-            d.setMinutes(d.getMinutes() + amount);
-            break;
-        case 'hours':
-            d.setHours(d.getHours() + amount);
-            break;
-        case 'days':
-            d.setDate(d.getDate() + amount);
-            break;
-        case 'months': {
-            const origDate = d.getDate();
-            const origMonth = d.getMonth();
-            d.setDate(1); // Prevent overflow
-            d.setMonth(origMonth + amount);
-            const lastDay = new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();
-            d.setDate(Math.min(origDate, lastDay));
-            break;
-        }
-        case 'years':
-            d.setFullYear(d.getFullYear() + amount);
-            break;
-        default:
-            throw new Error(`Unsupported unit: ${unit}`);
-    }
-    return d;
-}
-/**
- * Get the start of a time period containing the specified date.
- *
- * @param date - Date to get the start from
- * @param unit - Time unit
- * @returns Date object representing the start of the time unit
- *
- * @example
- * ```typescript
- * // Get start of day (midnight)
- * startOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 00:00:00
- *
- * // Get start of month
- * startOf(new Date('2023-05-15'), 'month'); // Date for May 1, 2023
- * ```
- */
-export function startOf(date, unit) {
-    const d = date instanceof Date ? new Date(date) : new Date(date);
-    switch (unit) {
-        case 'second':
-            d.setMilliseconds(0);
-            break;
-        case 'minute':
-            d.setSeconds(0, 0);
-            break;
-        case 'hour':
-            d.setMinutes(0, 0, 0);
-            break;
-        case 'day':
-            d.setHours(0, 0, 0, 0);
-            break;
-        case 'week':
-            d.setHours(0, 0, 0, 0);
-            d.setDate(d.getDate() - d.getDay());
-            break;
-        case 'month':
-            d.setDate(1);
-            d.setHours(0, 0, 0, 0);
-            break;
-        case 'quarter':
-            d.setMonth(Math.floor(d.getMonth() / 3) * 3, 1);
-            d.setHours(0, 0, 0, 0);
-            break;
-        case 'year':
-            d.setMonth(0, 1);
-            d.setHours(0, 0, 0, 0);
-            break;
-        default:
-            throw new Error(`Unsupported unit: ${unit}`);
-    }
-    return d;
-}
-/**
- * Get the end of a time period containing the specified date.
- *
- * @param date - Date to get the end from
- * @param unit - Time unit
- * @returns Date object representing the end of the time unit
- *
- * @example
- * ```typescript
- * // Get end of day (23:59:59.999)
- * endOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 23:59:59.999
- *
- * // Get end of month
- * endOf(new Date('2023-05-15'), 'month'); // Date for May 31, 2023 23:59:59.999
- * ```
- */
-export function endOf(date, unit) {
-    const d = date instanceof Date ? new Date(date) : new Date(date);
-    switch (unit) {
-        case 'second':
-            d.setMilliseconds(999);
-            break;
-        case 'minute':
-            d.setSeconds(59, 999);
-            break;
-        case 'hour':
-            d.setMinutes(59, 59, 999);
-            break;
-        case 'day':
-            d.setHours(23, 59, 59, 999);
-            break;
-        case 'week':
-            d.setDate(d.getDate() - d.getDay() + 6);
-            d.setHours(23, 59, 59, 999);
-            break;
-        case 'month':
-            d.setMonth(d.getMonth() + 1, 0);
-            d.setHours(23, 59, 59, 999);
-            break;
-        case 'quarter':
-            d.setMonth(Math.floor(d.getMonth() / 3) * 3 + 3, 0);
-            d.setHours(23, 59, 59, 999);
-            break;
-        case 'year':
-            d.setMonth(11, 31);
-            d.setHours(23, 59, 59, 999);
-            break;
-        default:
-            throw new Error(`Unsupported unit: ${unit}`);
-    }
-    return d;
-}
-/**
- * Check if a date is between two other dates.
- *
- * @param date - Date to check
- * @param start - Start date of the range
- * @param end - End date of the range
- * @param inclusive - Whether the comparison should be inclusive of start/end
- * @returns True if the date is within the range
- *
- * @example
- * ```typescript
- * const date = new Date('2023-05-15');
- * const start = new Date('2023-05-10');
- * const end = new Date('2023-05-20');
- *
- * isBetween(date, start, end); // true
- * ```
- */
-export function isBetween(date, start, end, inclusive = true) {
-    const d = date instanceof Date ? date.getTime() : date;
-    const s = start instanceof Date ? start.getTime() : start;
-    const e = end instanceof Date ? end.getTime() : end;
-    return inclusive ? d >= s && d <= e : d > s && d < e;
-}
-/**
- * Check if a year is a leap year.
- *
- * @param year - Year to check (or date object)
- * @returns True if the year is a leap year
- */
-export function isLeapYear(year) {
-    const y = year instanceof Date ? year.getFullYear() : year;
-    return (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;
-}
-/**
- * Get the number of days in a month.
- *
- * @param year - Year
- * @param month - Month (0-11)
- * @returns Number of days in the month
- */
-export function daysInMonth(year, month) {
-    if (year instanceof Date) {
-        month = year.getMonth();
-        year = year.getFullYear();
-    }
-    if (month === undefined) {
-        throw new Error('Month is required when year is a number');
-    }
-    return new Date(year, month + 1, 0).getDate();
-}
-//# sourceMappingURL=date.utils.js.map

package/build/esnext/utils/date.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"date.utils.js","sourceRoot":"","sources":["../../../src/utils/date.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The MIT License\n *\n * Copyright (c) 2025 Catbee Technologies. https://catbee-utils.npm.hprasath.com/license\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Format options for the formatDate function\n */\nexport interface DateFormatOptions {\n  /** Date format pattern (default: 'yyyy-MM-dd') */\n  format?: string;\n  /** Locale to use for formatting (default: system locale) */\n  locale?: string | string[];\n  /** Time zone to use (default: system time zone) */\n  timeZone?: string;\n}\n\n/**\n * Format a date according to the specified format pattern.\n *\n * @param date - Date to format\n * @param options - Formatting options\n * @returns Formatted date string\n *\n * @example\n * ```typescript\n * // Format as ISO date\n * formatDate(new Date(), { format: 'yyyy-MM-dd' }); // '2023-05-15'\n *\n * // Format with time\n * formatDate(new Date(), { format: 'yyyy-MM-dd HH:mm:ss' }); // '2023-05-15 14:30:22'\n *\n * // Format with locale\n * formatDate(new Date(), { format: 'PPPP', locale: 'fr-FR' }); // 'lundi 15 mai 2023'\n * ```\n */\nexport function formatDate(date: Date | number, options: DateFormatOptions = {}): string {\n  const { format = 'yyyy-MM-dd', locale, timeZone } = options;\n  const d = date instanceof Date ? date : new Date(date);\n\n  // Custom formatter for common patterns\n  if (format === 'yyyy-MM-dd') {\n    const yyyy = d.getFullYear();\n    const mm = String(d.getMonth() + 1).padStart(2, '0');\n    const dd = String(d.getDate()).padStart(2, '0');\n    return `${yyyy}-${mm}-${dd}`;\n  }\n  if (format === 'yyyy-MM-dd HH:mm:ss') {\n    const yyyy = d.getFullYear();\n    const mm = String(d.getMonth() + 1).padStart(2, '0');\n    const dd = String(d.getDate()).padStart(2, '0');\n    const HH = String(d.getHours()).padStart(2, '0');\n    const MM = String(d.getMinutes()).padStart(2, '0');\n    const SS = String(d.getSeconds()).padStart(2, '0');\n    return `${yyyy}-${mm}-${dd} ${HH}:${MM}:${SS}`;\n  }\n  if (format === 'relative') {\n    return formatRelativeTime(date);\n  }\n\n  // Fallback to Intl.DateTimeFormat for other formats\n  return new Intl.DateTimeFormat(locale, {\n    timeZone,\n    year: format.includes('yyyy') || format.includes('y') ? 'numeric' : undefined,\n    month: format.includes('MM') || format.includes('M') ? 'numeric' : undefined,\n    day: format.includes('dd') || format.includes('d') ? 'numeric' : undefined,\n    hour: format.includes('HH') || format.includes('H') ? 'numeric' : undefined,\n    minute: format.includes('mm') || format.includes('m') ? 'numeric' : undefined,\n    second: format.includes('ss') || format.includes('s') ? 'numeric' : undefined,\n    hour12: !format.includes('HH') && !format.includes('H')\n  }).format(d);\n}\n\n/**\n * Format a date as relative time (e.g., \"5 minutes ago\", \"in 3 days\").\n *\n * @param date - Date to format\n * @param now - Reference date (default: current time)\n * @param locale - Locale to use for formatting\n * @returns Formatted relative time string\n */\nexport function formatRelativeTime(\n  date: Date | number,\n  now: Date | number = new Date(),\n  locale?: string | string[]\n): string {\n  const d1 = date instanceof Date ? date : new Date(date);\n  const d2 = now instanceof Date ? now : new Date(now);\n\n  const diffMs = d1.getTime() - d2.getTime();\n  const diffSecs = Math.round(diffMs / 1000);\n  const diffMins = Math.round(diffSecs / 60);\n  const diffHours = Math.round(diffMins / 60);\n  const diffDays = Math.round(diffHours / 24);\n  const diffMonths = Math.round(diffDays / 30);\n  const diffYears = Math.round(diffDays / 365);\n\n  const formatter = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n\n  if (Math.abs(diffSecs) < 60) return formatter.format(diffSecs, 'second');\n  if (Math.abs(diffMins) < 60) return formatter.format(diffMins, 'minute');\n  if (Math.abs(diffHours) < 24) return formatter.format(diffHours, 'hour');\n  if (Math.abs(diffDays) < 30) return formatter.format(diffDays, 'day');\n  if (Math.abs(diffMonths) < 12) return formatter.format(diffMonths, 'month');\n  return formatter.format(diffYears, 'year');\n}\n\n/**\n * Parse a date string or timestamp into a Date object.\n *\n * @param input - Date string or timestamp to parse\n * @param fallback - Fallback date if parsing fails\n * @returns Parsed Date object or fallback\n *\n * @example\n * ```typescript\n * parseDate('2023-05-15'); // Date object for May 15, 2023\n * parseDate('invalid', new Date()); // Returns current date as fallback\n * ```\n */\nexport function parseDate(input: string | number, fallback?: Date): Date | null {\n  if (typeof input === 'number') {\n    return new Date(input);\n  }\n\n  try {\n    const date = new Date(input);\n    // Check if date is valid\n    if (isNaN(date.getTime())) {\n      return fallback || null;\n    }\n    return date;\n  } catch {\n    return fallback || null;\n  }\n}\n\n/**\n * Calculate the difference between two dates in the specified unit.\n *\n * @param date1 - First date\n * @param date2 - Second date (default: current time)\n * @param unit - Unit of time for the difference\n * @returns Difference in the specified unit\n *\n * @example\n * ```typescript\n * // Get difference in days\n * dateDiff(new Date('2023-05-15'), new Date('2023-05-10'), 'days'); // 5\n *\n * // Get difference in hours\n * dateDiff(new Date('2023-05-15T10:00:00'), new Date('2023-05-15T06:00:00'), 'hours'); // 4\n * ```\n */\nexport function dateDiff(\n  date1: Date | number,\n  date2: Date | number = new Date(),\n  unit: 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years' = 'days'\n): number {\n  const d1 = date1 instanceof Date ? date1 : new Date(date1);\n  const d2 = date2 instanceof Date ? date2 : new Date(date2);\n\n  const diffMs = d1.getTime() - d2.getTime();\n\n  switch (unit) {\n    case 'milliseconds':\n      return diffMs;\n    case 'seconds':\n      return diffMs / 1000;\n    case 'minutes':\n      return diffMs / (1000 * 60);\n    case 'hours':\n      return diffMs / (1000 * 60 * 60);\n    case 'days':\n      return diffMs / (1000 * 60 * 60 * 24);\n    case 'months':\n      return (d1.getFullYear() - d2.getFullYear()) * 12 + d1.getMonth() - d2.getMonth();\n    case 'years':\n      return d1.getFullYear() - d2.getFullYear();\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n}\n\n/**\n * Add a specified amount of time to a date.\n *\n * @param date - Base date\n * @param amount - Amount to add (can be negative)\n * @param unit - Unit of time to add\n * @returns New date with the addition\n *\n * @example\n * ```typescript\n * // Add 5 days\n * addToDate(new Date('2023-05-15'), 5, 'days'); // Date for May 20, 2023\n *\n * // Subtract 2 hours\n * addToDate(new Date('2023-05-15T10:00:00'), -2, 'hours'); // Date for May 15, 2023 08:00:00\n * ```\n */\nexport function addToDate(\n  date: Date | number,\n  amount: number,\n  unit: 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'years'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'milliseconds':\n      d.setMilliseconds(d.getMilliseconds() + amount);\n      break;\n    case 'seconds':\n      d.setSeconds(d.getSeconds() + amount);\n      break;\n    case 'minutes':\n      d.setMinutes(d.getMinutes() + amount);\n      break;\n    case 'hours':\n      d.setHours(d.getHours() + amount);\n      break;\n    case 'days':\n      d.setDate(d.getDate() + amount);\n      break;\n    case 'months': {\n      const origDate = d.getDate();\n      const origMonth = d.getMonth();\n      d.setDate(1); // Prevent overflow\n      d.setMonth(origMonth + amount);\n      const lastDay = new Date(d.getFullYear(), d.getMonth() + 1, 0).getDate();\n      d.setDate(Math.min(origDate, lastDay));\n      break;\n    }\n    case 'years':\n      d.setFullYear(d.getFullYear() + amount);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Get the start of a time period containing the specified date.\n *\n * @param date - Date to get the start from\n * @param unit - Time unit\n * @returns Date object representing the start of the time unit\n *\n * @example\n * ```typescript\n * // Get start of day (midnight)\n * startOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 00:00:00\n *\n * // Get start of month\n * startOf(new Date('2023-05-15'), 'month'); // Date for May 1, 2023\n * ```\n */\nexport function startOf(\n  date: Date | number,\n  unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'second':\n      d.setMilliseconds(0);\n      break;\n    case 'minute':\n      d.setSeconds(0, 0);\n      break;\n    case 'hour':\n      d.setMinutes(0, 0, 0);\n      break;\n    case 'day':\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'week':\n      d.setHours(0, 0, 0, 0);\n      d.setDate(d.getDate() - d.getDay());\n      break;\n    case 'month':\n      d.setDate(1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'quarter':\n      d.setMonth(Math.floor(d.getMonth() / 3) * 3, 1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    case 'year':\n      d.setMonth(0, 1);\n      d.setHours(0, 0, 0, 0);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Get the end of a time period containing the specified date.\n *\n * @param date - Date to get the end from\n * @param unit - Time unit\n * @returns Date object representing the end of the time unit\n *\n * @example\n * ```typescript\n * // Get end of day (23:59:59.999)\n * endOf(new Date('2023-05-15T14:30:00'), 'day'); // Date for May 15, 2023 23:59:59.999\n *\n * // Get end of month\n * endOf(new Date('2023-05-15'), 'month'); // Date for May 31, 2023 23:59:59.999\n * ```\n */\nexport function endOf(\n  date: Date | number,\n  unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year'\n): Date {\n  const d = date instanceof Date ? new Date(date) : new Date(date);\n\n  switch (unit) {\n    case 'second':\n      d.setMilliseconds(999);\n      break;\n    case 'minute':\n      d.setSeconds(59, 999);\n      break;\n    case 'hour':\n      d.setMinutes(59, 59, 999);\n      break;\n    case 'day':\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'week':\n      d.setDate(d.getDate() - d.getDay() + 6);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'month':\n      d.setMonth(d.getMonth() + 1, 0);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'quarter':\n      d.setMonth(Math.floor(d.getMonth() / 3) * 3 + 3, 0);\n      d.setHours(23, 59, 59, 999);\n      break;\n    case 'year':\n      d.setMonth(11, 31);\n      d.setHours(23, 59, 59, 999);\n      break;\n    default:\n      throw new Error(`Unsupported unit: ${unit}`);\n  }\n\n  return d;\n}\n\n/**\n * Check if a date is between two other dates.\n *\n * @param date - Date to check\n * @param start - Start date of the range\n * @param end - End date of the range\n * @param inclusive - Whether the comparison should be inclusive of start/end\n * @returns True if the date is within the range\n *\n * @example\n * ```typescript\n * const date = new Date('2023-05-15');\n * const start = new Date('2023-05-10');\n * const end = new Date('2023-05-20');\n *\n * isBetween(date, start, end); // true\n * ```\n */\nexport function isBetween(\n  date: Date | number,\n  start: Date | number,\n  end: Date | number,\n  inclusive: boolean = true\n): boolean {\n  const d = date instanceof Date ? date.getTime() : date;\n  const s = start instanceof Date ? start.getTime() : start;\n  const e = end instanceof Date ? end.getTime() : end;\n\n  return inclusive ? d >= s && d <= e : d > s && d < e;\n}\n\n/**\n * Check if a year is a leap year.\n *\n * @param year - Year to check (or date object)\n * @returns True if the year is a leap year\n */\nexport function isLeapYear(year: number | Date): boolean {\n  const y = year instanceof Date ? year.getFullYear() : year;\n  return (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;\n}\n\n/**\n * Get the number of days in a month.\n *\n * @param year - Year\n * @param month - Month (0-11)\n * @returns Number of days in the month\n */\nexport function daysInMonth(year: number | Date, month?: number): number {\n  if (year instanceof Date) {\n    month = year.getMonth();\n    year = year.getFullYear();\n  }\n\n  if (month === undefined) {\n    throw new Error('Month is required when year is a number');\n  }\n\n  return new Date(year, month + 1, 0).getDate();\n}\n"]}