Make toDate and isValid to accept any as the first argument

CHANGELOG.md

@@ -371,6 +371,9 @@ for the list of changes made since `v2.0.0-alpha.1`.
   by all the functions, operations over `null` will also return an invalid date.
   [See #537](https://github.com/date-fns/date-fns/issues/537) for the reasoning.
 
+- `toDate` (previously `parse`) and `isValid` functions now accept `any` type
+  as the first argument.
+
 ## [1.28.5] - 2017-05-19
 
 ### Fixed

src/fp/isValid/index.js.flow

@@ -63,4 +63,4 @@ type CurriedFn4<A, B, C, D, R> = <A>(a: A) => CurriedFn3<B, C, D, R>
   | <A,B,C>(a: A, b: B, c: C) => CurriedFn1<D, R>
   | <A,B,C,D>(a: A, b: B, c: C, d: D) => R
 
-declare module.exports: CurriedFn1<Date | string | number, boolean>
+declare module.exports: CurriedFn1<any, boolean>

src/fp/isValidWithOptions/index.js.flow

@@ -63,4 +63,4 @@ type CurriedFn4<A, B, C, D, R> = <A>(a: A) => CurriedFn3<B, C, D, R>
   | <A,B,C>(a: A, b: B, c: C) => CurriedFn1<D, R>
   | <A,B,C,D>(a: A, b: B, c: C, d: D) => R
 
-declare module.exports: CurriedFn2<Options, Date | string | number, boolean>
+declare module.exports: CurriedFn2<Options, any, boolean>

src/fp/toDate/index.js.flow

@@ -63,4 +63,4 @@ type CurriedFn4<A, B, C, D, R> = <A>(a: A) => CurriedFn3<B, C, D, R>
   | <A,B,C>(a: A, b: B, c: C) => CurriedFn1<D, R>
   | <A,B,C,D>(a: A, b: B, c: C, d: D) => R
 
-declare module.exports: CurriedFn1<Date | string | number, Date>
+declare module.exports: CurriedFn1<any, Date>

src/fp/toDateWithOptions/index.js.flow

@@ -63,4 +63,4 @@ type CurriedFn4<A, B, C, D, R> = <A>(a: A) => CurriedFn3<B, C, D, R>
   | <A,B,C>(a: A, b: B, c: C) => CurriedFn1<D, R>
   | <A,B,C,D>(a: A, b: B, c: C, d: D) => R
 
-declare module.exports: CurriedFn2<Options, Date | string | number, Date>
+declare module.exports: CurriedFn2<Options, any, Date>

src/isValid/index.js

@@ -12,7 +12,7 @@ import toDate from '../toDate/index.js'
  *
  * Time value of Date: http://es5.github.io/#x15.9.1.1
  *
- * @param {Date|String|Number} date - the date to check
+ * @param {*} date - the date to check
  * @param {Options} [options] - the object with options. See [Options]{@link https://date-fns.org/docs/Options}
  * @param {0|1|2} [options.additionalDigits=2] - passed to `toDate`. See [toDate]{@link https://date-fns.org/docs/toDate}
  * @returns {Boolean} the date is valid

src/isValid/index.js.flow

@@ -50,6 +50,6 @@ type Locale = {
 }
 
 declare module.exports: (
-  date: Date | string | number,
+  date: any,
   options?: Options
 ) => boolean

src/toDate/index.js

@@ -54,12 +54,14 @@ var patterns = {
  * Function accepts complete ISO 8601 formats as well as partial implementations.
  * ISO 8601: http://en.wikipedia.org/wiki/ISO_8601
  *
+ * If the argument is null, it is treated as an invalid date.
+ *
  * If all above fails, the function passes the given argument to Date constructor.
  *
  * **Note**: *all* Date arguments passed to any *date-fns* function is processed by `toDate`.
  * All *date-fns* functions will throw `RangeError` if `options.additionalDigits` is not 0, 1, 2 or undefined.
  *
- * @param {Date|String|Number} argument - the value to convert
+ * @param {*} argument - the value to convert
  * @param {Options} [options] - the object with options. See [Options]{@link https://date-fns.org/docs/Options}
  * @param {0|1|2} [options.additionalDigits=2] - the additional number of digits in the extended year format
  * @returns {Date} the parsed date in the local time zone

src/toDate/index.js.flow

@@ -50,6 +50,6 @@ type Locale = {
 }
 
 declare module.exports: (
-  argument: Date | string | number,
+  argument: any,
   options?: Options
 ) => Date

typings.d.ts

@@ -650,7 +650,7 @@ declare module 'date-fns' {
   namespace isTuesday {}
 
   function isValid (
-    date: Date | string | number,
+    date: any,
     options?: Options
   ): boolean
   namespace isValid {}
@@ -952,7 +952,7 @@ declare module 'date-fns' {
   namespace subYears {}
 
   function toDate (
-    argument: Date | string | number,
+    argument: any,
     options?: Options
   ): Date
   namespace toDate {}
@@ -3493,10 +3493,10 @@ declare module 'date-fns/fp' {
   const isTuesdayWithOptions: CurriedFn2<Options, Date | string | number, boolean>
   namespace isTuesdayWithOptions {}
 
-  const isValid: CurriedFn1<Date | string | number, boolean>
+  const isValid: CurriedFn1<any, boolean>
   namespace isValid {}
 
-  const isValidWithOptions: CurriedFn2<Options, Date | string | number, boolean>
+  const isValidWithOptions: CurriedFn2<Options, any, boolean>
   namespace isValidWithOptions {}
 
   const isWednesday: CurriedFn1<Date | string | number, boolean>
@@ -3769,10 +3769,10 @@ declare module 'date-fns/fp' {
   const subYearsWithOptions: CurriedFn3<Options, number, Date | string | number, Date>
   namespace subYearsWithOptions {}
 
-  const toDate: CurriedFn1<Date | string | number, Date>
+  const toDate: CurriedFn1<any, Date>
   namespace toDate {}
 
-  const toDateWithOptions: CurriedFn2<Options, Date | string | number, Date>
+  const toDateWithOptions: CurriedFn2<Options, any, Date>
   namespace toDateWithOptions {}
 }
 
@@ -8372,7 +8372,7 @@ declare module 'date-fns/esm' {
   namespace isTuesday {}
 
   function isValid (
-    date: Date | string | number,
+    date: any,
     options?: Options
   ): boolean
   namespace isValid {}
@@ -8674,7 +8674,7 @@ declare module 'date-fns/esm' {
   namespace subYears {}
 
   function toDate (
-    argument: Date | string | number,
+    argument: any,
     options?: Options
   ): Date
   namespace toDate {}
@@ -11215,10 +11215,10 @@ declare module 'date-fns/esm/fp' {
   const isTuesdayWithOptions: CurriedFn2<Options, Date | string | number, boolean>
   namespace isTuesdayWithOptions {}
 
-  const isValid: CurriedFn1<Date | string | number, boolean>
+  const isValid: CurriedFn1<any, boolean>
   namespace isValid {}
 
-  const isValidWithOptions: CurriedFn2<Options, Date | string | number, boolean>
+  const isValidWithOptions: CurriedFn2<Options, any, boolean>
   namespace isValidWithOptions {}
 
   const isWednesday: CurriedFn1<Date | string | number, boolean>
@@ -11491,10 +11491,10 @@ declare module 'date-fns/esm/fp' {
   const subYearsWithOptions: CurriedFn3<Options, number, Date | string | number, Date>
   namespace subYearsWithOptions {}
 
-  const toDate: CurriedFn1<Date | string | number, Date>
+  const toDate: CurriedFn1<any, Date>
   namespace toDate {}
 
-  const toDateWithOptions: CurriedFn2<Options, Date | string | number, Date>
+  const toDateWithOptions: CurriedFn2<Options, any, Date>
   namespace toDateWithOptions {}
 }
 
@@ -17239,7 +17239,7 @@ interface dateFns {
   ): boolean
 
   isValid(
-    date: Date | string | number,
+    date: any,
     options?: Options
   ): boolean
 
@@ -17495,7 +17495,7 @@ interface dateFns {
   ): Date
 
   toDate(
-    argument: Date | string | number,
+    argument: any,
     options?: Options
   ): Date
 }