@checkdigit/time 1.0.0

package/dist/date-fns/isSameMonth/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @name isSameMonth
+ * @category Month Helpers
+ * @summary Are the given dates in the same month (and year)?
+ *
+ * @description
+ * Are the given dates in the same month (and year)?
+ *
+ * @param dateLeft - the first date to check
+ * @param dateRight - the second date to check
+ * @returns the dates are in the same month (and year)
+ *
+ * @example
+ * // Are 2 September 2014 and 25 September 2014 in the same month?
+ * const result = isSameMonth(new Date(2014, 8, 2), new Date(2014, 8, 25))
+ * //=> true
+ *
+ * @example
+ * // Are 2 September 2014 and 25 September 2015 in the same month?
+ * const result = isSameMonth(new Date(2014, 8, 2), new Date(2015, 8, 25))
+ * //=> false
+ */
+export default function isSameMonth<DateType extends Date>(dirtyDateLeft: DateType | number, dirtyDateRight: DateType | number): boolean;

package/dist/date-fns/isSameQuarter/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @name isSameQuarter
+ * @category Quarter Helpers
+ * @summary Are the given dates in the same quarter (and year)?
+ *
+ * @description
+ * Are the given dates in the same quarter (and year)?
+ *
+ * @param dateLeft - the first date to check
+ * @param dateRight - the second date to check
+ * @returns the dates are in the same quarter (and year)
+ *
+ * @example
+ * // Are 1 January 2014 and 8 March 2014 in the same quarter?
+ * const result = isSameQuarter(new Date(2014, 0, 1), new Date(2014, 2, 8))
+ * //=> true
+ *
+ * @example
+ * // Are 1 January 2014 and 1 January 2015 in the same quarter?
+ * const result = isSameQuarter(new Date(2014, 0, 1), new Date(2015, 0, 1))
+ * //=> false
+ */
+export default function isSameQuarter<DateType extends Date>(dirtyDateLeft: DateType | number, dirtyDateRight: DateType | number): boolean;

package/dist/date-fns/isSameSecond/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @name isSameSecond
+ * @category Second Helpers
+ * @summary Are the given dates in the same second (and hour and day)?
+ *
+ * @description
+ * Are the given dates in the same second (and hour and day)?
+ *
+ * @param dateLeft - the first date to check
+ * @param dateRight - the second date to check
+ * @returns the dates are in the same second (and hour and day)
+ *
+ * @example
+ * // Are 4 September 2014 06:30:15.000 and 4 September 2014 06:30.15.500 in the same second?
+ * const result = isSameSecond(
+ *   new Date(2014, 8, 4, 6, 30, 15),
+ *   new Date(2014, 8, 4, 6, 30, 15, 500)
+ * )
+ * //=> true
+ *
+ * @example
+ * // Are 4 September 2014 06:00:15.000 and 4 September 2014 06:01.15.000 in the same second?
+ * const result = isSameSecond(
+ *   new Date(2014, 8, 4, 6, 0, 15),
+ *   new Date(2014, 8, 4, 6, 1, 15)
+ * )
+ * //=> false
+ *
+ * @example
+ * // Are 4 September 2014 06:00:15.000 and 5 September 2014 06:00.15.000 in the same second?
+ * const result = isSameSecond(
+ *   new Date(2014, 8, 4, 6, 0, 15),
+ *   new Date(2014, 8, 5, 6, 0, 15)
+ * )
+ * //=> false
+ */
+export default function isSameSecond<DateType extends Date>(dirtyDateLeft: DateType | number, dirtyDateRight: DateType | number): boolean;

package/dist/date-fns/isSameWeek/index.d.ts

@@ -0,0 +1,38 @@
+import type { LocaleOptions, WeekStartOptions } from '../types';
+/**
+ * The {@link isSameWeek} function options.
+ */
+export interface IsSameWeekOptions extends WeekStartOptions, LocaleOptions {
+}
+/**
+ * @name isSameWeek
+ * @category Week Helpers
+ * @summary Are the given dates in the same week (and month and year)?
+ *
+ * @description
+ * Are the given dates in the same week (and month and year)?
+ *
+ * @param dateLeft - the first date to check
+ * @param dateRight - the second date to check
+ * @param options - an object with options.
+ * @returns the dates are in the same week (and month and year)
+ *
+ * @example
+ * // Are 31 August 2014 and 4 September 2014 in the same week?
+ * const result = isSameWeek(new Date(2014, 7, 31), new Date(2014, 8, 4))
+ * //=> true
+ *
+ * @example
+ * // If week starts with Monday,
+ * // are 31 August 2014 and 4 September 2014 in the same week?
+ * const result = isSameWeek(new Date(2014, 7, 31), new Date(2014, 8, 4), {
+ *   weekStartsOn: 1
+ * })
+ * //=> false
+ *
+ * @example
+ * // Are 1 January 2014 and 1 January 2015 in the same week?
+ * const result = isSameWeek(new Date(2014, 0, 1), new Date(2015, 0, 1))
+ * //=> false
+ */
+export default function isSameWeek<DateType extends Date>(dirtyDateLeft: DateType | number, dirtyDateRight: DateType | number, options?: IsSameWeekOptions): boolean;

package/dist/date-fns/isSameYear/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @name isSameYear
+ * @category Year Helpers
+ * @summary Are the given dates in the same year?
+ *
+ * @description
+ * Are the given dates in the same year?
+ *
+ * @param dateLeft - the first date to check
+ * @param dateRight - the second date to check
+ * @returns the dates are in the same year
+ *
+ * @example
+ * // Are 2 September 2014 and 25 September 2014 in the same year?
+ * const result = isSameYear(new Date(2014, 8, 2), new Date(2014, 8, 25))
+ * //=> true
+ */
+export default function isSameYear<DateType extends Date>(dirtyDateLeft: DateType | number, dirtyDateRight: DateType | number): boolean;

package/dist/date-fns/isSaturday/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isSaturday
+ * @category Weekday Helpers
+ * @summary Is the given date Saturday?
+ *
+ * @description
+ * Is the given date Saturday?
+ *
+ * @param date - the date to check
+ * @returns the date is Saturday
+ *
+ * @example
+ * // Is 27 September 2014 Saturday?
+ * const result = isSaturday(new Date(2014, 8, 27))
+ * //=> true
+ */
+export default function isSaturday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isSunday/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isSunday
+ * @category Weekday Helpers
+ * @summary Is the given date Sunday?
+ *
+ * @description
+ * Is the given date Sunday?
+ *
+ * @param date - the date to check
+ * @returns the date is Sunday
+ *
+ * @example
+ * // Is 21 September 2014 Sunday?
+ * const result = isSunday(new Date(2014, 8, 21))
+ * //=> true
+ */
+export default function isSunday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisHour/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @name isThisHour
+ * @category Hour Helpers
+ * @summary Is the given date in the same hour as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same hour as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this hour
+ *
+ * @example
+ * // If now is 25 September 2014 18:30:15.500,
+ * // is 25 September 2014 18:00:00 in this hour?
+ * const result = isThisHour(new Date(2014, 8, 25, 18))
+ * //=> true
+ */
+export default function isThisHour<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisISOWeek/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @name isThisISOWeek
+ * @category ISO Week Helpers
+ * @summary Is the given date in the same ISO week as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same ISO week as the current date?
+ *
+ * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this ISO week
+ *
+ * @example
+ * // If today is 25 September 2014, is 22 September 2014 in this ISO week?
+ * const result = isThisISOWeek(new Date(2014, 8, 22))
+ * //=> true
+ */
+export default function isThisISOWeek<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisMinute/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @name isThisMinute
+ * @category Minute Helpers
+ * @summary Is the given date in the same minute as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same minute as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this minute
+ *
+ * @example
+ * // If now is 25 September 2014 18:30:15.500,
+ * // is 25 September 2014 18:30:00 in this minute?
+ * const result = isThisMinute(new Date(2014, 8, 25, 18, 30))
+ * //=> true
+ */
+export default function isThisMinute<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisMonth/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isThisMonth
+ * @category Month Helpers
+ * @summary Is the given date in the same month as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same month as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this month
+ *
+ * @example
+ * // If today is 25 September 2014, is 15 September 2014 in this month?
+ * const result = isThisMonth(new Date(2014, 8, 15))
+ * //=> true
+ */
+export default function isThisMonth<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisQuarter/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isThisQuarter
+ * @category Quarter Helpers
+ * @summary Is the given date in the same quarter as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same quarter as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this quarter
+ *
+ * @example
+ * // If today is 25 September 2014, is 2 July 2014 in this quarter?
+ * const result = isThisQuarter(new Date(2014, 6, 2))
+ * //=> true
+ */
+export default function isThisQuarter<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisSecond/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @name isThisSecond
+ * @category Second Helpers
+ * @summary Is the given date in the same second as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same second as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this second
+ *
+ * @example
+ * // If now is 25 September 2014 18:30:15.500,
+ * // is 25 September 2014 18:30:15.000 in this second?
+ * const result = isThisSecond(new Date(2014, 8, 25, 18, 30, 15))
+ * //=> true
+ */
+export default function isThisSecond<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThisWeek/index.d.ts

@@ -0,0 +1,34 @@
+import type { LocaleOptions, WeekStartOptions } from '../types';
+/**
+ * The {@link isThisWeek} function options.
+ */
+export interface IsThisWeekOptions extends WeekStartOptions, LocaleOptions {
+}
+/**
+ * @name isThisWeek
+ * @category Week Helpers
+ * @summary Is the given date in the same week as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same week as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @param options - the object with options
+ * @returns the date is in this week
+ *
+ * @example
+ * // If today is 25 September 2014, is 21 September 2014 in this week?
+ * const result = isThisWeek(new Date(2014, 8, 21))
+ * //=> true
+ *
+ * @example
+ * // If today is 25 September 2014 and week starts with Monday
+ * // is 21 September 2014 in this week?
+ * const result = isThisWeek(new Date(2014, 8, 21), { weekStartsOn: 1 })
+ * //=> false
+ */
+export default function is<DateType extends Date>(dirtyDate: DateType | number, options?: IsThisWeekOptions): boolean;

package/dist/date-fns/isThisYear/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isThisYear
+ * @category Year Helpers
+ * @summary Is the given date in the same year as the current date?
+ * @pure false
+ *
+ * @description
+ * Is the given date in the same year as the current date?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is in this year
+ *
+ * @example
+ * // If today is 25 September 2014, is 2 July 2014 in this year?
+ * const result = isThisYear(new Date(2014, 6, 2))
+ * //=> true
+ */
+export default function isThisYear<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isThursday/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isThursday
+ * @category Weekday Helpers
+ * @summary Is the given date Thursday?
+ *
+ * @description
+ * Is the given date Thursday?
+ *
+ * @param date - the date to check
+ * @returns the date is Thursday
+ *
+ * @example
+ * // Is 25 September 2014 Thursday?
+ * const result = isThursday(new Date(2014, 8, 25))
+ * //=> true
+ */
+export default function isThursday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isToday/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isToday
+ * @category Day Helpers
+ * @summary Is the given date today?
+ * @pure false
+ *
+ * @description
+ * Is the given date 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.
+ *
+ * @param date - the date to check
+ * @returns the date is today
+ *
+ * @example
+ * // If today is 6 October 2014, is 6 October 14:00:00 today?
+ * const result = isToday(new Date(2014, 9, 6, 14, 0))
+ * //=> true
+ */
+export default function isToday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isTomorrow/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isTomorrow
+ * @category Day Helpers
+ * @summary Is the given date tomorrow?
+ * @pure false
+ *
+ * @description
+ * Is the given date tomorrow?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is tomorrow
+ *
+ * @example
+ * // If today is 6 October 2014, is 7 October 14:00:00 tomorrow?
+ * const result = isTomorrow(new Date(2014, 9, 7, 14, 0))
+ * //=> true
+ */
+export default function isTomorrow<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isTuesday/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isTuesday
+ * @category Weekday Helpers
+ * @summary Is the given date Tuesday?
+ *
+ * @description
+ * Is the given date Tuesday?
+ *
+ * @param date - the date to check
+ * @returns the date is Tuesday
+ *
+ * @example
+ * // Is 23 September 2014 Tuesday?
+ * const result = isTuesday(new Date(2014, 8, 23))
+ * //=> true
+ */
+export default function isTuesday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isValid/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @name isValid
+ * @category Common Helpers
+ * @summary Is the given date valid?
+ *
+ * @description
+ * Returns false if argument is Invalid Date and true otherwise.
+ * Argument is converted to Date using `toDate`. See [toDate]{@link https://date-fns.org/docs/toDate}
+ * Invalid Date is a Date, whose time value is NaN.
+ *
+ * Time value of Date: http://es5.github.io/#x15.9.1.1
+ *
+ * @param date - the date to check
+ * @returns the date is valid
+ *
+ * @example
+ * // For the valid date:
+ * const result = isValid(new Date(2014, 1, 31))
+ * //=> true
+ *
+ * @example
+ * // For the value, convertable into a date:
+ * const result = isValid(1393804800000)
+ * //=> true
+ *
+ * @example
+ * // For the invalid date:
+ * const result = isValid(new Date(''))
+ * //=> false
+ */
+export default function isValid(dirtyDate: unknown): boolean;

package/dist/date-fns/isWednesday/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isWednesday
+ * @category Weekday Helpers
+ * @summary Is the given date Wednesday?
+ *
+ * @description
+ * Is the given date Wednesday?
+ *
+ * @param date - the date to check
+ * @returns the date is Wednesday
+ *
+ * @example
+ * // Is 24 September 2014 Wednesday?
+ * const result = isWednesday(new Date(2014, 8, 24))
+ * //=> true
+ */
+export default function isWednesday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isWeekend/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name isWeekend
+ * @category Weekday Helpers
+ * @summary Does the given date fall on a weekend?
+ *
+ * @description
+ * Does the given date fall on a weekend?
+ *
+ * @param date - the date to check
+ * @returns the date falls on a weekend
+ *
+ * @example
+ * // Does 5 October 2014 fall on a weekend?
+ * const result = isWeekend(new Date(2014, 9, 5))
+ * //=> true
+ */
+export default function isWeekend<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/isWithinInterval/index.d.ts

@@ -0,0 +1,40 @@
+import type { Interval } from '../types';
+/**
+ * @name isWithinInterval
+ * @category Interval Helpers
+ * @summary Is the given date within the interval?
+ *
+ * @description
+ * Is the given date within the interval? (Including start and end.)
+ *
+ * @param date - the date to check
+ * @param interval - the interval to check
+ * @returns the date is within the interval
+ * @throws {RangeError} The start of an interval cannot be after its end
+ * @throws {RangeError} Date in interval cannot be `Invalid Date`
+ *
+ * @example
+ * // For the date within the interval:
+ * isWithinInterval(new Date(2014, 0, 3), {
+ *   start: new Date(2014, 0, 1),
+ *   end: new Date(2014, 0, 7)
+ * })
+ * //=> true
+ *
+ * @example
+ * // For the date outside of the interval:
+ * isWithinInterval(new Date(2014, 0, 10), {
+ *   start: new Date(2014, 0, 1),
+ *   end: new Date(2014, 0, 7)
+ * })
+ * //=> false
+ *
+ * @example
+ * // For date equal to interval start:
+ * isWithinInterval(date, { start, end: date }) // => true
+ *
+ * @example
+ * // For date equal to interval end:
+ * isWithinInterval(date, { start: date, end }) // => true
+ */
+export default function isWithinInterval<DateType extends Date>(dirtyDate: DateType | number, interval: Interval<DateType>): boolean;

package/dist/date-fns/isYesterday/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name isYesterday
+ * @category Day Helpers
+ * @summary Is the given date yesterday?
+ * @pure false
+ *
+ * @description
+ * Is the given date yesterday?
+ *
+ * > ⚠️ 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.
+ *
+ * @param date - the date to check
+ * @returns the date is yesterday
+ *
+ * @example
+ * // If today is 6 October 2014, is 5 October 14:00:00 yesterday?
+ * const result = isYesterday(new Date(2014, 9, 5, 14, 0))
+ * //=> true
+ */
+export default function isYesterday<DateType extends Date>(dirtyDate: DateType | number): boolean;

package/dist/date-fns/lastDayOfDecade/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @name lastDayOfDecade
+ * @category Decade Helpers
+ * @summary Return the last day of a decade for the given date.
+ *
+ * @description
+ * Return the last day of a decade for the given date.
+ *
+ * @param date - the original date
+ * @returns the last day of a decade
+ *
+ * @example
+ * // The last day of a decade for 21 December 2012 21:12:00:
+ * const result = lastDayOfDecade(new Date(2012, 11, 21, 21, 12, 00))
+ * //=> Wed Dec 31 2019 00:00:00
+ */
+export default function lastDayOfDecade<DateType extends Date>(dirtyDate: DateType | number): DateType;

package/dist/date-fns/lastDayOfISOWeek/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @name lastDayOfISOWeek
+ * @category ISO Week Helpers
+ * @summary Return the last day of an ISO week for the given date.
+ *
+ * @description
+ * Return the last day of an ISO week for the given date.
+ * The result will be in the local timezone.
+ *
+ * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
+ *
+ * @param date - the original date
+ * @returns the last day of an ISO week
+ *
+ * @example
+ * // The last day of an ISO week for 2 September 2014 11:55:00:
+ * const result = lastDayOfISOWeek(new Date(2014, 8, 2, 11, 55, 0))
+ * //=> Sun Sep 07 2014 00:00:00
+ */
+export default function lastDayOfISOWeek<DateType extends Date>(dirtyDate: DateType | number): DateType;

package/dist/date-fns/lastDayOfISOWeekYear/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @name lastDayOfISOWeekYear
+ * @category ISO Week-Numbering Year Helpers
+ * @summary Return the last day of an ISO week-numbering year for the given date.
+ *
+ * @description
+ * Return the last day of an ISO week-numbering year,
+ * which always starts 3 days before the year's first Thursday.
+ * The result will be in the local timezone.
+ *
+ * ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
+ *
+ * @param date - the original date
+ * @returns the end of an ISO week-numbering year
+ *
+ * @example
+ * // The last day of an ISO week-numbering year for 2 July 2005:
+ * const result = lastDayOfISOWeekYear(new Date(2005, 6, 2))
+ * //=> Sun Jan 01 2006 00:00:00
+ */
+export default function lastDayOfISOWeekYear<DateType extends Date>(dirtyDate: DateType | number): DateType;

package/dist/date-fns/lastDayOfMonth/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @name lastDayOfMonth
+ * @category Month Helpers
+ * @summary Return the last day of a month for the given date.
+ *
+ * @description
+ * Return the last day of a month for the given date.
+ * The result will be in the local timezone.
+ *
+ * @param date - the original date
+ * @returns the last day of a month
+ *
+ * @example
+ * // The last day of a month for 2 September 2014 11:55:00:
+ * const result = lastDayOfMonth(new Date(2014, 8, 2, 11, 55, 0))
+ * //=> Tue Sep 30 2014 00:00:00
+ */
+export default function lastDayOfMonth<DateType extends Date>(dirtyDate: DateType | number): DateType;