@gobrand/tiempo 2.9.1 → 2.10.0

package/dist/differenceInMonths.js

@@ -1,8 +1,8 @@
 import {
   differenceInMonths
-} from "./chunk-OVFO6CZ7.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-CIA46DWB.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   differenceInMonths
 };

package/dist/differenceInNanoseconds.js

@@ -1,8 +1,8 @@
 import {
   differenceInNanoseconds
-} from "./chunk-VBDGWVJ4.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-VC7RTDJP.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   differenceInNanoseconds
 };

package/dist/differenceInQuarters.d.ts

@@ -0,0 +1,37 @@
+import type { Temporal } from "@js-temporal/polyfill";
+import type { DifferenceOptions } from "./shared/differenceOptions";
+/**
+ * Returns the number of quarters (3-month blocks) between two datetimes.
+ * The result is positive if laterDate is after earlierDate, negative if before.
+ *
+ * This function uses calendar-aware calculation, which means it properly handles
+ * months with different numbers of days (28, 29, 30, or 31).
+ *
+ * Instant inputs are converted to UTC for calendar calculations.
+ * For ZonedDateTime inputs, their timezone is preserved.
+ *
+ * @param laterDate - The later datetime (Instant or ZonedDateTime)
+ * @param earlierDate - The earlier datetime (Instant or ZonedDateTime)
+ * @param options - Optional { fractional } to return the precise value
+ * @returns The number of quarters between the dates, truncated toward zero (pass { fractional: true } for the precise value)
+ *
+ * @example
+ * ```ts
+ * const later = Temporal.Instant.from('2025-07-20T12:00:00Z');
+ * const earlier = Temporal.Instant.from('2025-01-20T12:00:00Z');
+ *
+ * differenceInQuarters(later, earlier); // 2
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Pass { fractional: true } for partial-unit precision
+ * const later = Temporal.Instant.from('2025-03-20T12:00:00Z');
+ * const earlier = Temporal.Instant.from('2025-01-20T12:00:00Z');
+ *
+ * differenceInQuarters(later, earlier);                     // 0
+ * differenceInQuarters(later, earlier, { fractional: true }); // ~0.67
+ * ```
+ */
+export declare function differenceInQuarters(laterDate: Temporal.Instant | Temporal.ZonedDateTime, earlierDate: Temporal.Instant | Temporal.ZonedDateTime, options?: DifferenceOptions): number;
+//# sourceMappingURL=differenceInQuarters.d.ts.map

package/dist/differenceInQuarters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differenceInQuarters.d.ts","sourceRoot":"","sources":["../src/differenceInQuarters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACpD,WAAW,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACtD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAIR"}

package/dist/differenceInQuarters.js

@@ -0,0 +1,10 @@
+import {
+  differenceInQuarters
+} from "./chunk-VUKOSQWW.js";
+import "./chunk-CIA46DWB.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  differenceInQuarters
+};
+//# sourceMappingURL=differenceInQuarters.js.map

package/dist/differenceInQuarters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/differenceInQuarters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=differenceInQuarters.test.d.ts.map

package/dist/differenceInQuarters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differenceInQuarters.test.d.ts","sourceRoot":"","sources":["../src/differenceInQuarters.test.ts"],"names":[],"mappings":""}

package/dist/differenceInSeconds.js

@@ -1,9 +1,9 @@
 import {
   differenceInSeconds
-} from "./chunk-TUOGC2TY.js";
+} from "./chunk-EBVLBLR3.js";
 import "./chunk-VXOQ7IG5.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   differenceInSeconds
 };

package/dist/differenceInWeeks.js

@@ -1,8 +1,8 @@
 import {
   differenceInWeeks
-} from "./chunk-EOXULNBC.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-LODULPI3.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   differenceInWeeks
 };

package/dist/differenceInYears.js

@@ -1,8 +1,8 @@
 import {
   differenceInYears
-} from "./chunk-X3T7QMBA.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-DCCHY45G.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   differenceInYears
 };

package/dist/eachDayOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachDayOfInterval
-} from "./chunk-JTANYFEV.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-567DXBLA.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachDayOfInterval
 };

package/dist/eachHourOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachHourOfInterval
-} from "./chunk-4JPVE6OV.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-JK4WDDWU.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachHourOfInterval
 };

package/dist/eachMinuteOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachMinuteOfInterval
-} from "./chunk-LOANS6ZE.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-MM2HIW7M.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachMinuteOfInterval
 };

package/dist/eachMonthOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachMonthOfInterval
-} from "./chunk-26VAIV6A.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-ZGWLIISB.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachMonthOfInterval
 };

package/dist/eachQuarterOfInterval.d.ts

@@ -0,0 +1,47 @@
+import { Temporal } from "./shared/temporal";
+/**
+ * Returns an array of ZonedDateTime objects for each quarter within the interval.
+ * Each element represents the first moment of the quarter (day 1 of the quarter's
+ * starting month at midnight). The interval is inclusive of both start and end quarters.
+ *
+ * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
+ *
+ * For Instant inputs, UTC is used as the timezone.
+ * For ZonedDateTime inputs, the timezone of the start date is preserved.
+ *
+ * @param interval - The interval with start and end datetimes
+ * @returns Array of ZonedDateTime at start of each quarter in the interval
+ *
+ * @example
+ * ```ts
+ * const start = Temporal.ZonedDateTime.from('2025-02-15T10:00:00Z[UTC]');
+ * const end = Temporal.ZonedDateTime.from('2025-11-20T14:00:00Z[UTC]');
+ *
+ * const quarters = eachQuarterOfInterval({ start, end });
+ * // [
+ * //   2025-01-01T00:00:00Z[UTC], // Q1
+ * //   2025-04-01T00:00:00Z[UTC], // Q2
+ * //   2025-07-01T00:00:00Z[UTC], // Q3
+ * //   2025-10-01T00:00:00Z[UTC]  // Q4
+ * // ]
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Cross-year boundary
+ * const start = Temporal.ZonedDateTime.from('2024-11-15T00:00:00Z[UTC]');
+ * const end = Temporal.ZonedDateTime.from('2025-05-15T00:00:00Z[UTC]');
+ *
+ * const quarters = eachQuarterOfInterval({ start, end });
+ * // [
+ * //   2024-10-01T00:00:00Z[UTC], // Q4 2024
+ * //   2025-01-01T00:00:00Z[UTC], // Q1 2025
+ * //   2025-04-01T00:00:00Z[UTC]  // Q2 2025
+ * // ]
+ * ```
+ */
+export declare function eachQuarterOfInterval(interval: {
+    start: Temporal.Instant | Temporal.ZonedDateTime;
+    end: Temporal.Instant | Temporal.ZonedDateTime;
+}): Temporal.ZonedDateTime[];
+//# sourceMappingURL=eachQuarterOfInterval.d.ts.map

package/dist/eachQuarterOfInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eachQuarterOfInterval.d.ts","sourceRoot":"","sources":["../src/eachQuarterOfInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;IACjD,GAAG,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;CAChD,GAAG,QAAQ,CAAC,aAAa,EAAE,CAkC3B"}

package/dist/eachQuarterOfInterval.js

@@ -0,0 +1,10 @@
+import {
+  eachQuarterOfInterval
+} from "./chunk-6UBZ5YB3.js";
+import "./chunk-XS2HUADA.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  eachQuarterOfInterval
+};
+//# sourceMappingURL=eachQuarterOfInterval.js.map

package/dist/eachQuarterOfInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/eachQuarterOfInterval.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eachQuarterOfInterval.test.d.ts.map

package/dist/eachQuarterOfInterval.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eachQuarterOfInterval.test.d.ts","sourceRoot":"","sources":["../src/eachQuarterOfInterval.test.ts"],"names":[],"mappings":""}

package/dist/eachWeekOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachWeekOfInterval
-} from "./chunk-4N6CTX4N.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-UTN7ZKL4.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachWeekOfInterval
 };

package/dist/eachYearOfInterval.js

@@ -1,8 +1,8 @@
 import {
   eachYearOfInterval
-} from "./chunk-VDEZJB42.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-DCFRBZBY.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   eachYearOfInterval
 };

package/dist/endOfDay.js

@@ -1,11 +1,11 @@
 import {
   endOfDay
-} from "./chunk-E2MU2P66.js";
-import "./chunk-TWZNSMKO.js";
+} from "./chunk-7HUJC5M6.js";
 import "./chunk-AVGNRINZ.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   endOfDay
 };

package/dist/endOfMonth.js

@@ -1,11 +1,11 @@
 import {
   endOfMonth
-} from "./chunk-BO5WXWO2.js";
-import "./chunk-TWZNSMKO.js";
+} from "./chunk-VCWP3CZE.js";
 import "./chunk-AVGNRINZ.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   endOfMonth
 };

package/dist/endOfQuarter.d.ts

@@ -0,0 +1,38 @@
+import { Temporal } from "./shared/temporal";
+import type { Timezone } from "./types";
+/**
+ * Returns a ZonedDateTime representing the last moment of the quarter
+ * (last day of the quarter's ending month at 23:59:59.999999999).
+ *
+ * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @returns ZonedDateTime at the last day of the quarter at 23:59:59.999999999
+ *
+ * @example
+ * ```ts
+ * // From Instant (always UTC)
+ * const instant = Temporal.Instant.from('2025-05-15T12:00:00Z');
+ * const end = endOfQuarter(instant);
+ * // 2025-06-30T23:59:59.999999999Z[UTC]
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From ZonedDateTime (uses its timezone)
+ * const zoned = Temporal.ZonedDateTime.from('2025-02-15T15:30:00-05:00[America/New_York]');
+ * const end = endOfQuarter(zoned);
+ * // 2025-03-31T23:59:59.999999999-04:00[America/New_York]
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate (requires timezone)
+ * const date = Temporal.PlainDate.from('2025-11-15');
+ * const end = endOfQuarter(date, 'America/New_York');
+ * // 2025-12-31T23:59:59.999999999-05:00[America/New_York]
+ * ```
+ */
+export declare function endOfQuarter(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function endOfQuarter(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
+//# sourceMappingURL=endOfQuarter.d.ts.map

package/dist/endOfQuarter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endOfQuarter.d.ts","sourceRoot":"","sources":["../src/endOfQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC"}

package/dist/endOfQuarter.js

@@ -0,0 +1,13 @@
+import {
+  endOfQuarter
+} from "./chunk-SPK7C7RP.js";
+import "./chunk-XS2HUADA.js";
+import "./chunk-AVGNRINZ.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  endOfQuarter
+};
+//# sourceMappingURL=endOfQuarter.js.map

package/dist/endOfQuarter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/endOfQuarter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endOfQuarter.test.d.ts.map

package/dist/endOfQuarter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endOfQuarter.test.d.ts","sourceRoot":"","sources":["../src/endOfQuarter.test.ts"],"names":[],"mappings":""}

package/dist/endOfWeek.js

@@ -1,10 +1,10 @@
 import {
   endOfWeek
-} from "./chunk-ZSOH7VST.js";
+} from "./chunk-PVOGE6ME.js";
 import "./chunk-AVGNRINZ.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   endOfWeek
 };

package/dist/endOfYear.js

@@ -1,11 +1,11 @@
 import {
   endOfYear
-} from "./chunk-C4UZJHM7.js";
-import "./chunk-TWZNSMKO.js";
+} from "./chunk-KN45BU3W.js";
 import "./chunk-AVGNRINZ.js";
-import "./chunk-AHBTUFRW.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   endOfYear
 };

package/dist/format.js

@@ -1,8 +1,8 @@
 import {
   format
-} from "./chunk-IV47GMAA.js";
-import "./chunk-65RGM7EG.js";
-import "./chunk-AI5MRREC.js";
+} from "./chunk-BEGD73DT.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   format
 };

package/dist/formatPlainDate.js

@@ -1,7 +1,7 @@
 import {
   formatPlainDate
 } from "./chunk-PXF3RMFH.js";
-import "./chunk-AI5MRREC.js";
+import "./chunk-R7ZCA6AQ.js";
 export {
   formatPlainDate
 };

package/dist/getQuarter.d.ts

@@ -0,0 +1,38 @@
+import type { Temporal } from "@js-temporal/polyfill";
+import type { Timezone } from "./types";
+/**
+ * Returns the quarter (1-4) that a datetime falls in.
+ *
+ * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
+ *
+ * Instant inputs are interpreted in UTC. For ZonedDateTime inputs, their
+ * timezone is used. For PlainDate inputs, a timezone is required for a
+ * consistent input contract (the quarter itself is timezone-independent).
+ *
+ * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @returns The quarter number: 1, 2, 3, or 4
+ *
+ * @example
+ * ```ts
+ * // From Instant (always UTC)
+ * const instant = Temporal.Instant.from('2025-05-15T12:00:00Z');
+ * getQuarter(instant); // 2
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From ZonedDateTime (uses its timezone)
+ * const zoned = Temporal.ZonedDateTime.from('2025-11-15T15:30:00-05:00[America/New_York]');
+ * getQuarter(zoned); // 4
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate (requires timezone)
+ * const date = Temporal.PlainDate.from('2025-02-15');
+ * getQuarter(date, 'America/New_York'); // 1
+ * ```
+ */
+export declare function getQuarter(input: Temporal.Instant | Temporal.ZonedDateTime): 1 | 2 | 3 | 4;
+export declare function getQuarter(input: Temporal.PlainDate, timezone: Timezone): 1 | 2 | 3 | 4;
+//# sourceMappingURL=getQuarter.d.ts.map

package/dist/getQuarter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQuarter.d.ts","sourceRoot":"","sources":["../src/getQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5F,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/getQuarter.js

@@ -0,0 +1,12 @@
+import {
+  getQuarter
+} from "./chunk-NOV3D7OM.js";
+import "./chunk-XS2HUADA.js";
+import "./chunk-ZOHYNJUD.js";
+import "./chunk-L5AMAEWX.js";
+import "./chunk-NTMT5XGC.js";
+import "./chunk-R7ZCA6AQ.js";
+export {
+  getQuarter
+};
+//# sourceMappingURL=getQuarter.js.map

package/dist/getQuarter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/getQuarter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getQuarter.test.d.ts.map

package/dist/getQuarter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQuarter.test.d.ts","sourceRoot":"","sources":["../src/getQuarter.test.ts"],"names":[],"mappings":""}