ts-time-utils 4.0.1 → 4.4.0

package/dist/{format.js → format.cjs}

@@ -1,10 +1,23 @@
-import { MILLISECONDS_PER_SECOND, MILLISECONDS_PER_MINUTE, MILLISECONDS_PER_HOUR, MILLISECONDS_PER_DAY, MILLISECONDS_PER_WEEK, MILLISECONDS_PER_MONTH, MILLISECONDS_PER_YEAR } from './constants.js';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDuration = formatDuration;
+exports.timeAgo = timeAgo;
+exports.formatTime = formatTime;
+exports.parseDuration = parseDuration;
+exports.formatDate = formatDate;
+exports.formatRelativeTime = formatRelativeTime;
+exports.formatDateRange = formatDateRange;
+exports.formatOrdinal = formatOrdinal;
+exports.formatDayOrdinal = formatDayOrdinal;
+exports.formatDurationCompact = formatDurationCompact;
+exports.formatCalendarDate = formatCalendarDate;
+const constants_js_1 = require("./constants.cjs");
 /**
  * Convert milliseconds to a human-readable duration.
  * @param ms - milliseconds
  * @param options - formatting options
  */
-export function formatDuration(ms, options = {}) {
+function formatDuration(ms, options = {}) {
     const { includeMs = false, short = false, maxUnits = 2, round = false } = options;
     if (ms < 0)
         return '0' + (short ? 's' : ' seconds');
@@ -12,46 +25,46 @@ export function formatDuration(ms, options = {}) {
     const parts = [];
     let remaining = ms;
     // Years
-    if (remaining >= MILLISECONDS_PER_YEAR) {
-        const years = mathFn(remaining / MILLISECONDS_PER_YEAR);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_YEAR) {
+        const years = mathFn(remaining / constants_js_1.MILLISECONDS_PER_YEAR);
         parts.push(years + (short ? 'y' : ` year${years !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_YEAR;
+        remaining %= constants_js_1.MILLISECONDS_PER_YEAR;
     }
     // Months
-    if (remaining >= MILLISECONDS_PER_MONTH && parts.length < maxUnits) {
-        const months = mathFn(remaining / MILLISECONDS_PER_MONTH);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_MONTH && parts.length < maxUnits) {
+        const months = mathFn(remaining / constants_js_1.MILLISECONDS_PER_MONTH);
         parts.push(months + (short ? 'mo' : ` month${months !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_MONTH;
+        remaining %= constants_js_1.MILLISECONDS_PER_MONTH;
     }
     // Weeks
-    if (remaining >= MILLISECONDS_PER_WEEK && parts.length < maxUnits) {
-        const weeks = mathFn(remaining / MILLISECONDS_PER_WEEK);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_WEEK && parts.length < maxUnits) {
+        const weeks = mathFn(remaining / constants_js_1.MILLISECONDS_PER_WEEK);
         parts.push(weeks + (short ? 'w' : ` week${weeks !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_WEEK;
+        remaining %= constants_js_1.MILLISECONDS_PER_WEEK;
     }
     // Days
-    if (remaining >= MILLISECONDS_PER_DAY && parts.length < maxUnits) {
-        const days = mathFn(remaining / MILLISECONDS_PER_DAY);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_DAY && parts.length < maxUnits) {
+        const days = mathFn(remaining / constants_js_1.MILLISECONDS_PER_DAY);
         parts.push(days + (short ? 'd' : ` day${days !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_DAY;
+        remaining %= constants_js_1.MILLISECONDS_PER_DAY;
     }
     // Hours
-    if (remaining >= MILLISECONDS_PER_HOUR && parts.length < maxUnits) {
-        const hours = mathFn(remaining / MILLISECONDS_PER_HOUR);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_HOUR && parts.length < maxUnits) {
+        const hours = mathFn(remaining / constants_js_1.MILLISECONDS_PER_HOUR);
         parts.push(hours + (short ? 'h' : ` hour${hours !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_HOUR;
+        remaining %= constants_js_1.MILLISECONDS_PER_HOUR;
     }
     // Minutes
-    if (remaining >= MILLISECONDS_PER_MINUTE && parts.length < maxUnits) {
-        const minutes = mathFn(remaining / MILLISECONDS_PER_MINUTE);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_MINUTE && parts.length < maxUnits) {
+        const minutes = mathFn(remaining / constants_js_1.MILLISECONDS_PER_MINUTE);
         parts.push(minutes + (short ? 'm' : ` minute${minutes !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_MINUTE;
+        remaining %= constants_js_1.MILLISECONDS_PER_MINUTE;
     }
     // Seconds
-    if (remaining >= MILLISECONDS_PER_SECOND && parts.length < maxUnits) {
-        const seconds = mathFn(remaining / MILLISECONDS_PER_SECOND);
+    if (remaining >= constants_js_1.MILLISECONDS_PER_SECOND && parts.length < maxUnits) {
+        const seconds = mathFn(remaining / constants_js_1.MILLISECONDS_PER_SECOND);
         parts.push(seconds + (short ? 's' : ` second${seconds !== 1 ? 's' : ''}`));
-        remaining %= MILLISECONDS_PER_SECOND;
+        remaining %= constants_js_1.MILLISECONDS_PER_SECOND;
     }
     // Milliseconds
     if ((remaining > 0 || parts.length === 0) && includeMs && parts.length < maxUnits) {
@@ -68,43 +81,43 @@ export function formatDuration(ms, options = {}) {
  * @param date - past or future date
  * @param options - formatting options
  */
-export function timeAgo(date, options = {}) {
+function timeAgo(date, options = {}) {
     const now = new Date();
     const diffMs = now.getTime() - date.getTime();
     const { short = false } = options;
     const isFuture = diffMs < 0;
     const absDiffMs = Math.abs(diffMs);
-    if (absDiffMs < MILLISECONDS_PER_MINUTE) {
-        const seconds = Math.floor(absDiffMs / MILLISECONDS_PER_SECOND);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_MINUTE) {
+        const seconds = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_SECOND);
         const unit = short ? 's' : ` second${seconds !== 1 ? 's' : ''}`;
         return isFuture ? `in ${seconds}${unit}` : `${seconds}${unit} ago`;
     }
-    if (absDiffMs < MILLISECONDS_PER_HOUR) {
-        const minutes = Math.floor(absDiffMs / MILLISECONDS_PER_MINUTE);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_HOUR) {
+        const minutes = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_MINUTE);
         const unit = short ? 'm' : ` minute${minutes !== 1 ? 's' : ''}`;
         return isFuture ? `in ${minutes}${unit}` : `${minutes}${unit} ago`;
     }
-    if (absDiffMs < MILLISECONDS_PER_DAY) {
-        const hours = Math.floor(absDiffMs / MILLISECONDS_PER_HOUR);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_DAY) {
+        const hours = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_HOUR);
         const unit = short ? 'h' : ` hour${hours !== 1 ? 's' : ''}`;
         return isFuture ? `in ${hours}${unit}` : `${hours}${unit} ago`;
     }
-    if (absDiffMs < MILLISECONDS_PER_WEEK) {
-        const days = Math.floor(absDiffMs / MILLISECONDS_PER_DAY);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_WEEK) {
+        const days = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_DAY);
         const unit = short ? 'd' : ` day${days !== 1 ? 's' : ''}`;
         return isFuture ? `in ${days}${unit}` : `${days}${unit} ago`;
     }
-    if (absDiffMs < MILLISECONDS_PER_MONTH) {
-        const weeks = Math.floor(absDiffMs / MILLISECONDS_PER_WEEK);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_MONTH) {
+        const weeks = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_WEEK);
         const unit = short ? 'w' : ` week${weeks !== 1 ? 's' : ''}`;
         return isFuture ? `in ${weeks}${unit}` : `${weeks}${unit} ago`;
     }
-    if (absDiffMs < MILLISECONDS_PER_YEAR) {
-        const months = Math.floor(absDiffMs / MILLISECONDS_PER_MONTH);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_YEAR) {
+        const months = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_MONTH);
         const unit = short ? 'mo' : ` month${months !== 1 ? 's' : ''}`;
         return isFuture ? `in ${months}${unit}` : `${months}${unit} ago`;
     }
-    const years = Math.floor(absDiffMs / MILLISECONDS_PER_YEAR);
+    const years = Math.floor(absDiffMs / constants_js_1.MILLISECONDS_PER_YEAR);
     const unit = short ? 'y' : ` year${years !== 1 ? 's' : ''}`;
     return isFuture ? `in ${years}${unit}` : `${years}${unit} ago`;
 }
@@ -113,7 +126,7 @@ export function timeAgo(date, options = {}) {
  * @param date - date to format
  * @param format - format type
  */
-export function formatTime(date, format = '24h') {
+function formatTime(date, format = '24h') {
     switch (format) {
         case '12h':
             return date.toLocaleTimeString('en-US', {
@@ -132,7 +145,7 @@ export function formatTime(date, format = '24h') {
  * Parse a duration string like "1h 30m" into milliseconds
  * @param duration - duration string (e.g., "1h 30m", "2d", "45s")
  */
-export function parseDuration(duration) {
+function parseDuration(duration) {
     const regex = /(\d+(?:\.\d+)?)\s*([a-zA-Z]+)/g;
     let totalMs = 0;
     let match;
@@ -149,39 +162,39 @@ export function parseDuration(duration) {
             case 'sec':
             case 'second':
             case 'seconds':
-                totalMs += value * MILLISECONDS_PER_SECOND;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_SECOND;
                 break;
             case 'm':
             case 'min':
             case 'minute':
             case 'minutes':
-                totalMs += value * MILLISECONDS_PER_MINUTE;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_MINUTE;
                 break;
             case 'h':
             case 'hr':
             case 'hour':
             case 'hours':
-                totalMs += value * MILLISECONDS_PER_HOUR;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_HOUR;
                 break;
             case 'd':
             case 'day':
             case 'days':
-                totalMs += value * MILLISECONDS_PER_DAY;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_DAY;
                 break;
             case 'w':
             case 'week':
             case 'weeks':
-                totalMs += value * MILLISECONDS_PER_WEEK;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_WEEK;
                 break;
             case 'mo':
             case 'month':
             case 'months':
-                totalMs += value * MILLISECONDS_PER_MONTH;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_MONTH;
                 break;
             case 'y':
             case 'year':
             case 'years':
-                totalMs += value * MILLISECONDS_PER_YEAR;
+                totalMs += value * constants_js_1.MILLISECONDS_PER_YEAR;
                 break;
         }
     }
@@ -225,7 +238,7 @@ const DAY_NAMES_SHORT = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
  * - A: AM/PM
  * - a: am/pm
  */
-export function formatDate(date, pattern) {
+function formatDate(date, pattern) {
     const year = date.getFullYear();
     const month = date.getMonth();
     const day = date.getDate();
@@ -270,36 +283,36 @@ export function formatDate(date, pattern) {
  * @param date - target date
  * @param baseDate - base date (default: now)
  */
-export function formatRelativeTime(date, baseDate = new Date()) {
+function formatRelativeTime(date, baseDate = new Date()) {
     const diffMs = date.getTime() - baseDate.getTime();
     const isFuture = diffMs > 0;
     const absDiffMs = Math.abs(diffMs);
     const rtf = new Intl.RelativeTimeFormat('en', { numeric: 'auto' });
-    if (absDiffMs < MILLISECONDS_PER_MINUTE) {
-        const seconds = Math.round(absDiffMs / MILLISECONDS_PER_SECOND);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_MINUTE) {
+        const seconds = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_SECOND);
         return rtf.format(isFuture ? seconds : -seconds, 'second');
     }
-    if (absDiffMs < MILLISECONDS_PER_HOUR) {
-        const minutes = Math.round(absDiffMs / MILLISECONDS_PER_MINUTE);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_HOUR) {
+        const minutes = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_MINUTE);
         return rtf.format(isFuture ? minutes : -minutes, 'minute');
     }
-    if (absDiffMs < MILLISECONDS_PER_DAY) {
-        const hours = Math.round(absDiffMs / MILLISECONDS_PER_HOUR);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_DAY) {
+        const hours = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_HOUR);
         return rtf.format(isFuture ? hours : -hours, 'hour');
     }
-    if (absDiffMs < MILLISECONDS_PER_WEEK) {
-        const days = Math.round(absDiffMs / MILLISECONDS_PER_DAY);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_WEEK) {
+        const days = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_DAY);
         return rtf.format(isFuture ? days : -days, 'day');
     }
-    if (absDiffMs < MILLISECONDS_PER_MONTH) {
-        const weeks = Math.round(absDiffMs / MILLISECONDS_PER_WEEK);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_MONTH) {
+        const weeks = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_WEEK);
         return rtf.format(isFuture ? weeks : -weeks, 'week');
     }
-    if (absDiffMs < MILLISECONDS_PER_YEAR) {
-        const months = Math.round(absDiffMs / MILLISECONDS_PER_MONTH);
+    if (absDiffMs < constants_js_1.MILLISECONDS_PER_YEAR) {
+        const months = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_MONTH);
         return rtf.format(isFuture ? months : -months, 'month');
     }
-    const years = Math.round(absDiffMs / MILLISECONDS_PER_YEAR);
+    const years = Math.round(absDiffMs / constants_js_1.MILLISECONDS_PER_YEAR);
     return rtf.format(isFuture ? years : -years, 'year');
 }
 /**
@@ -308,7 +321,7 @@ export function formatRelativeTime(date, baseDate = new Date()) {
  * @param end - end date
  * @param options - formatting options
  */
-export function formatDateRange(start, end, options = {}) {
+function formatDateRange(start, end, options = {}) {
     const { separator = ' - ', includeTime = false, format = 'medium' } = options;
     const sameYear = start.getFullYear() === end.getFullYear();
     const sameMonth = sameYear && start.getMonth() === end.getMonth();
@@ -335,7 +348,7 @@ export function formatDateRange(start, end, options = {}) {
  * Format a number as an ordinal (1st, 2nd, 3rd, etc.)
  * @param n - number to format
  */
-export function formatOrdinal(n) {
+function formatOrdinal(n) {
     const suffixes = ['th', 'st', 'nd', 'rd'];
     const v = n % 100;
     return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);
@@ -344,7 +357,7 @@ export function formatOrdinal(n) {
  * Format a day of month as an ordinal (1st, 2nd, 3rd, etc.)
  * @param date - date to format
  */
-export function formatDayOrdinal(date) {
+function formatDayOrdinal(date) {
     return formatOrdinal(date.getDate());
 }
 /**
@@ -352,10 +365,10 @@ export function formatDayOrdinal(date) {
  * @param ms - milliseconds
  * @param showHours - always show hours even if 0
  */
-export function formatDurationCompact(ms, showHours = true) {
-    const hours = Math.floor(ms / MILLISECONDS_PER_HOUR);
-    const minutes = Math.floor((ms % MILLISECONDS_PER_HOUR) / MILLISECONDS_PER_MINUTE);
-    const seconds = Math.floor((ms % MILLISECONDS_PER_MINUTE) / MILLISECONDS_PER_SECOND);
+function formatDurationCompact(ms, showHours = true) {
+    const hours = Math.floor(ms / constants_js_1.MILLISECONDS_PER_HOUR);
+    const minutes = Math.floor((ms % constants_js_1.MILLISECONDS_PER_HOUR) / constants_js_1.MILLISECONDS_PER_MINUTE);
+    const seconds = Math.floor((ms % constants_js_1.MILLISECONDS_PER_MINUTE) / constants_js_1.MILLISECONDS_PER_SECOND);
     const pad = (n) => String(n).padStart(2, '0');
     if (showHours || hours > 0) {
         return `${pad(hours)}:${pad(minutes)}:${pad(seconds)}`;
@@ -366,11 +379,11 @@ export function formatDurationCompact(ms, showHours = true) {
  * Format a date/time for display in a calendar
  * @param date - date to format
  */
-export function formatCalendarDate(date) {
+function formatCalendarDate(date) {
     const now = new Date();
     const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
     const dateOnly = new Date(date.getFullYear(), date.getMonth(), date.getDate());
-    const diffDays = Math.round((dateOnly.getTime() - today.getTime()) / MILLISECONDS_PER_DAY);
+    const diffDays = Math.round((dateOnly.getTime() - today.getTime()) / constants_js_1.MILLISECONDS_PER_DAY);
     if (diffDays === 0)
         return 'Today';
     if (diffDays === -1)