@fluixi/utils 1.0.0-alpha.53

package/dist/lib/primitive/date/date.cjs

@@ -0,0 +1 @@
+"use strict";var E=Object.defineProperty;var X=Object.getOwnPropertyDescriptor;var tt=Object.getOwnPropertyNames;var et=Object.prototype.hasOwnProperty;var rt=(t,e)=>{for(var n in e)E(t,n,{get:e[n],enumerable:!0})},nt=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of tt(e))!et.call(t,a)&&a!==n&&E(t,a,{get:()=>e[a],enumerable:!(r=X(e,a))||r.enumerable});return t};var at=t=>nt(E({},"__esModule",{value:!0}),t);var ae={};rt(ae,{add:()=>M,addBusinessDays:()=>Ht,addDays:()=>F,addMonths:()=>ht,addYears:()=>wt,configureDateUtils:()=>ot,convertTimezone:()=>U,createDate:()=>B,daysBetween:()=>Ut,difference:()=>j,endOf:()=>S,endOfDay:()=>Mt,endOfMonth:()=>yt,endOfWeek:()=>Tt,endOfYear:()=>$t,formatDate:()=>T,getAge:()=>_t,getDayName:()=>Pt,getDaysInMonth:()=>Wt,getMonthName:()=>zt,getQuarter:()=>Rt,getTimezoneInfo:()=>Bt,getWeekNumber:()=>At,humanizeDifference:()=>Ft,isAfter:()=>xt,isBefore:()=>kt,isBetween:()=>Yt,isBusinessDay:()=>K,isDate:()=>f,isFuture:()=>Z,isLeapYear:()=>Lt,isPast:()=>V,isSame:()=>N,isToday:()=>Ot,isWeekday:()=>Nt,isWeekend:()=>H,monthsBetween:()=>vt,now:()=>p,parseDate:()=>u,resetDateConfig:()=>st,startOf:()=>h,startOfDay:()=>y,startOfMonth:()=>St,startOfWeek:()=>Et,startOfYear:()=>It,subtract:()=>$,subtractDays:()=>J,subtractMonths:()=>bt,subtractYears:()=>pt,today:()=>I,tomorrow:()=>lt,validateDate:()=>qt,yearsBetween:()=>Ct,yesterday:()=>dt});module.exports=at(ae);var Y=1e3,k=60,x=60,O=24,b=7;var P=["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],z=["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],W=["January","February","March","April","May","June","July","August","September","October","November","December"],L=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],q={defaultTimezone:"UTC",defaultLocale:"en-US",weekStartsOn:0,businessDays:{businessDays:[1,2,3,4,5],holidays:[],holidayCheck:()=>!1,workStartHour:9,workEndHour:17}},D={...q};function ot(t){D={...D,...t,businessDays:{...D.businessDays,...t.businessDays||{}}}}function st(){D={...q}}function u(t,e={}){let{format:n="ISO",customFormat:r="",timezone:a=D.defaultTimezone,strict:o=!0,locale:s=D.defaultLocale}=e;if(t instanceof Date&&f(t))return t;let i=null;if(typeof t=="number"){if(i=new Date(t),!f(i))throw new Error(`Invalid timestamp: ${t}`);return _(i,a)}if(typeof t!="string")throw new Error(`Invalid input type: ${typeof t}`);let c=t.trim();if(!c)throw new Error("Empty date string");try{switch(n){case"ISO":case"ISO_DATE":case"ISO_TIME":i=it(c,n);break;case"US":i=ut(c);break;case"EU":i=ct(c);break;case"CUSTOM":i=mt(c,r);break;case"RFC_2822":i=ft(c);break;case"TIMESTAMP":i=Dt(c);break;default:i=gt(c,s,o)}if(!i||!f(i)){if(o)throw new Error(`Parsing resulted in invalid date from input: "${c}"`);if(i=new Date(c),!f(i))throw new Error(`Invalid date format: ${c}`)}if(a&&a!=="UTC"&&(i=U(i,a)),!i)throw new Error(`Invalid date format: ${c}`);return i}catch(l){if(o)throw new Error(`Failed to parse date "${c}" with format ${n}: ${l instanceof Error?l.message:String(l)}`);let m=new Date(c);if(f(m)){let d=_(m,a);if(!d)throw new Error(`Invalid date format: ${c}`);return d}throw new Error(`Invalid date format: ${c}`)}}function it(t,e){try{if(e==="ISO_DATE"){let r=t.split("-").map(i=>parseInt(i,10));if(r.length<3||r.some(isNaN))throw new Error("Invalid ISO date format");let[a,o,s]=r;return new Date(Date.UTC(a,o-1,s))}if(e==="ISO_TIME"){let a=new Date().toISOString().split("T")[0];return new Date(`${a}T${t}Z`)}let n=new Date(t);if(!f(n))throw new Error("Invalid ISO date");return n}catch{throw new Error(`Invalid ISO ${e} format: ${t}`)}}function ut(t){try{let e=t.split("/");if(e.length!==3)throw new Error("Invalid US date format - expected MM/DD/YYYY");let n=parseInt(e[0],10)-1,r=parseInt(e[1],10),a=parseInt(e[2],10);if(isNaN(n)||isNaN(r)||isNaN(a))throw new Error("Invalid US date format - non-numeric parts");if(a<100){let s=new Date().getFullYear(),i=Math.floor(s/100)*100;a+=a<50?i:i-100}if(n<0||n>11)throw new Error(`Month must be between 1 and 12, got ${n+1}`);let o=new Date(a,n,r);if(!f(o))throw new Error("Invalid date");if(o.getFullYear()!==a||o.getMonth()!==n||o.getDate()!==r)throw new Error("Invalid date");return o}catch(e){throw new Error(`Invalid US date format: ${t} - ${e instanceof Error?e.message:String(e)}`)}}function ct(t){try{let e=t.split("/");if(e.length!==3)throw new Error("Invalid EU date format - expected DD/MM/YYYY");let n=parseInt(e[0],10),r=parseInt(e[1],10)-1,a=parseInt(e[2],10);if(isNaN(n)||isNaN(r)||isNaN(a))throw new Error("Invalid EU date format - non-numeric parts");if(a<100){let s=new Date().getFullYear(),i=Math.floor(s/100)*100;a+=a<50?i:i-100}if(r<0||r>11)throw new Error(`Month must be between 1 and 12, got ${r+1}`);let o=new Date(a,r,n);if(!f(o))throw new Error("Invalid date");if(o.getFullYear()!==a||o.getMonth()!==r||o.getDate()!==n)throw new Error("Invalid date");return o}catch(e){throw new Error(`Invalid EU date format: ${t} - ${e instanceof Error?e.message:String(e)}`)}}function mt(t,e){try{if(!e)throw new Error("Custom format string is required");let n=e.replace(/YYYY/g,"(\\d{4})").replace(/YY/g,"(\\d{2})").replace(/MM/g,"(\\d{2})").replace(/M/g,"(\\d{1,2})").replace(/DD/g,"(\\d{2})").replace(/D/g,"(\\d{1,2})").replace(/HH/g,"(\\d{2})").replace(/H/g,"(\\d{1,2})").replace(/hh/g,"(\\d{2})").replace(/h/g,"(\\d{1,2})").replace(/mm/g,"(\\d{2})").replace(/m/g,"(\\d{1,2})").replace(/ss/g,"(\\d{2})").replace(/s/g,"(\\d{1,2})"),r=new RegExp(`^${n}$`),a=t.match(r);if(!a)throw new Error(`Input does not match custom format: ${e}`);let o=0,s=0,i=1,c=0,l=0,m=0,d=1,G=e.match(/YYYY|YY|MM|M|DD|D|HH|H|hh|h|mm|m|ss|s/g)||[];for(let v of G){let g=parseInt(a[d],10);if(isNaN(g))throw new Error(`Invalid numeric value for token ${v}`);switch(v){case"YYYY":o=g;break;case"YY":if(o=g,o<100){let Q=new Date().getFullYear(),C=Math.floor(Q/100)*100;o+=o<50?C:C-100}break;case"MM":case"M":s=g-1;break;case"DD":case"D":i=g;break;case"HH":case"H":c=g;break;case"hh":case"h":c=g;break;case"mm":case"m":l=g;break;case"ss":case"s":m=g;break}d++}if(o<1e3||o>9999)throw new Error(`Year must be between 1000 and 9999: ${o}`);if(s<0||s>11)throw new Error(`Month must be between 1 and 12: ${s+1}`);let w=new Date(o,s,i,c,l,m);if(!f(w))throw new Error("Invalid date");if(w.getFullYear()!==o||w.getMonth()!==s||w.getDate()!==i)throw new Error("Invalid date");return w}catch(n){throw new Error(`Failed to parse with custom format "${e}": ${n instanceof Error?n.message:String(n)}`)}}function ft(t){try{let e=new Date(t);if(!f(e))throw new Error("Invalid RFC 2822 date");return e}catch{throw new Error(`Invalid RFC 2822 date format: ${t}`)}}function Dt(t){try{if(!/^\d{8}(\d{6})?$/.test(t))throw new Error("Invalid timestamp format - expected YYYYMMDD or YYYYMMDDHHMMSS");let e=parseInt(t.substring(0,4),10),n=parseInt(t.substring(4,6),10)-1,r=parseInt(t.substring(6,8),10),a=0,o=0,s=0;if(t.length===14&&(a=parseInt(t.substring(8,10),10),o=parseInt(t.substring(10,12),10),s=parseInt(t.substring(12,14),10)),n<0||n>11)throw new Error(`Month must be between 1 and 12: ${n+1}`);let i=new Date(e,n,r,a,o,s);if(!f(i))throw new Error("Invalid timestamp");return i}catch(e){throw new Error(`Invalid timestamp format: ${t} - ${e instanceof Error?e.message:String(e)}`)}}function gt(t,e,n){try{let r=new Date(t);if(f(r))return r;let a=new Intl.DateTimeFormat(e,{year:"numeric",month:"numeric",day:"numeric",hour:"numeric",minute:"numeric",second:"numeric"}),o=new Date(t);if(f(o))return o;if(n)throw new Error(`Could not parse date with locale ${e}`);return new Date(NaN)}catch(r){if(n)throw new Error(`Failed to parse locale date: ${r instanceof Error?r.message:String(r)}`);return new Date(NaN)}}function _(t,e){return t}function f(t){if(!t||typeof t!="object")return!1;let e=t;if(typeof e.getTime!="function"||typeof e.getFullYear!="function")return!1;let n=e.getTime();return!isNaN(n)&&typeof n=="number"&&isFinite(n)}function T(t,e={}){let n=u(t),{format:r="ISO",customFormat:a="",timezone:o=D.defaultTimezone,locale:s=D.defaultLocale,includeTime:i=!0,includeSeconds:c=!1,includeMilliseconds:l=!1}=e,m=n;switch(o&&o!=="UTC"&&(m=U(n,o)),r){case"ISO":return m.toISOString();case"ISO_DATE":return m.toISOString().split("T")[0];case"ISO_TIME":{let d=m.toISOString().split("T")[1];return l?d:d.split(".")[0]}case"US":return Jt(m);case"EU":return Vt(m);case"FULL":return Zt(m,s);case"LONG":return jt(m,s);case"MEDIUM":return A(m,s);case"SHORT":return Kt(m,s);case"TIME":return R(m,s,c);case"TIME_24":return Gt(m,c);case"DATETIME":return`${A(m,s)}, ${R(m,s,c)}`;case"TIMESTAMP":return Qt(m);case"RFC_2822":return Xt(m);case"CUSTOM":return te(m,a);default:return m.toISOString()}}function p(){return new Date}function I(){return y(new Date)}function lt(){return F(I(),1)}function dt(){return J(I(),1)}function B(t,e,n,r=0,a=0,o=0,s=0){return ee(t,e,n,r,a,o,s),new Date(t,e,n,r,a,o,s)}function M(t,e,n="day"){let r=u(t),a=new Date(r);switch(n){case"millisecond":a.setMilliseconds(a.getMilliseconds()+e);break;case"second":a.setSeconds(a.getSeconds()+e);break;case"minute":a.setMinutes(a.getMinutes()+e);break;case"hour":a.setHours(a.getHours()+e);break;case"day":a.setDate(a.getDate()+e);break;case"week":a.setDate(a.getDate()+e*b);break;case"month":a.setMonth(a.getMonth()+e);break;case"quarter":a.setMonth(a.getMonth()+e*3);break;case"year":a.setFullYear(a.getFullYear()+e);break;default:throw new Error(`Unsupported date unit: ${n}`)}return a}function $(t,e,n="day"){return M(t,-e,n)}function F(t,e){return M(t,e,"day")}function J(t,e){return $(t,e,"day")}function ht(t,e){return M(t,e,"month")}function bt(t,e){return $(t,e,"month")}function wt(t,e){return M(t,e,"year")}function pt(t,e){return $(t,e,"year")}function h(t,e){let n=u(t),r=new Date(n);switch(e){case"year":r.setMonth(0,1),r.setHours(0,0,0,0);break;case"month":r.setDate(1),r.setHours(0,0,0,0);break;case"day":r.setHours(0,0,0,0);break;case"hour":r.setMinutes(0,0,0);break;case"minute":r.setSeconds(0,0);break;case"second":r.setMilliseconds(0);break;case"week":{let o=(r.getDay()-D.weekStartsOn+b)%b;r.setDate(r.getDate()-o),r.setHours(0,0,0,0);break}case"quarter":{let a=Math.floor(r.getMonth()/3);r.setMonth(a*3,1),r.setHours(0,0,0,0);break}default:throw new Error(`Unsupported unit for startOf: ${e}`)}return r}function S(t,e){let n=h(t,e),r=new Date(n);switch(e){case"year":r.setFullYear(r.getFullYear()+1);break;case"quarter":r.setMonth(r.getMonth()+3);break;case"month":r.setMonth(r.getMonth()+1);break;case"week":r.setDate(r.getDate()+b);break;case"day":r.setDate(r.getDate()+1);break;case"hour":r.setHours(r.getHours()+1);break;case"minute":r.setMinutes(r.getMinutes()+1);break;case"second":r.setSeconds(r.getSeconds()+1);break;default:throw new Error(`Unsupported unit for endOf: ${e}`)}return r.setMilliseconds(r.getMilliseconds()-1),r}function y(t){return h(t,"day")}function Mt(t){return S(t,"day")}function St(t){return h(t,"month")}function yt(t){return S(t,"month")}function It(t){return h(t,"year")}function $t(t){return S(t,"year")}function Et(t){return h(t,"week")}function Tt(t){return S(t,"week")}function Yt(t,e,n,r=!0){let a=u(t),o=u(e),s=u(n);return r?a>=o&&a<=s:a>o&&a<s}function kt(t,e){return u(t)<u(e)}function xt(t,e){return u(t)>u(e)}function N(t,e,n){let r=u(t),a=u(e);if(!n)return r.getTime()===a.getTime();let o=h(r,n),s=h(a,n);return o.getTime()===s.getTime()}function Ot(t){return N(t,I(),"day")}function V(t){return u(t)<p()}function Z(t){return u(t)>p()}function j(t,e){let n=u(t),r=u(e),a=Math.abs(r.getTime()-n.getTime()),o=Math.floor(a/Y),s=Math.floor(o/k),i=Math.floor(s/x),c=Math.floor(i/O);return{years:Math.floor(c/365),months:Math.floor(c/30),weeks:Math.floor(c/b),days:c,hours:i,minutes:s,seconds:o,milliseconds:a,totalDays:c,totalHours:i,totalMinutes:s,totalSeconds:o,totalMilliseconds:a}}function Ft(t,e=p(),n=!1){let r=j(t,e),o=u(t)<u(e)?"ago":"in";return r.years>0?n?`${r.years} year${r.years===1?"":"s"} ${o}`:`${r.years}y ${o}`:r.months>0?n?`${r.months} month${r.months===1?"":"s"} ${o}`:`${r.months}mo ${o}`:r.weeks>0?n?`${r.weeks} week${r.weeks===1?"":"s"} ${o}`:`${r.weeks}w ${o}`:r.days>0?n?`${r.days} day${r.days===1?"":"s"} ${o}`:`${r.days}d ${o}`:r.hours>0?n?`${r.hours} hour${r.hours===1?"":"s"} ${o}`:`${r.hours}h ${o}`:r.minutes>0?n?`${r.minutes} minute${r.minutes===1?"":"s"} ${o}`:`${r.minutes}m ${o}`:n?`${r.seconds} second${r.seconds===1?"":"s"} ${o}`:`${r.seconds}s ${o}`}function H(t){let n=u(t).getDay();return n===0||n===6}function Nt(t){return!H(t)}function K(t){let e=u(t);return H(e)||!D.businessDays.businessDays.includes(e.getDay())?!1:!(D.businessDays.holidays?.some(r=>N(r,e,"day"))||D.businessDays.holidayCheck?.(e))}function Ht(t,e){let n=u(t),r=0,a=e>0?1:-1;for(;r<Math.abs(e);)n=F(n,a),K(n)&&r++;return n}function Ut(t,e,n=!1){let r=y(u(t)),a=y(u(e)),o=Math.abs(a.getTime()-r.getTime()),s=Math.floor(o/(Y*k*x*O));return n?s+1:s}function vt(t,e){let n=u(t),r=u(e),a=r.getFullYear()-n.getFullYear(),o=r.getMonth()-n.getMonth();return a*12+o}function Ct(t,e){let n=u(t);return u(e).getFullYear()-n.getFullYear()}function _t(t,e=p()){let n=u(t),r=u(e),a=r.getFullYear()-n.getFullYear(),o=r.getMonth()-n.getMonth();return(o<0||o===0&&r.getDate()<n.getDate())&&a--,Math.max(0,a)}function At(t){let e=u(t),n=new Date(e.getFullYear(),0,1),r=(e.getTime()-n.getTime())/(Y*k*x*O);return Math.ceil((r+n.getDay()+1)/b)}function Rt(t){let e=u(t).getMonth();return Math.floor(e/3)+1}function Pt(t,e="full"){let r=u(t).getDay();return e==="full"?P[r]:z[r]}function zt(t,e="full"){let r=u(t).getMonth();return e==="full"?W[r]:L[r]}function Wt(t){let e=u(t);return new Date(e.getFullYear(),e.getMonth()+1,0).getDate()}function Lt(t){return t%4===0&&t%100!==0||t%400===0}function qt(t,e={}){let n=[];try{let r=u(t);if(e.required&&!r&&n.push("Date is required"),e.min||e.minDate){let a=u(e.min||e.minDate);r<a&&n.push(`Date must be on or after ${T(a,{format:"MEDIUM"})}`)}if(e.max||e.maxDate){let a=u(e.max||e.maxDate);r>a&&n.push(`Date must be on or before ${T(a,{format:"MEDIUM"})}`)}e.allowPast===!1&&V(r)&&n.push("Date must be in the future"),e.allowFuture===!1&&Z(r)&&n.push("Date must be in the past")}catch(r){n.push(r instanceof Error?r.message:"Invalid date")}return{isValid:n.length===0,errors:n}}function Bt(t){let e=u(t),n=Intl.DateTimeFormat().resolvedOptions().timeZone,r=-e.getTimezoneOffset(),a=Math.floor(Math.abs(r)/60),o=Math.abs(r)%60,s=r>=0?"+":"-";return{abbreviation:re(e),name:n,offset:r,offsetString:`UTC${s}${String(a).padStart(2,"0")}:${String(o).padStart(2,"0")}`,isDST:ne(e)}}function U(t,e){let n=u(t);if(e==="UTC")return new Date(n.getTime()+n.getTimezoneOffset()*6e4);let a=new Intl.DateTimeFormat("en-US",{timeZone:e,year:"numeric",month:"numeric",day:"numeric",hour:"numeric",minute:"numeric",second:"numeric"}).formatToParts(n),o=s=>a.find(i=>i.type===s)?.value;return B(parseInt(o("year")),parseInt(o("month"))-1,parseInt(o("day")),parseInt(o("hour")),parseInt(o("minute")),parseInt(o("second")))}function Jt(t){let e=(t.getMonth()+1).toString().padStart(2,"0"),n=t.getDate().toString().padStart(2,"0"),r=t.getFullYear();return`${e}/${n}/${r}`}function Vt(t){let e=t.getDate().toString().padStart(2,"0"),n=(t.getMonth()+1).toString().padStart(2,"0"),r=t.getFullYear();return`${e}/${n}/${r}`}function Zt(t,e){return new Intl.DateTimeFormat(e,{weekday:"long",year:"numeric",month:"long",day:"numeric"}).format(t)}function jt(t,e){return new Intl.DateTimeFormat(e,{year:"numeric",month:"long",day:"numeric"}).format(t)}function A(t,e){return new Intl.DateTimeFormat(e,{year:"numeric",month:"short",day:"numeric"}).format(t)}function Kt(t,e){return new Intl.DateTimeFormat(e,{year:"2-digit",month:"numeric",day:"numeric"}).format(t)}function R(t,e,n){return new Intl.DateTimeFormat(e,{hour:"numeric",minute:"2-digit",second:n?"2-digit":void 0,hour12:!0}).format(t)}function Gt(t,e){let n=t.getHours().toString().padStart(2,"0"),r=t.getMinutes().toString().padStart(2,"0"),a=e?`:${t.getSeconds().toString().padStart(2,"0")}`:"";return`${n}:${r}${a}`}function Qt(t){let e=t.getFullYear(),n=(t.getMonth()+1).toString().padStart(2,"0"),r=t.getDate().toString().padStart(2,"0"),a=t.getHours().toString().padStart(2,"0"),o=t.getMinutes().toString().padStart(2,"0"),s=t.getSeconds().toString().padStart(2,"0");return`${e}${n}${r}${a}${o}${s}`}function Xt(t){return t.toUTCString()}function te(t,e){let n={YYYY:t.getFullYear().toString(),YY:t.getFullYear().toString().slice(-2),MMMM:W[t.getMonth()],MMM:L[t.getMonth()],MM:(t.getMonth()+1).toString().padStart(2,"0"),M:(t.getMonth()+1).toString(),DDDD:P[t.getDay()],DDD:z[t.getDay()],DD:t.getDate().toString().padStart(2,"0"),D:t.getDate().toString(),HH:t.getHours().toString().padStart(2,"0"),H:t.getHours().toString(),hh:(t.getHours()%12||12).toString().padStart(2,"0"),h:(t.getHours()%12||12).toString(),mm:t.getMinutes().toString().padStart(2,"0"),m:t.getMinutes().toString(),ss:t.getSeconds().toString().padStart(2,"0"),s:t.getSeconds().toString(),SSS:t.getMilliseconds().toString().padStart(3,"0"),A:t.getHours()<12?"AM":"PM",a:t.getHours()<12?"am":"pm"};return e.replace(/YYYY|YY|MMMM|MMM|MM|M|DDDD|DDD|DD|D|HH|H|hh|h|mm|m|ss|s|SSS|A|a/g,r=>n[r]||r)}function ee(t,e,n,r=0,a=0,o=0,s=0){if(t<1e3||t>9999)throw new Error(`Year must be between 1000 and 9999: ${t}`);if(e<0||e>11)throw new Error(`Month must be between 0 and 11: ${e}`);let i=new Date(t,e+1,0).getDate();if(n<1||n>i)throw new Error(`Day must be between 1 and ${i} for month ${e}: ${n}`);if(r<0||r>23)throw new Error(`Hour must be between 0 and 23: ${r}`);if(a<0||a>59)throw new Error(`Minute must be between 0 and 59: ${a}`);if(o<0||o>59)throw new Error(`Second must be between 0 and 59: ${o}`);if(s<0||s>999)throw new Error(`Millisecond must be between 0 and 999: ${s}`)}function re(t){let r=new Intl.DateTimeFormat("en-US",{timeZoneName:"short"}).formatToParts(t).find(a=>a.type==="timeZoneName");return r?r.value:"UTC"}function ne(t){let e=new Date(t.getFullYear(),0,1),n=new Date(t.getFullYear(),6,1),r=Math.max(e.getTimezoneOffset(),n.getTimezoneOffset());return t.getTimezoneOffset()<r}

package/dist/lib/primitive/date/date.d.ts

@@ -0,0 +1,641 @@
+import { DateConfig, FormatOptions, Month, DateUnit, DateDifference, ValidationOptions, ValidationResult, TimezoneInfo, DateParseOptions } from './types.js';
+/**
+ * Configure date utility settings globally
+ * @function configureDateUtils
+ * @param {Partial<DateConfig>} newConfig - New configuration options
+ * @returns {void}
+ * @example
+ * // Configure with French locale and week starting on Monday
+ * configureDateUtils({
+ *   defaultLocale: 'fr-FR',
+ *   weekStartsOn: 1,
+ * });
+ */
+export declare function configureDateUtils(newConfig: Partial<DateConfig>): void;
+/**
+ * Reset configuration to defaults
+ * @function resetDateConfig
+ * @returns {void}
+ * @example
+ * resetDateConfig(); // Reset all settings to defaults
+ */
+export declare function resetDateConfig(): void;
+/**
+ * Parse a date from various input types with flexible formatting options
+ * @function parseDate
+ * @param {Date | string | number} input - Date to parse (Date object, string, or timestamp)
+ * @param {ParseOptions} [options={}] - Parsing options
+ * @returns {Date} Parsed Date object
+ * @throws {Error} If date cannot be parsed and strict mode is enabled
+ * @example
+ * // Parse ISO date
+ * parseDate('2024-01-15T10:30:00Z');
+ *
+ * // Parse US date
+ * parseDate('01/15/2024', { format: 'US' });
+ *
+ * // Parse with custom format
+ * parseDate('2024-15-01', { format: 'CUSTOM', customFormat: 'YYYY-DD-MM' });
+ */
+export declare function parseDate(input: Date | string | number, options?: DateParseOptions): Date;
+/**
+ * Validate if a value is a valid Date object
+ * @function isDate
+ * @param {unknown} date - Value to validate
+ * @returns {date is Date} True if value is a valid Date object
+ * @example
+ * isDate(new Date()); // true
+ * isDate('invalid'); // false
+ * isDate(new Date('invalid')); // false
+ */
+export declare function isDate(date: unknown): date is Date;
+/**
+ * Format a date to string with various formatting options
+ * @function formatDate
+ * @param {Date | string | number} date - Date to format
+ * @param {FormatOptions} [options={}] - Formatting options
+ * @returns {string} Formatted date string
+ * @example
+ * // Format as ISO
+ * formatDate(new Date(), { format: 'ISO' });
+ *
+ * // Format as US date
+ * formatDate('2024-01-15', { format: 'US' });
+ *
+ * // Format with custom format
+ * formatDate(new Date(), { format: 'CUSTOM', customFormat: 'YYYY-MM-DD HH:mm:ss' });
+ */
+export declare function formatDate(date: Date | string | number, options?: FormatOptions): string;
+/**
+ * Get current date and time
+ * @function now
+ * @returns {Date} Current date and time
+ * @example
+ * const current = now(); // Returns current Date object
+ */
+export declare function now(): Date;
+/**
+ * Get today's date at midnight (00:00:00.000)
+ * @function today
+ * @returns {Date} Today's date at midnight
+ * @example
+ * const todayDate = today(); // Returns today at midnight
+ */
+export declare function today(): Date;
+/**
+ * Get tomorrow's date at midnight
+ * @function tomorrow
+ * @returns {Date} Tomorrow's date at midnight
+ * @example
+ * const tomorrowDate = tomorrow(); // Returns tomorrow at midnight
+ */
+export declare function tomorrow(): Date;
+/**
+ * Get yesterday's date at midnight
+ * @function yesterday
+ * @returns {Date} Yesterday's date at midnight
+ * @example
+ * const yesterdayDate = yesterday(); // Returns yesterday at midnight
+ */
+export declare function yesterday(): Date;
+/**
+ * Create a date from individual components
+ * @function createDate
+ * @param {number} year - Year (e.g., 2024)
+ * @param {Month} month - Month (0-11, where 0 = January)
+ * @param {number} day - Day of month (1-31)
+ * @param {number} [hour=0] - Hour (0-23)
+ * @param {number} [minute=0] - Minute (0-59)
+ * @param {number} [second=0] - Second (0-59)
+ * @param {number} [millisecond=0] - Millisecond (0-999)
+ * @returns {Date} Created Date object
+ * @throws {Error} If any component is out of valid range
+ * @example
+ * // Create date for January 15, 2024, 10:30:45
+ * createDate(2024, 0, 15, 10, 30, 45);
+ */
+export declare function createDate(year: number, month: Month, day: number, hour?: number, minute?: number, second?: number, millisecond?: number): Date;
+/**
+ * Add time to a date
+ * @function add
+ * @param {Date | string | number} date - Base date
+ * @param {number} amount - Amount to add (can be negative to subtract)
+ * @param {DateUnit} [unit='day'] - Unit of time to add
+ * @returns {Date} New date after addition
+ * @example
+ * // Add 5 days
+ * add(new Date(), 5, 'day');
+ *
+ * // Add 2 months
+ * add('2024-01-15', 2, 'month');
+ *
+ * // Subtract 3 hours
+ * add(new Date(), -3, 'hour');
+ */
+export declare function add(date: Date | string | number, amount: number, unit?: DateUnit): Date;
+/**
+ * Subtract time from a date
+ * @function subtract
+ * @param {Date | string | number} date - Base date
+ * @param {number} amount - Amount to subtract (can be negative to add)
+ * @param {DateUnit} [unit='day'] - Unit of time to subtract
+ * @returns {Date} New date after subtraction
+ * @example
+ * // Subtract 5 days
+ * subtract(new Date(), 5, 'day');
+ *
+ * // Subtract 2 months
+ * subtract('2024-01-15', 2, 'month');
+ */
+export declare function subtract(date: Date | string | number, amount: number, unit?: DateUnit): Date;
+/**
+ * Add days to a date
+ * @function addDays
+ * @param {Date | string | number} date - Base date
+ * @param {number} days - Number of days to add (can be negative)
+ * @returns {Date} New date after adding days
+ * @example
+ * // Add 5 days
+ * addDays(new Date(), 5);
+ *
+ * // Subtract 3 days
+ * addDays('2024-01-15', -3);
+ */
+export declare function addDays(date: Date | string | number, days: number): Date;
+/**
+ * Subtract days from a date
+ * @function subtractDays
+ * @param {Date | string | number} date - Base date
+ * @param {number} days - Number of days to subtract
+ * @returns {Date} New date after subtracting days
+ * @example
+ * // Subtract 5 days
+ * subtractDays(new Date(), 5);
+ */
+export declare function subtractDays(date: Date | string | number, days: number): Date;
+/**
+ * Add months to a date
+ * @function addMonths
+ * @param {Date | string | number} date - Base date
+ * @param {number} months - Number of months to add (can be negative)
+ * @returns {Date} New date after adding months
+ * @example
+ * // Add 2 months
+ * addMonths(new Date(), 2);
+ *
+ * // Subtract 3 months
+ * addMonths('2024-01-15', -3);
+ */
+export declare function addMonths(date: Date | string | number, months: number): Date;
+/**
+ * Subtract months from a date
+ * @function subtractMonths
+ * @param {Date | string | number} date - Base date
+ * @param {number} months - Number of months to subtract
+ * @returns {Date} New date after subtracting months
+ * @example
+ * // Subtract 2 months
+ * subtractMonths(new Date(), 2);
+ */
+export declare function subtractMonths(date: Date | string | number, months: number): Date;
+/**
+ * Add years to a date
+ * @function addYears
+ * @param {Date | string | number} date - Base date
+ * @param {number} years - Number of years to add (can be negative)
+ * @returns {Date} New date after adding years
+ * @example
+ * // Add 1 year
+ * addYears(new Date(), 1);
+ *
+ * // Subtract 5 years
+ * addYears('2024-01-15', -5);
+ */
+export declare function addYears(date: Date | string | number, years: number): Date;
+/**
+ * Subtract years from a date
+ * @function subtractYears
+ * @param {Date | string | number} date - Base date
+ * @param {number} years - Number of years to subtract
+ * @returns {Date} New date after subtracting years
+ * @example
+ * // Subtract 10 years
+ * subtractYears(new Date(), 10);
+ */
+export declare function subtractYears(date: Date | string | number, years: number): Date;
+/**
+ * Get the start of a time unit
+ * @function startOf
+ * @param {Date | string | number} date - Base date
+ * @param {DateUnit} unit - Time unit to get start of
+ * @returns {Date} Date representing the start of the specified unit
+ * @example
+ * // Start of month
+ * startOf(new Date(), 'month');
+ *
+ * // Start of year
+ * startOf('2024-06-15', 'year');
+ *
+ * // Start of week (configurable via weekStartsOn)
+ * startOf(new Date(), 'week');
+ */
+export declare function startOf(date: Date | string | number, unit: DateUnit): Date;
+/**
+ * Get the end of a time unit
+ * @function endOf
+ * @param {Date | string | number} date - Base date
+ * @param {DateUnit} unit - Time unit to get end of
+ * @returns {Date} Date representing the end of the specified unit
+ * @example
+ * // End of month
+ * endOf(new Date(), 'month');
+ *
+ * // End of day (23:59:59.999)
+ * endOf('2024-01-15', 'day');
+ */
+export declare function endOf(date: Date | string | number, unit: DateUnit): Date;
+/**
+ * Get start of day (midnight)
+ * @function startOfDay
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} Date at 00:00:00.000
+ * @example
+ * startOfDay(new Date()); // Returns today at midnight
+ */
+export declare function startOfDay(date: Date | string | number): Date;
+/**
+ * Get end of day (last millisecond)
+ * @function endOfDay
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} Date at 23:59:59.999
+ * @example
+ * endOfDay(new Date()); // Returns today at 23:59:59.999
+ */
+export declare function endOfDay(date: Date | string | number): Date;
+/**
+ * Get start of month
+ * @function startOfMonth
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} First day of month at 00:00:00.000
+ * @example
+ * startOfMonth(new Date()); // Returns first day of current month
+ */
+export declare function startOfMonth(date: Date | string | number): Date;
+/**
+ * Get end of month
+ * @function endOfMonth
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} Last day of month at 23:59:59.999
+ * @example
+ * endOfMonth(new Date()); // Returns last day of current month at 23:59:59.999
+ */
+export declare function endOfMonth(date: Date | string | number): Date;
+/**
+ * Get start of year
+ * @function startOfYear
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} January 1st at 00:00:00.000
+ * @example
+ * startOfYear(new Date()); // Returns January 1st of current year
+ */
+export declare function startOfYear(date: Date | string | number): Date;
+/**
+ * Get end of year
+ * @function endOfYear
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} December 31st at 23:59:59.999
+ * @example
+ * endOfYear(new Date()); // Returns December 31st of current year at 23:59:59.999
+ */
+export declare function endOfYear(date: Date | string | number): Date;
+/**
+ * Get start of week
+ * @function startOfWeek
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} Start of week (configurable via weekStartsOn) at 00:00:00.000
+ * @example
+ * // With weekStartsOn = 0 (Sunday)
+ * startOfWeek(new Date('2024-01-15')); // Returns Sunday, January 14, 2024
+ */
+export declare function startOfWeek(date: Date | string | number): Date;
+/**
+ * Get end of week
+ * @function endOfWeek
+ * @param {Date | string | number} date - Base date
+ * @returns {Date} End of week (configurable via weekStartsOn) at 23:59:59.999
+ * @example
+ * // With weekStartsOn = 0 (Sunday)
+ * endOfWeek(new Date('2024-01-15')); // Returns Saturday, January 20, 2024
+ */
+export declare function endOfWeek(date: Date | string | number): Date;
+/**
+ * Check if a date is between two other dates
+ * @function isBetween
+ * @param {Date | string | number} date - Date to check
+ * @param {Date | string | number} start - Start of range
+ * @param {Date | string | number} end - End of range
+ * @param {boolean} [inclusive=true] - Whether to include boundaries
+ * @returns {boolean} True if date is between start and end
+ * @example
+ * // Check if date is in January 2024
+ * isBetween('2024-01-15', '2024-01-01', '2024-01-31');
+ *
+ * // Exclusive check
+ * isBetween('2024-01-01', '2024-01-01', '2024-01-31', false); // false
+ */
+export declare function isBetween(date: Date | string | number, start: Date | string | number, end: Date | string | number, inclusive?: boolean): boolean;
+/**
+ * Check if a date is before another date
+ * @function isBefore
+ * @param {Date | string | number} date - Date to check
+ * @param {Date | string | number} compareTo - Date to compare against
+ * @returns {boolean} True if date is before compareTo
+ * @example
+ * isBefore('2024-01-15', '2024-01-20'); // true
+ * isBefore('2024-01-20', '2024-01-15'); // false
+ */
+export declare function isBefore(date: Date | string | number, compareTo: Date | string | number): boolean;
+/**
+ * Check if a date is after another date
+ * @function isAfter
+ * @param {Date | string | number} date - Date to check
+ * @param {Date | string | number} compareTo - Date to compare against
+ * @returns {boolean} True if date is after compareTo
+ * @example
+ * isAfter('2024-01-20', '2024-01-15'); // true
+ * isAfter('2024-01-15', '2024-01-20'); // false
+ */
+export declare function isAfter(date: Date | string | number, compareTo: Date | string | number): boolean;
+/**
+ * Check if two dates are the same (optionally by specific unit)
+ * @function isSame
+ * @param {Date | string | number} date1 - First date
+ * @param {Date | string | number} date2 - Second date
+ * @param {DateUnit} [unit] - Unit to compare (if not provided, compares exact timestamps)
+ * @returns {boolean} True if dates are the same
+ * @example
+ * // Exact timestamp comparison
+ * isSame(new Date('2024-01-15T10:30:00'), new Date('2024-01-15T10:30:00')); // true
+ *
+ * // Same day comparison
+ * isSame('2024-01-15T10:30:00', '2024-01-15T15:45:00', 'day'); // true
+ *
+ * // Same month comparison
+ * isSame('2024-01-15', '2024-01-31', 'month'); // true
+ */
+export declare function isSame(date1: Date | string | number, date2: Date | string | number, unit?: DateUnit): boolean;
+/**
+ * Check if a date is today
+ * @function isToday
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is today
+ * @example
+ * isToday(new Date()); // true
+ * isToday('2024-01-15'); // depends on current date
+ */
+export declare function isToday(date: Date | string | number): boolean;
+/**
+ * Check if a date is in the past
+ * @function isPast
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is before now
+ * @example
+ * isPast('2020-01-01'); // true
+ * isPast('2030-01-01'); // false
+ */
+export declare function isPast(date: Date | string | number): boolean;
+/**
+ * Check if a date is in the future
+ * @function isFuture
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is after now
+ * @example
+ * isFuture('2030-01-01'); // true
+ * isFuture('2020-01-01'); // false
+ */
+export declare function isFuture(date: Date | string | number): boolean;
+/**
+ * Calculate the difference between two dates in multiple units
+ * @function difference
+ * @param {Date | string | number} date1 - First date
+ * @param {Date | string | number} date2 - Second date
+ * @returns {DateDifference} Object containing differences in various units
+ * @example
+ * const diff = difference('2024-01-10', '2024-01-15');
+ * console.log(diff.days); // 5
+ * console.log(diff.totalHours); // 120
+ */
+export declare function difference(date1: Date | string | number, date2: Date | string | number): DateDifference;
+/**
+ * Get human-readable description of date difference
+ * @function humanizeDifference
+ * @param {Date | string | number} date1 - First date
+ * @param {Date | string | number} [date2=now()] - Second date (defaults to now)
+ * @param {boolean} [detailed=false] - Whether to use detailed descriptions
+ * @returns {string} Human-readable difference
+ * @example
+ * // Returns something like "2 days ago" or "in 3 hours"
+ * humanizeDifference('2024-01-13');
+ *
+ * // Detailed format
+ * humanizeDifference('2024-01-13', new Date(), true); // "2 days ago"
+ */
+export declare function humanizeDifference(date1: Date | string | number, date2?: Date | string | number, detailed?: boolean): string;
+/**
+ * Check if a date falls on a weekend
+ * @function isWeekend
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is Saturday or Sunday
+ * @example
+ * isWeekend('2024-01-15'); // false (Monday)
+ * isWeekend('2024-01-20'); // true (Saturday)
+ */
+export declare function isWeekend(date: Date | string | number): boolean;
+/**
+ * Check if a date falls on a weekday
+ * @function isWeekday
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is Monday through Friday
+ * @example
+ * isWeekday('2024-01-15'); // true (Monday)
+ * isWeekday('2024-01-20'); // false (Saturday)
+ */
+export declare function isWeekday(date: Date | string | number): boolean;
+/**
+ * Check if a date is a business day (considering weekends and holidays)
+ * @function isBusinessDay
+ * @param {Date | string | number} date - Date to check
+ * @returns {boolean} True if date is a business day
+ * @example
+ * // Assuming Monday-Friday are business days
+ * isBusinessDay('2024-01-15'); // true (Monday)
+ * isBusinessDay('2024-01-20'); // false (Saturday)
+ */
+export declare function isBusinessDay(date: Date | string | number): boolean;
+/**
+ * Add business days to a date (skips weekends and holidays)
+ * @function addBusinessDays
+ * @param {Date | string | number} date - Base date
+ * @param {number} days - Number of business days to add (can be negative)
+ * @returns {Date} New date after adding business days
+ * @example
+ * // Add 3 business days to Friday
+ * addBusinessDays('2024-01-12', 3); // Returns Wednesday, January 17
+ */
+export declare function addBusinessDays(date: Date | string | number, days: number): Date;
+/**
+ * Calculate number of days between two dates
+ * @function daysBetween
+ * @param {Date | string | number} start - Start date
+ * @param {Date | string | number} end - End date
+ * @param {boolean} [inclusive=false] - Whether to include both start and end dates
+ * @returns {number} Number of days between dates
+ * @example
+ * daysBetween('2024-01-10', '2024-01-15'); // 5
+ * daysBetween('2024-01-10', '2024-01-15', true); // 6
+ */
+export declare function daysBetween(start: Date | string | number, end: Date | string | number, inclusive?: boolean): number;
+/**
+ * Calculate number of months between two dates
+ * @function monthsBetween
+ * @param {Date | string | number} start - Start date
+ * @param {Date | string | number} end - End date
+ * @returns {number} Number of months between dates
+ * @example
+ * monthsBetween('2024-01-15', '2024-03-15'); // 2
+ * monthsBetween('2024-01-31', '2024-02-28'); // 1
+ */
+export declare function monthsBetween(start: Date | string | number, end: Date | string | number): number;
+/**
+ * Calculate number of years between two dates
+ * @function yearsBetween
+ * @param {Date | string | number} start - Start date
+ * @param {Date | string | number} end - End date
+ * @returns {number} Number of years between dates
+ * @example
+ * yearsBetween('2020-06-15', '2024-01-15'); // 4
+ */
+export declare function yearsBetween(start: Date | string | number, end: Date | string | number): number;
+/**
+ * Calculate age from birth date
+ * @function getAge
+ * @param {Date | string | number} birthDate - Birth date
+ * @param {Date | string | number} [asOfDate=now()] - Date to calculate age as of
+ * @returns {number} Age in years
+ * @example
+ * getAge('1990-06-15', '2024-01-15'); // 33
+ * getAge('2000-02-29', '2024-02-28'); // 23
+ * getAge('2000-02-29', '2024-02-29'); // 24
+ */
+export declare function getAge(birthDate: Date | string | number, asOfDate?: Date | string | number): number;
+/**
+ * Get ISO week number of year
+ * @function getWeekNumber
+ * @param {Date | string | number} date - Date to check
+ * @returns {number} Week number (1-53)
+ * @example
+ * getWeekNumber('2024-01-01'); // 1
+ * getWeekNumber('2024-01-15'); // 3
+ */
+export declare function getWeekNumber(date: Date | string | number): number;
+/**
+ * Get quarter of year
+ * @function getQuarter
+ * @param {Date | string | number} date - Date to check
+ * @returns {number} Quarter number (1-4)
+ * @example
+ * getQuarter('2024-01-15'); // 1
+ * getQuarter('2024-04-15'); // 2
+ * getQuarter('2024-07-15'); // 3
+ * getQuarter('2024-10-15'); // 4
+ */
+export declare function getQuarter(date: Date | string | number): number;
+/**
+ * Get day name
+ * @function getDayName
+ * @param {Date | string | number} date - Date to check
+ * @param {'full' | 'short'} [format='full'] - Format of day name
+ * @returns {string} Day name
+ * @example
+ * getDayName('2024-01-15'); // "Monday"
+ * getDayName('2024-01-15', 'short'); // "Mon"
+ */
+export declare function getDayName(date: Date | string | number, format?: 'full' | 'short'): string;
+/**
+ * Get month name
+ * @function getMonthName
+ * @param {Date | string | number} date - Date to check
+ * @param {'full' | 'short'} [format='full'] - Format of month name
+ * @returns {string} Month name
+ * @example
+ * getMonthName('2024-01-15'); // "January"
+ * getMonthName('2024-01-15', 'short'); // "Jan"
+ */
+export declare function getMonthName(date: Date | string | number, format?: 'full' | 'short'): string;
+/**
+ * Get number of days in month
+ * @function getDaysInMonth
+ * @param {Date | string | number} date - Date to check
+ * @returns {number} Number of days in month
+ * @example
+ * getDaysInMonth('2024-01-15'); // 31
+ * getDaysInMonth('2024-02-15'); // 29 (leap year)
+ * getDaysInMonth('2023-02-15'); // 28
+ */
+export declare function getDaysInMonth(date: Date | string | number): number;
+/**
+ * Check if year is a leap year
+ * @function isLeapYear
+ * @param {number} year - Year to check
+ * @returns {boolean} True if year is a leap year
+ * @example
+ * isLeapYear(2024); // true
+ * isLeapYear(2023); // false
+ * isLeapYear(2000); // true (century divisible by 400)
+ * isLeapYear(1900); // false (century not divisible by 400)
+ */
+export declare function isLeapYear(year: number): boolean;
+/**
+ * Validate a date with constraints
+ * @function validateDate
+ * @param {Date | string | number} date - Date to validate
+ * @param {ValidationOptions} [options={}] - Validation options
+ * @returns {ValidationResult} Validation result with errors if any
+ * @example
+ * // Simple validation
+ * validateDate('2024-01-15');
+ *
+ * // With constraints
+ * validateDate('2024-01-15', {
+ *   min: '2024-01-01',
+ *   max: '2024-12-31',
+ *   allowPast: false,
+ * });
+ */
+export declare function validateDate(date: Date | string | number, options?: ValidationOptions): ValidationResult;
+/**
+ * Get timezone information for a date
+ * @function getTimezoneInfo
+ * @param {Date | string | number} date - Date to get timezone info for
+ * @returns {TimezoneInfo} Timezone information
+ * @example
+ * const info = getTimezoneInfo(new Date());
+ * console.log(info.name); // "America/New_York"
+ * console.log(info.offsetString); // "UTC-05:00"
+ */
+export declare function getTimezoneInfo(date: Date | string | number): TimezoneInfo;
+/**
+ * Convert date to another timezone
+ * @function convertTimezone
+ * @param {Date | string | number} date - Date to convert
+ * @param {string} targetTimezone - Target timezone (e.g., 'America/New_York', 'UTC')
+ * @returns {Date} Date converted to target timezone
+ * @example
+ * // Convert to UTC
+ * convertTimezone(new Date(), 'UTC');
+ *
+ * // Convert to New York time
+ * convertTimezone('2024-01-15T10:30:00Z', 'America/New_York');
+ */
+export declare function convertTimezone(date: Date | string | number, targetTimezone: string): Date;
+//# sourceMappingURL=date.d.ts.map