@checkdigit/time 3.0.0-PR.17-5aaf → 4.0.0-PR.18-81a3

package/dist-types/date-fns/nextSaturday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the next Saturday?
  *
- * @param date - the date to start counting from
- * @returns the next Saturday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The next Saturday
  *
  * @example
  * // When is the next Saturday after Mar, 22, 2020?
  * const result = nextSaturday(new Date(2020, 2, 22))
  * //=> Sat Mar 28 2020 00:00:00
  */
-export default function nextSaturday<DateType extends Date>(date: DateType | number): DateType;
+export declare function nextSaturday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/nextSunday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the next Sunday?
  *
- * @param date - the date to start counting from
- * @returns the next Sunday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The next Sunday
  *
  * @example
  * // When is the next Sunday after Mar, 22, 2020?
  * const result = nextSunday(new Date(2020, 2, 22))
  * //=> Sun Mar 29 2020 00:00:00
  */
-export default function nextSunday<DateType extends Date>(date: DateType | number): DateType;
+export declare function nextSunday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/nextThursday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the next Thursday?
  *
- * @param date - the date to start counting from
- * @returns the next Thursday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The next Thursday
  *
  * @example
  * // When is the next Thursday after Mar, 22, 2020?
  * const result = nextThursday(new Date(2020, 2, 22))
  * //=> Thur Mar 26 2020 00:00:00
  */
-export default function nextThursday<DateType extends Date>(date: DateType | number): DateType;
+export declare function nextThursday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/nextTuesday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the next Tuesday?
  *
- * @param date - the date to start counting from
- * @returns the next Tuesday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The next Tuesday
  *
  * @example
  * // When is the next Tuesday after Mar, 22, 2020?
  * const result = nextTuesday(new Date(2020, 2, 22))
  * //=> Tue Mar 24 2020 00:00:00
  */
-export default function nextTuesday<DateType extends Date>(date: DateType | number): DateType;
+export declare function nextTuesday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/nextWednesday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the next Wednesday?
  *
- * @param date - the date to start counting from
- * @returns the next Wednesday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The next Wednesday
  *
  * @example
  * // When is the next Wednesday after Mar, 22, 2020?
  * const result = nextWednesday(new Date(2020, 2, 22))
  * //=> Wed Mar 25 2020 00:00:00
  */
-export default function nextWednesday<DateType extends Date>(date: DateType | number): DateType;
+export declare function nextWednesday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/parse/_lib/types.d.ts

@@ -1,9 +1,9 @@
-import type { LocaleOptions, FirstWeekContainsDateOptions, WeekStartOptions } from '../../types';
+import type { LocalizedOptions, FirstWeekContainsDateOptions, WeekOptions } from '../../types';
 export interface ParseFlags {
     timestampIsSet?: boolean;
     era?: number;
 }
-export type ParserOptions = Required<LocaleOptions & FirstWeekContainsDateOptions & WeekStartOptions>;
+export type ParserOptions = Required<LocalizedOptions<'options'> & FirstWeekContainsDateOptions & WeekOptions>;
 export type ParseResult<TValue> = {
     value: TValue;
     rest: string;

package/dist-types/date-fns/parse/index.d.ts

@@ -1,8 +1,11 @@
-import type { AdditionalTokensOptions, FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../types';
+import type { AdditionalTokensOptions, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from '../types';
+import { longFormatters } from '../_lib/format/longFormatters/index';
+import { parsers } from './_lib/parsers/index';
+export { longFormatters, parsers };
 /**
  * The {@link parse} function options.
  */
-export interface ParseOptions extends LocaleOptions, FirstWeekContainsDateOptions, WeekStartOptions, AdditionalTokensOptions {
+export interface ParseOptions extends LocalizedOptions<'options' | 'match' | 'formatLong'>, FirstWeekContainsDateOptions, WeekOptions, AdditionalTokensOptions {
 }
 /**
  * @name parse
@@ -224,8 +227,8 @@ export interface ParseOptions extends LocaleOptions, FirstWeekContainsDateOption
  *
  *    The same difference is true for local and ISO week-numbering years (`Y` and `R`),
  *    except local week-numbering years are dependent on `options.weekStartsOn`
- *    and `options.firstWeekContainsDate` (compare [setISOWeekYear]{@link https://date-fns.org/docs/setISOWeekYear}
- *    and [setWeekYear]{@link https://date-fns.org/docs/setWeekYear}).
+ *    and `options.firstWeekContainsDate` (compare [setISOWeekYear](https://date-fns.org/docs/setISOWeekYear)
+ *    and [setWeekYear](https://date-fns.org/docs/setWeekYear)).
  *
  * 5. These patterns are not in the Unicode Technical Standard #35:
  *    - `i`: ISO day of week
@@ -270,19 +273,23 @@ export interface ParseOptions extends LocaleOptions, FirstWeekContainsDateOption
  * Invalid Date is a Date, whose time value is NaN.
  * Time value of Date: http://es5.github.io/#x15.9.1.1
  *
- * @param dateString - the string to parse
- * @param formatString - the string of tokens
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param dateStr - The string to parse
+ * @param formatStr - The string of tokens
  * @param referenceDate - defines values missing from the parsed dateString
- * @param options - an object with options.
+ * @param options - An object with options.
  *   see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
  *   see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
- * @returns the parsed date
- * @throws {RangeError} `options.locale` must contain `match` property
- * @throws {RangeError} use `yyyy` instead of `YYYY` for formatting years using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
- * @throws {RangeError} use `yy` instead of `YY` for formatting years using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
- * @throws {RangeError} use `d` instead of `D` for formatting days of the month using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
- * @throws {RangeError} use `dd` instead of `DD` for formatting days of the month using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
- * @throws {RangeError} format string contains an unescaped latin alphabet character
+ *
+ * @returns The parsed date
+ *
+ * @throws `options.locale` must contain `match` property
+ * @throws use `yyyy` instead of `YYYY` for formatting years using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
+ * @throws use `yy` instead of `YY` for formatting years using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
+ * @throws use `d` instead of `D` for formatting days of the month using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
+ * @throws use `dd` instead of `DD` for formatting days of the month using [format provided] to the input [input provided]; see: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
+ * @throws format string contains an unescaped latin alphabet character
  *
  * @example
  * // Parse 11 February 2014 from middle-endian format:
@@ -297,4 +304,4 @@ export interface ParseOptions extends LocaleOptions, FirstWeekContainsDateOption
  * })
  * //=> Sun Feb 28 2010 00:00:00
  */
-export default function parse<DateType extends Date>(dateString: string, formatString: string, dirtyReferenceDate: DateType | number, options?: ParseOptions): DateType;
+export declare function parse<DateType extends Date>(dateStr: string, formatStr: string, referenceDate: DateType | number | string, options?: ParseOptions): DateType;

package/dist-types/date-fns/parseISO/index.d.ts

@@ -2,6 +2,7 @@
  * The {@link parseISO} function options.
  */
 export interface ParseISOOptions {
+    /** The additional number of digits in the extended year format */
     additionalDigits?: 0 | 1 | 2;
 }
 /**
@@ -18,9 +19,12 @@ export interface ParseISOOptions {
  * If the argument isn't a string, the function cannot parse the string or
  * the values are invalid, it returns Invalid Date.
  *
- * @param argument - the value to convert
- * @param options - an object with options.
- * @returns the parsed date in the local time zone
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param argument - The value to convert
+ * @param options - An object with options
+ *
+ * @returns The parsed date in the local time zone
  *
  * @example
  * // Convert string '2014-02-11T11:30:30' to date:
@@ -33,4 +37,4 @@ export interface ParseISOOptions {
  * const result = parseISO('+02014101', { additionalDigits: 1 })
  * //=> Fri Apr 11 2014 00:00:00
  */
-export default function parseISO(argument: string, options?: ParseISOOptions): Date;
+export declare function parseISO(argument: string, options?: ParseISOOptions): Date;

package/dist-types/date-fns/parseJSON/index.d.ts

@@ -21,14 +21,15 @@
  * - `2000-03-15 05:20:10`: With a space instead of a 'T' separator for APIs returning a SQL date without reformatting
  *
  * For convenience and ease of use these other input types are also supported
- * via [toDate]{@link https://date-fns.org/docs/toDate}:
+ * via [toDate](https://date-fns.org/docs/toDate):
  *
  * - A `Date` instance will be cloned
  * - A `number` will be treated as a timestamp
  *
  * Any other input type or invalid date strings will return an `Invalid Date`.
  *
- * @param argument A fully formed ISO8601 date string to convert
- * @returns the parsed date in the local time zone
+ * @param dateStr - A fully formed ISO8601 date string to convert
+ *
+ * @returns The parsed date in the local time zone
  */
-export default function parseJSON(dateString: string): Date;
+export declare function parseJSON(dateStr: string): Date;

package/dist-types/date-fns/previousDay/index.d.ts

@@ -7,9 +7,12 @@ import type { Day } from '../types';
  * @description
  * When is the previous day of the week? 0-6 the day of the week, 0 represents Sunday.
  *
- * @param date - the date to check
- * @param day - day of the week
- * @returns - the date is the previous day of week
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to check
+ * @param day - The day of the week
+ *
+ * @returns The date is the previous day of week
  *
  * @example
  * // When is the previous Monday before Mar, 20, 2020?
@@ -21,4 +24,4 @@ import type { Day } from '../types';
  * const result = previousDay(new Date(2020, 2, 21), 2)
  * //=> Tue Mar 17 2020 00:00:00
  */
-export default function previousDay<DateType extends Date>(date: DateType | number, day: Day): DateType;
+export declare function previousDay<DateType extends Date>(date: DateType | number | string, day: Day): DateType;

package/dist-types/date-fns/previousFriday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Friday?
  *
- * @param date - the date to start counting from
- * @returns the previous Friday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Friday
  *
  * @example
  * // When is the previous Friday before Jun, 19, 2021?
  * const result = previousFriday(new Date(2021, 5, 19))
  * //=> Fri June 18 2021 00:00:00
  */
-export default function previousFriday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousFriday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousMonday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Monday?
  *
- * @param date - the date to start counting from
- * @returns the previous Monday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Monday
  *
  * @example
  * // When is the previous Monday before Jun, 18, 2021?
  * const result = previousMonday(new Date(2021, 5, 18))
  * //=> Mon June 14 2021 00:00:00
  */
-export default function previousMonday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousMonday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousSaturday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Saturday?
  *
- * @param date - the date to start counting from
- * @returns the previous Saturday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Saturday
  *
  * @example
  * // When is the previous Saturday before Jun, 20, 2021?
  * const result = previousSaturday(new Date(2021, 5, 20))
  * //=> Sat June 19 2021 00:00:00
  */
-export default function previousSaturday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousSaturday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousSunday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Sunday?
  *
- * @param date - the date to start counting from
- * @returns the previous Sunday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Sunday
  *
  * @example
  * // When is the previous Sunday before Jun, 21, 2021?
  * const result = previousSunday(new Date(2021, 5, 21))
  * //=> Sun June 20 2021 00:00:00
  */
-export default function previousSunday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousSunday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousThursday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Thursday?
  *
- * @param date - the date to start counting from
- * @returns the previous Thursday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Thursday
  *
  * @example
  * // When is the previous Thursday before Jun, 18, 2021?
  * const result = previousThursday(new Date(2021, 5, 18))
  * //=> Thu June 17 2021 00:00:00
  */
-export default function previousThursday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousThursday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousTuesday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Tuesday?
  *
- * @param date - the date to start counting from
- * @returns the previous Tuesday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Tuesday
  *
  * @example
  * // When is the previous Tuesday before Jun, 18, 2021?
  * const result = previousTuesday(new Date(2021, 5, 18))
  * //=> Tue June 15 2021 00:00:00
  */
-export default function previousTuesday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousTuesday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/previousWednesday/index.d.ts

@@ -6,12 +6,15 @@
  * @description
  * When is the previous Wednesday?
  *
- * @param date - the date to start counting from
- * @returns the previous Wednesday
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to start counting from
+ *
+ * @returns The previous Wednesday
  *
  * @example
  * // When is the previous Wednesday before Jun, 18, 2021?
  * const result = previousWednesday(new Date(2021, 5, 18))
  * //=> Wed June 16 2021 00:00:00
  */
-export default function previousWednesday<DateType extends Date>(date: DateType | number): DateType;
+export declare function previousWednesday<DateType extends Date>(date: DateType | number | string): DateType;

package/dist-types/date-fns/quartersToMonths/index.d.ts

@@ -6,13 +6,15 @@
  * @description
  * Convert a number of quarters to a full number of months.
  *
- * @param quarters - number of quarters to be converted
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
  *
- * @returns the number of quarters converted in months
+ * @param quarters - The number of quarters to be converted
+ *
+ * @returns The number of quarters converted in months
  *
  * @example
  * // Convert 2 quarters to months
  * const result = quartersToMonths(2)
  * //=> 6
  */
-export default function quartersToMonths(quarters: number): number;
+export declare function quartersToMonths(quarters: number): number;

package/dist-types/date-fns/quartersToYears/index.d.ts

@@ -6,9 +6,11 @@
  * @description
  * Convert a number of quarters to a full number of years.
  *
- * @param quarters - number of quarters to be converted
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
  *
- * @returns the number of quarters converted in years
+ * @param quarters - The number of quarters to be converted
+ *
+ * @returns The number of quarters converted in years
  *
  * @example
  * // Convert 8 quarters to years
@@ -20,4 +22,4 @@
  * const result = quartersToYears(11)
  * //=> 2
  */
-export default function quartersToYears(quarters: number): number;
+export declare function quartersToYears(quarters: number): number;

package/dist-types/date-fns/roundToNearestHours/index.d.ts

@@ -0,0 +1,48 @@
+import type { NearestHours, NearestToUnitOptions, RoundingOptions } from '../types';
+/**
+ * The {@link roundToNearestHours} function options.
+ */
+export interface RoundToNearestHoursOptions extends NearestToUnitOptions<NearestHours>, RoundingOptions {
+}
+/**
+ * @name roundToNearestHours
+ * @category Hour Helpers
+ * @summary Rounds the given date to the nearest hour
+ *
+ * @description
+ * Rounds the given date to the nearest hour (or number of hours).
+ * Rounds up when the given date is exactly between the nearest round hours.
+ *
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to round
+ * @param options - An object with options.
+ *
+ * @returns The new date rounded to the closest hour
+ *
+ * @example
+ * // Round 10 July 2014 12:34:56 to nearest hour:
+ * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56))
+ * //=> Thu Jul 10 2014 13:00:00
+ *
+ * @example
+ * // Round 10 July 2014 12:34:56 to nearest half hour:
+ * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { nearestTo: 6 })
+ * //=> Thu Jul 10 2014 12:00:00
+
+ * @example
+ * // Round 10 July 2014 12:34:56 to nearest half hour:
+ * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { nearestTo: 8 })
+ * //=> Thu Jul 10 2014 16:00:00
+
+* @example
+ * // Floor (rounds down) 10 July 2014 12:34:56 to nearest hour:
+ * const result = roundToNearestHours(new Date(2014, 6, 10, 1, 23, 45), { roundingMethod: 'ceil' })
+ * //=> Thu Jul 10 2014 02:00:00
+ *
+ * @example
+ * // Ceil (rounds up) 10 July 2014 12:34:56 to nearest quarter hour:
+ * const result = roundToNearestHours(new Date(2014, 6, 10, 12, 34, 56), { roundingMethod: 'floor', nearestTo: 8 })
+ * //=> Thu Jul 10 2014 08:00:00
+ */
+export declare function roundToNearestHours<DateType extends Date>(date: DateType | number | string, options?: RoundToNearestHoursOptions): Date;

package/dist-types/date-fns/roundToNearestMinutes/index.d.ts

@@ -1,9 +1,8 @@
-import type { RoundingOptions } from '../types';
+import type { NearestMinutes, NearestToUnitOptions, RoundingOptions } from '../types';
 /**
  * The {@link roundToNearestMinutes} function options.
  */
-export interface RoundToNearestMinutesOptions extends RoundingOptions {
-    nearestTo?: number;
+export interface RoundToNearestMinutesOptions extends NearestToUnitOptions<NearestMinutes>, RoundingOptions {
 }
 /**
  * @name roundToNearestMinutes
@@ -14,10 +13,12 @@ export interface RoundToNearestMinutesOptions extends RoundingOptions {
  * Rounds the given date to the nearest minute (or number of minutes).
  * Rounds up when the given date is exactly between the nearest round minutes.
  *
- * @param date - the date to round
- * @param options - an object with options.
- * @returns the new date rounded to the closest minute
- * @throws {RangeError} `options.nearestTo` must be between 1 and 30
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to round
+ * @param options - An object with options.
+ *
+ * @returns The new date rounded to the closest minute
  *
  * @example
  * // Round 10 July 2014 12:12:34 to nearest minute:
@@ -25,9 +26,18 @@ export interface RoundToNearestMinutesOptions extends RoundingOptions {
  * //=> Thu Jul 10 2014 12:13:00
  *
  * @example
- * // Round 10 July 2014 12:07:30 to nearest quarter hour:
+ * // Round 10 July 2014 12:12:34 to nearest quarter hour:
  * const result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34), { nearestTo: 15 })
- * // rounds up because given date is exactly between 12:00:00 and 12:15:00
  * //=> Thu Jul 10 2014 12:15:00
+ *
+ * @example
+ * // Floor (rounds down) 10 July 2014 12:12:34 to nearest minute:
+ * const result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34), { roundingMethod: 'floor' })
+ * //=> Thu Jul 10 2014 12:12:00
+ *
+ * @example
+ * // Ceil (rounds up) 10 July 2014 12:12:34 to nearest half hour:
+ * const result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34), { roundingMethod: 'ceil', nearestTo: 30 })
+ * //=> Thu Jul 10 2014 12:30:00
  */
-export default function roundToNearestMinutes<DateType extends Date>(dirtyDate: DateType | number, options?: RoundToNearestMinutesOptions): DateType;
+export declare function roundToNearestMinutes<DateType extends Date>(date: DateType | number | string, options?: RoundToNearestMinutesOptions): DateType;

package/dist-types/date-fns/secondsToHours/index.d.ts

@@ -6,9 +6,9 @@
  * @description
  * Convert a number of seconds to a full number of hours.
  *
- * @param seconds - number of seconds to be converted
+ * @param seconds - The number of seconds to be converted
  *
- * @returns the number of seconds converted in hours
+ * @returns The number of seconds converted in hours
  *
  * @example
  * // Convert 7200 seconds into hours
@@ -20,4 +20,4 @@
  * const result = secondsToHours(7199)
  * //=> 1
  */
-export default function secondsToHours(seconds: number): number;
+export declare function secondsToHours(seconds: number): number;

package/dist-types/date-fns/secondsToMilliseconds/index.d.ts

@@ -6,13 +6,13 @@
  * @description
  * Convert a number of seconds to a full number of milliseconds.
  *
- * @param seconds - number of seconds to be converted
+ * @param seconds - The number of seconds to be converted
  *
- * @returns the number of seconds converted in milliseconds
+ * @returns The number of seconds converted in milliseconds
  *
  * @example
  * // Convert 2 seconds into milliseconds
  * const result = secondsToMilliseconds(2)
  * //=> 2000
  */
-export default function secondsToMilliseconds(seconds: number): number;
+export declare function secondsToMilliseconds(seconds: number): number;

package/dist-types/date-fns/secondsToMinutes/index.d.ts

@@ -6,9 +6,9 @@
  * @description
  * Convert a number of seconds to a full number of minutes.
  *
- * @param seconds - number of seconds to be converted
+ * @param seconds - The number of seconds to be converted
  *
- * @returns the number of seconds converted in minutes
+ * @returns The number of seconds converted in minutes
  *
  * @example
  * // Convert 120 seconds into minutes
@@ -20,4 +20,4 @@
  * const result = secondsToMinutes(119)
  * //=> 1
  */
-export default function secondsToMinutes(seconds: number): number;
+export declare function secondsToMinutes(seconds: number): number;

package/dist-types/date-fns/set/index.d.ts

@@ -14,16 +14,12 @@ import type { DateValues } from '../types';
  * to use native `Date#setX` methods. If you use this function, you may not want to include the
  * other `setX` functions that date-fns provides if you are concerned about the bundle size.
  *
- * @param date - the date to be changed
- * @param values - an object with options
- * @param values.year - the number of years to be set
- * @param values.month - the number of months to be set
- * @param values.date - the number of days to be set
- * @param values.hours - the number of hours to be set
- * @param values.minutes - the number of minutes to be set
- * @param values.seconds - the number of seconds to be set
- * @param values.milliseconds - the number of milliseconds to be set
- * @returns the new date with options set
+ * @typeParam DateType - The `Date` type, the function operates on. Gets inferred from passed arguments. Allows to use extensions like [`UTCDate`](https://github.com/date-fns/utc).
+ *
+ * @param date - The date to be changed
+ * @param values - The date values to be set
+ *
+ * @returns The new date with options set
  *
  * @example
  * // Transform 1 September 2014 into 20 October 2015 in a single line:
@@ -35,4 +31,4 @@ import type { DateValues } from '../types';
  * const result = set(new Date(2014, 8, 1, 1, 23, 45), { hours: 12 })
  * //=> Mon Sep 01 2014 12:23:45
  */
-export default function set<DateType extends Date>(dirtyDate: DateType | number, values: DateValues): DateType;
+export declare function set<DateType extends Date>(date: DateType | number | string, values: DateValues): DateType;