1 files changed, 129 insertions, 0 deletions
diff --git a/docs/api/date.md b/docs/api/date.md
new file mode 100644
index 00000000..359a7744
--- /dev/null
+++ b/docs/api/date.md
@@ -0,0 +1,129 @@
+# Date
+
+[[toc]]
+
+## Past
+
+Return date sometime in the past.
+
+::: tip
+| Param | Type | Default |
+| -------- | ------- | :----------: |
+| maxYears | number | `1` |
+| refDate | Date | `new Date()` |
+:::
+
+```js
+faker.date.past();
+// Sat Oct 20 2018 04:19:38 GMT-0700 (Pacific Daylight Time)
+
+faker.date.past(100);
+// Tue Jul 27 1971 21:08:49 GMT-0700 (Pacific Daylight Time)
+
+faker.date.past(100, new Date(-3000));
+// Wed Dec 07 1881 05:04:18 GMT-0752 (Pacific Standard Time)
+```
+
+## Future
+
+Return date sometime in the future.
+
+::: tip
+| Param | Type | Default |
+| ------- | ------- | :----------: |
+| years | number | `1` |
+| refDate | Date | `new Date()` |
+:::
+
+```js
+faker.date.future();
+// Mon Sep 02 2019 21:08:33 GMT-0700 (Pacific Daylight Time)
+
+faker.date.future(100);
+// Fri Nov 23 2068 10:43:15 GMT-0800 (Pacific Standard Time)
+
+faker.date.future(100, new Date(-3000));
+// Mon Jun 26 2051 01:50:51 GMT-0700 (Pacific Daylight Time)
+```
+
+## Between
+
+Return date sometime in the future.
+
+::: tip
+| Param | Type | Default |
+| ----- | ---- | :------------------------------------------------: |
+| from | Date | <Badge text="N/A" type="error" vertical="middle"/> |
+| to | Date | <Badge text="N/A" type="error" vertical="middle"/> |
+:::
+
+```js
+faker.date.between(new Date(0), new Date(365 * 24 * 3600 * 1000));
+// Mon Oct 19 1970 14:12:01 GMT-0700 (Pacific Daylight Time)
+```
+
+## Recent <Badge text="5.0.0+" type="tip" vertical="middle"/>
+
+Returns some date recent date
+
+::: tip
+| Param | Type | Default |
+| ------- | ------- | :----------: |
+| days | number | `1` |
+| refDate | Date | `new Date()` |
+:::
+
+```js
+faker.date.recent();
+```
+
+## Soon <Badge text="5.0.0+" type="tip" vertical="middle"/>
+
+Return date sometime soon.
+
+::: tip
+| Param | Type | Default |
+| ------- | ------- | :----------: |
+| days | number | `1` |
+| refDate | Date | `new Date()` |
+:::
+
+```js
+faker.date.soon();
+```
+
+## Month
+
+Return random month name
+
+::: tip
+| Param | Type | Default |
+| ------ | ------ | :-----------------------------: |
+| option | object | `{abbr: false, context: false}` |
+:::
+
+```js
+faker.date.month();
+// December
+
+faker.date.month({ abbr: true });
+// Dec
+```
+
+## Weekday
+
+Return random weekday name
+
+::: tip
+| Param | Type | Default |
+| ------ | ------ | :-----------------------------: |
+| option | object | `{abbr: false, context: false}` |
+:::
+
+```js
+faker.date.weekday();
+// Sunday
+
+faker.date.weekday({ abbr: true });
+// Sun
+```