123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869 |
- import type {
- ContextOptions,
- Interval,
- LocalizedOptions,
- StepOptions,
- WeekOptions,
- } from "./types.js";
- /**
- * The {@link eachWeekOfInterval} function options.
- */
- export interface EachWeekOfIntervalOptions<DateType extends Date = Date>
- extends StepOptions,
- WeekOptions,
- LocalizedOptions<"options">,
- ContextOptions<DateType> {}
- /**
- * The {@link eachWeekOfInterval} function result type. It resolves the proper data type.
- * It uses the first argument date object type, starting from the interval start date,
- * then the end interval date. If a context function is passed, it uses the context function return type.
- */
- export type EachWeekOfIntervalResult<
- IntervalType extends Interval,
- Options extends EachWeekOfIntervalOptions | undefined,
- > = Array<
- Options extends EachWeekOfIntervalOptions<infer DateType>
- ? DateType
- : IntervalType["start"] extends Date
- ? IntervalType["start"]
- : IntervalType["end"] extends Date
- ? IntervalType["end"]
- : Date
- >;
- /**
- * @name eachWeekOfInterval
- * @category Interval Helpers
- * @summary Return the array of weeks within the specified time interval.
- *
- * @description
- * Return the array of weeks within the specified time interval.
- *
- * @param interval - The interval.
- * @param options - An object with options.
- *
- * @returns The array with starts of weeks from the week of the interval start to the week of the interval end
- *
- * @example
- * // Each week within interval 6 October 2014 - 23 November 2014:
- * const result = eachWeekOfInterval({
- * start: new Date(2014, 9, 6),
- * end: new Date(2014, 10, 23)
- * })
- * //=> [
- * // Sun Oct 05 2014 00:00:00,
- * // Sun Oct 12 2014 00:00:00,
- * // Sun Oct 19 2014 00:00:00,
- * // Sun Oct 26 2014 00:00:00,
- * // Sun Nov 02 2014 00:00:00,
- * // Sun Nov 09 2014 00:00:00,
- * // Sun Nov 16 2014 00:00:00,
- * // Sun Nov 23 2014 00:00:00
- * // ]
- */
- export declare function eachWeekOfInterval<
- IntervalType extends Interval,
- Options extends EachWeekOfIntervalOptions | undefined = undefined,
- >(
- interval: IntervalType,
- options?: Options,
- ): EachWeekOfIntervalResult<IntervalType, Options>;
|