@checkdigit/time 3.0.0-PR.17-58cd → 4.0.0-PR.18-9134

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

@@ -7,12 +7,15 @@
  * Return the end of a minute for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @returns the end of a minute
+ * @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 original date
+ *
+ * @returns The end of a minute
  *
  * @example
  * // The end of a minute for 1 December 2014 22:15:45.400:
  * const result = endOfMinute(new Date(2014, 11, 1, 22, 15, 45, 400))
  * //=> Mon Dec 01 2014 22:15:59.999
  */
-export default function endOfMinute<DateType extends Date>(dirtyDate: DateType | number): DateType;
+export declare function endOfMinute<DateType extends Date>(date: DateType | number | string): DateType;

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

@@ -7,12 +7,15 @@
  * Return the end of a month for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @returns the end of a month
+ * @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 original date
+ *
+ * @returns The end of a month
  *
  * @example
  * // The end of a month for 2 September 2014 11:55:00:
  * const result = endOfMonth(new Date(2014, 8, 2, 11, 55, 0))
  * //=> Tue Sep 30 2014 23:59:59.999
  */
-export default function endOfMonth<DateType extends Date>(dirtyDate: DateType | number): DateType;
+export declare function endOfMonth<DateType extends Date>(date: DateType | number | string): DateType;

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

@@ -7,12 +7,15 @@
  * Return the end of a year quarter for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @returns the end of a quarter
+ * @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 original date
+ *
+ * @returns The end of a quarter
  *
  * @example
  * // The end of a quarter for 2 September 2014 11:55:00:
  * const result = endOfQuarter(new Date(2014, 8, 2, 11, 55, 0))
  * //=> Tue Sep 30 2014 23:59:59.999
  */
-export default function endOfQuarter<DateType extends Date>(dirtyDate: DateType | number): DateType;
+export declare function endOfQuarter<DateType extends Date>(date: DateType | number | string): DateType;

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

@@ -7,12 +7,15 @@
  * Return the end of a second for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @returns the end of a second
+ * @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 original date
+ *
+ * @returns The end of a second
  *
  * @example
  * // The end of a second for 1 December 2014 22:15:45.400:
  * const result = endOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
  * //=> Mon Dec 01 2014 22:15:45.999
  */
-export default function endOfSecond<DateType extends Date>(dirtyDate: DateType | number): DateType;
+export declare function endOfSecond<DateType extends Date>(date: DateType | number | string): DateType;

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

@@ -7,14 +7,13 @@
  * @description
  * Return the end of today.
  *
- * > ⚠️ Please note that this function is not present in the FP submodule as
- * > it uses `Date.now()` internally hence impure and can't be safely curried.
+ * @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 end of today
+ * @returns The end of today
  *
  * @example
  * // If today is 6 October 2014:
  * const result = endOfToday()
  * //=> Mon Oct 6 2014 23:59:59.999
  */
-export default function endOfToday(): Date;
+export declare function endOfToday(): Date;

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

@@ -7,14 +7,13 @@
  * @description
  * Return the end of tomorrow.
  *
- * > ⚠️ Please note that this function is not present in the FP submodule as
- * > it uses `new Date()` internally hence impure and can't be safely curried.
+ * @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 end of tomorrow
+ * @returns The end of tomorrow
  *
  * @example
  * // If today is 6 October 2014:
  * const result = endOfTomorrow()
  * //=> Tue Oct 7 2014 23:59:59.999
  */
-export default function endOfTomorrow(): Date;
+export declare function endOfTomorrow(): Date;

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

@@ -1,8 +1,8 @@
-import type { LocaleOptions, WeekStartOptions } from '../types';
+import type { LocalizedOptions, WeekOptions } from "../types";
 /**
  * The {@link endOfWeek} function options.
  */
-export interface EndOfWeekOptions extends WeekStartOptions, LocaleOptions {
+export interface EndOfWeekOptions extends WeekOptions, LocalizedOptions<"options"> {
 }
 /**
  * @name endOfWeek
@@ -13,9 +13,12 @@ export interface EndOfWeekOptions extends WeekStartOptions, LocaleOptions {
  * Return the end of a week for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @param options - an object with options.
- * @returns the end of a 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 original date
+ * @param options - An object with options
+ *
+ * @returns The end of a week
  *
  * @example
  * // The end of a week for 2 September 2014 11:55:00:
@@ -27,4 +30,4 @@ export interface EndOfWeekOptions extends WeekStartOptions, LocaleOptions {
  * const result = endOfWeek(new Date(2014, 8, 2, 11, 55, 0), { weekStartsOn: 1 })
  * //=> Sun Sep 07 2014 23:59:59.999
  */
-export default function endOfWeek<DateType extends Date>(dirtyDate: DateType | number, options?: EndOfWeekOptions): DateType;
+export declare function endOfWeek<DateType extends Date>(date: DateType | number | string, options?: EndOfWeekOptions): DateType;

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

@@ -7,12 +7,15 @@
  * Return the end of a year for the given date.
  * The result will be in the local timezone.
  *
- * @param date - the original date
- * @returns the end of a year
+ * @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 original date
+ *
+ * @returns The end of a year
  *
  * @example
  * // The end of a year for 2 September 2014 11:55:00:
  * const result = endOfYear(new Date(2014, 8, 2, 11, 55, 00))
  * //=> Wed Dec 31 2014 23:59:59.999
  */
-export default function endOfYear<DateType extends Date>(dirtyDate: DateType | number): DateType;
+export declare function endOfYear<DateType extends Date>(date: DateType | number | string): DateType;

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

@@ -7,14 +7,13 @@
  * @description
  * Return the end of yesterday.
  *
- * > ⚠️ Please note that this function is not present in the FP submodule as
- * > it uses `new Date()` internally hence impure and can't be safely curried.
+ * @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 end of yesterday
+ * @returns The end of yesterday
  *
  * @example
  * // If today is 6 October 2014:
  * const result = endOfYesterday()
  * //=> Sun Oct 5 2014 23:59:59.999
  */
-export default function endOfYesterday(): Date;
+export declare function endOfYesterday(): Date;

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

@@ -1,12 +1,17 @@
-import type { Instant } from '../../instant';
-import type { AdditionalTokensOptions, FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../types';
+import { formatters } from "../_lib/format/formatters/index";
+import { longFormatters } from "../_lib/format/longFormatters/index";
+import type { AdditionalTokensOptions, FirstWeekContainsDateOptions, LocalizedOptions, WeekOptions } from "../types";
+export { formatters, longFormatters };
+export { format as formatDate };
+export type { FormatOptions as FormatDateOptions };
 /**
  * The {@link format} function options.
  */
-export interface FormatOptions extends LocaleOptions, WeekStartOptions, FirstWeekContainsDateOptions, AdditionalTokensOptions {
+export interface FormatOptions extends LocalizedOptions<"options" | "localize" | "formatLong">, WeekOptions, FirstWeekContainsDateOptions, AdditionalTokensOptions {
 }
 /**
  * @name format
+ * @alias formatDate
  * @category Common Helpers
  * @summary Format the date.
  *
@@ -233,8 +238,8 @@ export interface FormatOptions extends LocaleOptions, WeekStartOptions, FirstWee
  *
  *    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 [getISOWeekYear]{@link https://date-fns.org/docs/getISOWeekYear}
- *    and [getWeekYear]{@link https://date-fns.org/docs/getWeekYear}).
+ *    and `options.firstWeekContainsDate` (compare [getISOWeekYear](https://date-fns.org/docs/getISOWeekYear)
+ *    and [getWeekYear](https://date-fns.org/docs/getWeekYear)).
  *
  * 6. Specific non-location timezones are currently unavailable in `date-fns`,
  *    so right now these tokens fall back to GMT timezones.
@@ -255,18 +260,22 @@ export interface FormatOptions extends LocaleOptions, WeekStartOptions, FirstWee
  * 9. `D` and `DD` tokens represent days of the year but they are often confused with days of the month.
  *    You should enable `options.useAdditionalDayOfYearTokens` to use them. See: https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md
  *
- * @param date - the original date
- * @param format - the string of tokens
- * @param options - an object with options.
- * @returns the formatted date string
- * @throws {RangeError} `date` must not be Invalid Date
- * @throws {RangeError} `options.locale` must contain `localize` property
- * @throws {RangeError} `options.locale` must contain `formatLong` 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
+ * @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 original date
+ * @param format - The string of tokens
+ * @param options - An object with options
+ *
+ * @returns The formatted date string
+ *
+ * @throws `date` must not be Invalid Date
+ * @throws `options.locale` must contain `localize` property
+ * @throws `options.locale` must contain `formatLong` 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
  * // Represent 11 February 2014 in middle-endian format:
@@ -286,4 +295,4 @@ export interface FormatOptions extends LocaleOptions, WeekStartOptions, FirstWee
  * const result = format(new Date(2014, 6, 2, 15), "h 'o''clock'")
  * //=> "3 o'clock"
  */
-export default function format<DateType extends Date>(dirtyDate: Instant | DateType | number, formatStr: string, options?: FormatOptions): string;
+export declare function format<DateType extends Date>(date: DateType | number | string, formatStr: string, options?: FormatOptions): string;

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

@@ -1,9 +1,11 @@
-import type { LocaleOptions } from '../types';
+import type { LocalizedOptions } from "../types";
 /**
  * The {@link formatDistance} function options.
  */
-export interface FormatDistanceOptions extends LocaleOptions {
+export interface FormatDistanceOptions extends LocalizedOptions<"formatDistance"> {
+    /** Distances less than a minute are more detailed */
     includeSeconds?: boolean;
+    /** Add "X ago"/"in X" in the locale language */
     addSuffix?: boolean;
 }
 /**
@@ -43,13 +45,17 @@ export interface FormatDistanceOptions extends LocaleOptions {
  * | 40 secs ... 60 secs    | less than a minute   |
  * | 60 secs ... 90 secs    | 1 minute             |
  *
- * @param date - the date
- * @param baseDate - the date to compare with
- * @param options - an object with options.
- * @returns the distance in words
- * @throws {RangeError} `date` must not be Invalid Date
- * @throws {RangeError} `baseDate` must not be Invalid Date
- * @throws {RangeError} `options.locale` must contain `formatDistance` property
+ * @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
+ * @param baseDate - The date to compare with
+ * @param options - An object with options
+ *
+ * @returns The distance in words
+ *
+ * @throws `date` must not be Invalid Date
+ * @throws `baseDate` must not be Invalid Date
+ * @throws `options.locale` must contain `formatDistance` property
  *
  * @example
  * // What is the distance between 2 July 2014 and 1 January 2015?
@@ -82,4 +88,4 @@ export interface FormatDistanceOptions extends LocaleOptions {
  * })
  * //=> 'pli ol 1 jaro'
  */
-export default function formatDistance<DateType extends Date>(dirtyDate: DateType | number, dirtyBaseDate: DateType | number, options?: FormatDistanceOptions): string;
+export declare function formatDistance<DateType extends Date>(date: DateType | number | string, baseDate: DateType | number | string, options?: FormatDistanceOptions): string;

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

@@ -1,12 +1,17 @@
-import type { LocaleOptions, FormatDistanceStrictUnit } from '../types';
+import type { LocalizedOptions, RoundingOptions } from "../types";
 /**
  * The {@link formatDistanceStrict} function options.
  */
-export interface FormatDistanceStrictOptions extends LocaleOptions {
+export interface FormatDistanceStrictOptions extends LocalizedOptions<"formatDistance">, RoundingOptions {
+    /** Add "X ago"/"in X" in the locale language */
     addSuffix?: boolean;
+    /** If specified, will force the unit */
     unit?: FormatDistanceStrictUnit;
-    roundingMethod?: 'floor' | 'ceil' | 'round';
 }
+/**
+ * The unit used to format the distance in {@link formatDistanceStrict}.
+ */
+export type FormatDistanceStrictUnit = "second" | "minute" | "hour" | "day" | "month" | "year";
 /**
  * @name formatDistanceStrict
  * @category Common Helpers
@@ -26,14 +31,18 @@ export interface FormatDistanceStrictOptions extends LocaleOptions {
  * | 1 ... 11 months        | [1..11] months      |
  * | 1 ... N years          | [1..N]  years       |
  *
- * @param date - the date
- * @param baseDate - the date to compare with
- * @param options - an object with options.
- * @returns the distance in words
- * @throws {RangeError} `date` must not be Invalid Date
- * @throws {RangeError} `baseDate` must not be Invalid Date
- * @throws {RangeError} `options.unit` must be 'second', 'minute', 'hour', 'day', 'month' or 'year'
- * @throws {RangeError} `options.locale` must contain `formatDistance` property
+ * @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
+ * @param baseDate - The date to compare with
+ * @param options - An object with options
+ *
+ * @returns The distance in words
+ *
+ * @throws `date` must not be Invalid Date
+ * @throws `baseDate` must not be Invalid Date
+ * @throws `options.unit` must be 'second', 'minute', 'hour', 'day', 'month' or 'year'
+ * @throws `options.locale` must contain `formatDistance` property
  *
  * @example
  * // What is the distance between 2 July 2014 and 1 January 2015?
@@ -82,4 +91,4 @@ export interface FormatDistanceStrictOptions extends LocaleOptions {
  * })
  * //=> '1 jaro'
  */
-export default function formatDistanceStrict<DateType extends Date>(dirtyDate: DateType | number, dirtyBaseDate: DateType | number, options?: FormatDistanceStrictOptions): string;
+export declare function formatDistanceStrict<DateType extends Date>(date: DateType | number | string, baseDate: DateType | number | string, options?: FormatDistanceStrictOptions): string;

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

@@ -1,4 +1,4 @@
-import { type FormatDistanceOptions } from '../formatDistance/index';
+import type { FormatDistanceOptions } from "../formatDistance/index";
 /**
  * The {@link formatDistanceToNow} function options.
  */
@@ -42,14 +42,15 @@ export interface FormatDistanceToNowOptions extends FormatDistanceOptions {
  * | 40 secs ... 60 secs | less than a minute   |
  * | 60 secs ... 90 secs | 1 minute             |
  *
- * > ⚠️ Please note that this function is not present in the FP submodule as
- * > it uses `Date.now()` internally hence impure and can't be safely curried.
+ * @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 given date
- * @param options - the object with options
- * @returns the distance in words
- * @throws {RangeError} `date` must not be Invalid Date
- * @throws {RangeError} `options.locale` must contain `formatDistance` property
+ * @param date - The given date
+ * @param options - The object with options
+ *
+ * @returns The distance in words
+ *
+ * @throws `date` must not be Invalid Date
+ * @throws `options.locale` must contain `formatDistance` property
  *
  * @example
  * // If today is 1 January 2015, what is the distance to 2 July 2014?
@@ -86,4 +87,4 @@ export interface FormatDistanceToNowOptions extends FormatDistanceOptions {
  * )
  * //=> 'pli ol 1 jaro'
  */
-export default function formatDistanceToNow<DateType extends Date>(dirtyDate: DateType | number, options?: FormatDistanceToNowOptions): string;
+export declare function formatDistanceToNow<DateType extends Date>(date: DateType | number | string, options?: FormatDistanceToNowOptions): string;

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

@@ -1,4 +1,4 @@
-import { type FormatDistanceStrictOptions } from '../formatDistanceStrict/index';
+import type { FormatDistanceStrictOptions } from "../formatDistanceStrict/index";
 /**
  * The {@link formatDistanceToNowStrict} function options.
  */
@@ -24,11 +24,15 @@ export interface FormatDistanceToNowStrictOptions extends FormatDistanceStrictOp
  * | 1 ... 11 months        | [1..11] months      |
  * | 1 ... N years          | [1..N]  years       |
  *
- * @param date - the given date
- * @param options - an object with options.
- * @returns the distance in words
- * @throws {RangeError} `date` must not be Invalid Date
- * @throws {RangeError} `options.locale` must contain `formatDistance` property
+ * @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 given date
+ * @param options - An object with options.
+ *
+ * @returns The distance in words
+ *
+ * @throws `date` must not be Invalid Date
+ * @throws `options.locale` must contain `formatDistance` property
  *
  * @example
  * // If today is 1 January 2015, what is the distance to 2 July 2014?
@@ -73,4 +77,4 @@ export interface FormatDistanceToNowStrictOptions extends FormatDistanceStrictOp
  * )
  * //=> '1 jaro'
  */
-export default function formatDistanceToNowStrict<DateType extends Date>(dirtyDate: DateType | number, options?: FormatDistanceToNowStrictOptions): string;
+export declare function formatDistanceToNowStrict<DateType extends Date>(date: DateType | number | string, options?: FormatDistanceToNowStrictOptions): string;

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

@@ -1,10 +1,13 @@
-import type { Duration, DurationUnit, LocaleOptions } from '../types';
+import type { Duration, DurationUnit, LocalizedOptions } from "../types";
 /**
  * The {@link formatDuration} function options.
  */
-export interface FormatDurationOptions extends LocaleOptions {
+export interface FormatDurationOptions extends LocalizedOptions<"formatDistance"> {
+    /** The array of units to format */
     format?: DurationUnit[];
+    /** Should be zeros be included in the output? */
     zero?: boolean;
+    /** The delimiter string to use */
     delimiter?: string;
 }
 /**
@@ -15,9 +18,12 @@ export interface FormatDurationOptions extends LocaleOptions {
  * @description
  * Return human-readable duration string i.e. "9 months 2 days"
  *
- * @param duration - the duration to format
- * @param options - an object with options.
- * @returns the formatted date string
+ * @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 duration - The duration to format
+ * @param options - An object with options.
+ *
+ * @returns The formatted date string
  *
  * @example
  * // Format full duration
@@ -64,4 +70,4 @@ export interface FormatDurationOptions extends LocaleOptions {
  * formatDuration({ years: 2, months: 9, weeks: 3 }, { delimiter: ', ' })
  * //=> '2 years, 9 months, 3 weeks'
  */
-export default function formatDuration(duration: Duration, options?: FormatDurationOptions): string;
+export declare function formatDuration(duration: Duration, options?: FormatDurationOptions): string;

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

@@ -1,8 +1,8 @@
-import type { FormatOptions, RepresentationOptions } from '../types';
+import type { ISOFormatOptions } from "../types";
 /**
  * The {@link formatISO} function options.
  */
-export interface FormatISOOptions extends FormatOptions, RepresentationOptions {
+export interface FormatISOOptions extends ISOFormatOptions {
 }
 /**
  * @name formatISO
@@ -12,10 +12,14 @@ export interface FormatISOOptions extends FormatOptions, RepresentationOptions {
  * @description
  * Return the formatted date string in ISO 8601 format. Options may be passed to control the parts and notations of the date.
  *
- * @param date - the original date
- * @param options - an object with options.
- * @returns the formatted date string (in local time zone)
- * @throws {RangeError} `date` must not be Invalid Date
+ * @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 original date
+ * @param options - An object with options.
+ *
+ * @returns The formatted date string (in loca.l time zone)
+ *
+ * @throws `date` must not be Invalid Date
  *
  * @example
  * // Represent 18 September 2019 in ISO 8601 format (local time zone is UTC):
@@ -37,4 +41,4 @@ export interface FormatISOOptions extends FormatOptions, RepresentationOptions {
  * const result = formatISO(new Date(2019, 8, 18, 19, 0, 52), { representation: 'time' })
  * //=> '19:00:52Z'
  */
-export default function formatISO<DateType extends Date>(date: DateType | number, options?: FormatISOOptions): string;
+export declare function formatISO<DateType extends Date>(date: DateType | number | string, options?: FormatISOOptions): string;

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

@@ -1,8 +1,8 @@
-import type { FormatOptions, RepresentationOptions } from '../types';
+import type { ISOFormatOptions } from "../types";
 /**
  * The {@link formatISO9075} function options.
  */
-export interface FormatISO9075Options extends FormatOptions, RepresentationOptions {
+export interface FormatISO9075Options extends ISOFormatOptions {
 }
 /**
  * @name formatISO9075
@@ -12,10 +12,14 @@ export interface FormatISO9075Options extends FormatOptions, RepresentationOptio
  * @description
  * Return the formatted date string in ISO 9075 format. Options may be passed to control the parts and notations of the date.
  *
- * @param date - the original date
- * @param options - an object with options.
- * @returns the formatted date string
- * @throws {RangeError} `date` must not be Invalid Date
+ * @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 original date
+ * @param options - An object with options.
+ *
+ * @returns The formatted date string
+ *
+ * @throws `date` must not be Invalid Date
  *
  * @example
  * // Represent 18 September 2019 in ISO 9075 format:
@@ -37,4 +41,4 @@ export interface FormatISO9075Options extends FormatOptions, RepresentationOptio
  * const result = formatISO9075(new Date(2019, 8, 18, 19, 0, 52), { representation: 'time' })
  * //=> '19:00:52'
  */
-export default function formatISO9075<DateType extends Date>(dirtyDate: DateType | number, options?: FormatISO9075Options): string;
+export declare function formatISO9075<DateType extends Date>(date: DateType | number | string, options?: FormatISO9075Options): string;

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

@@ -1,13 +1,13 @@
-import type { Duration } from '../types';
+import type { Duration } from "../types";
 /**
  * @name formatISODuration
  * @category Common Helpers
  * @summary Format a duration object according as ISO 8601 duration string
  *
  * @description
- * Format a duration object according to the ISO 8601 duration standard (https://www.digi.com/resources/documentation/digidocs/90001437-13/reference/r_iso_8601_duration_format.htm)
+ * Format a duration object according to the ISO 8601 duration standard (https://www.digi.com/resources/documentation/digidocs//90001488-13/reference/r_iso_8601_duration_format.htm)
  *
- * @param duration - the duration to format
+ * @param duration - The duration to format
  *
  * @returns The ISO 8601 duration string
  *
@@ -23,4 +23,4 @@ import type { Duration } from '../types';
  * })
  * //=> 'P39Y2M20DT0H0M0S'
  */
-export default function formatISODuration(duration: Duration): string;
+export declare function formatISODuration(duration: Duration): string;

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

@@ -2,6 +2,7 @@
  * The {@link formatRFC3339} function options.
  */
 export interface FormatRFC3339Options {
+    /** The number of digits after the decimal point after seconds, defaults to 0 */
     fractionDigits?: 0 | 1 | 2 | 3;
 }
 /**
@@ -12,24 +13,25 @@ export interface FormatRFC3339Options {
  * @description
  * Return the formatted date string in RFC 3339 format. Options may be passed to control the parts and notations of the date.
  *
- * @param date - the original date
- * @param options - an object with options.
- * @returns the formatted date string
- * @throws {RangeError} `date` must not be Invalid Date
+ * @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 original date
+ * @param options - An object with options.
+ *
+ * @returns The formatted date string
+ *
+ * @throws `date` must not be Invalid Date
  *
  * @example
  * // Represent 18 September 2019 in RFC 3339 format:
- * const result = formatRFC3339(new Date(2019, 8, 18, 19, 0, 52))
+ * formatRFC3339(new Date(2019, 8, 18, 19, 0, 52))
  * //=> '2019-09-18T19:00:52Z'
  *
  * @example
- * // Represent 18 September 2019 in RFC 3339 format, 2 digits of second fraction:
- * const result = formatRFC3339(new Date(2019, 8, 18, 19, 0, 52, 234), { fractionDigits: 2 })
- * //=> '2019-09-18T19:00:52.23Z'
- *
- * @example
  * // Represent 18 September 2019 in RFC 3339 format, 3 digits of second fraction
- * const result = formatRFC3339(new Date(2019, 8, 18, 19, 0, 52, 234), { fractionDigits: 3 })
+ * formatRFC3339(new Date(2019, 8, 18, 19, 0, 52, 234), {
+ *   fractionDigits: 3
+ * })
  * //=> '2019-09-18T19:00:52.234Z'
  */
-export default function formatRFC3339<DateType extends Date>(dirtyDate: DateType | number, options?: FormatRFC3339Options): string;
+export declare function formatRFC3339<DateType extends Date>(date: DateType | number | string, options?: FormatRFC3339Options): string;