guessdate-en
Version:
Guess an english date string, returns a javascript date object
145 lines (118 loc) • 6.29 kB
Markdown
## Examples
```js
const now = new Date('Sun Feb 12 2017 23:08:56 GMT+0000 (Greenwich Mean Time)') // The following tests assume this as the reference date
```
### Empty Input
```js
guessDate(now, '') // Sun, 12 Feb 2017 23:08:56 GMT
```
### Database Years
```js
guessDate(now, '2015-05-25') // Mon, 25 May 2015 08:00:00 GMT
```
### Day of Week Matchers
```js
guessDate(now, 'Next sunday') // Sun, 19 Feb 2017 08:00:00 GMT
guessDate(now, 'on Monday') // Mon, 13 Feb 2017 08:00:00 GMT
guessDate(now, 'Tues') // Tue, 14 Feb 2017 08:00:00 GMT
guessDate(now, 'wednesday') // Wed, 15 Feb 2017 08:00:00 GMT
guessDate(now, 'thursda') // Thu, 16 Feb 2017 08:00:00 GMT
guessDate(now, 'Fri') // Fri, 17 Feb 2017 08:00:00 GMT
guessDate(now, 'Satur') // Sat, 18 Feb 2017 08:00:00 GMT
guessDate(now, 'Sun') // Sun, 19 Feb 2017 08:00:00 GMT
```
### Time of day strings
```js
guessDate(now, 'evening') // Sun, 12 Feb 2017 18:00:00 GMT
guessDate(now, 'Monday evenig') // Mon, 13 Feb 2017 18:00:00 GMT
guessDate(now, 'Friday eve') // Fri, 17 Feb 2017 18:00:00 GMT
guessDate(now, 'morning') // Sun, 12 Feb 2017 08:00:00 GMT
guessDate(now, 'Monday morn') // Mon, 13 Feb 2017 08:00:00 GMT
guessDate(now, 'Friday mornin') // Fri, 17 Feb 2017 08:00:00 GMT
guessDate(now, 'afternoon') // Sun, 12 Feb 2017 13:00:00 GMT
guessDate(now, 'Monday afternoon') // Mon, 13 Feb 2017 13:00:00 GMT
guessDate(now, 'Friday noon') // Fri, 17 Feb 2017 12:00:00 GMT
guessDate(now, 'Friday midday') // Fri, 17 Feb 2017 12:00:00 GMT
```
### Month of year strings
```js
guessDate(now, 'Jan') // Mon, 01 Jan 2018 08:00:00 GMT
guessDate(now, 'Febru evenig') // Wed, 01 Feb 2017 18:00:00 GMT
guessDate(now, 'March eve') // Wed, 01 Mar 2017 18:00:00 GMT
guessDate(now, 'April') // Sat, 01 Apr 2017 08:00:00 GMT
guessDate(now, 'May eve') // Mon, 01 May 2017 18:00:00 GMT
guessDate(now, 'June morn') // Thu, 01 Jun 2017 08:00:00 GMT
guessDate(now, 'July mornin') // Sat, 01 Jul 2017 08:00:00 GMT
guessDate(now, 'August mornin') // Tue, 01 Aug 2017 08:00:00 GMT
guessDate(now, 'Sept eve') // Fri, 01 Sep 2017 18:00:00 GMT
guessDate(now, 'September 15th eve') // Fri, 15 Sep 2017 18:00:00 GMT
guessDate(now, 'September 15th eve') // Fri, 15 Sep 2017 18:00:00 GMT
guessDate(now, 'October mornin') // Sun, 01 Oct 2017 08:00:00 GMT
guessDate(now, 'November mornin') // Wed, 01 Nov 2017 08:00:00 GMT
guessDate(now, 'December eve') // Fri, 01 Dec 2017 18:00:00 GMT
```
### Tomorrow
```js
guessDate(now, 'tomorrow') // Mon, 13 Feb 2017 08:00:00 GMT
guessDate(now, 'tomorrow after work') // Mon, 13 Feb 2017 17:00:00 GMT
guessDate(now, 'tomorrow before lunch') // Mon, 13 Feb 2017 11:00:00 GMT
guessDate(now, 'tomorrow at 8am') // Mon, 13 Feb 2017 08:00:00 GMT
```
### After points in time
```js
guessDate(now, 'Monday after breakfast') // Mon, 13 Feb 2017 07:00:00 GMT
guessDate(now, 'Tuesday after work') // Tue, 14 Feb 2017 17:00:00 GMT
guessDate(now, 'Wednesday after lunch') // Wed, 15 Feb 2017 13:00:00 GMT
guessDate(now, 'Thursday after school') // Thu, 16 Feb 2017 16:00:00 GMT
```
### Before points in time
```js
guessDate(now, 'Monday before breakfast') // Mon, 13 Feb 2017 06:00:00 GMT
guessDate(now, 'Tuesday before work') // Tue, 14 Feb 2017 07:00:00 GMT
guessDate(now, 'Wednesday before lunch') // Wed, 15 Feb 2017 11:00:00 GMT
guessDate(now, 'Thursday before school') // Thu, 16 Feb 2017 07:00:00 GMT
```
### Dates in month
```js
guessDate(now, '24th') // Fri, 24 Feb 2017 08:00:00 GMT
guessDate(now, '26th') // Sun, 26 Feb 2017 08:00:00 GMT
guessDate(now, 'evening of the 30th') // Thu, 02 Mar 2017 18:00:00 GMT
guessDate(now, 'January 1st') // Mon, 01 Jan 2018 08:00:00 GMT
guessDate(now, 'May 21st') // Sun, 21 May 2017 08:00:00 GMT
guessDate(now, '1st February') // Wed, 01 Feb 2017 08:00:00 GMT
guessDate(now, '2nd February after lunch') // Thu, 02 Feb 2017 13:00:00 GMT
guessDate(now, '1st March') // Wed, 01 Mar 2017 08:00:00 GMT
guessDate(now, '23rd August') // Wed, 23 Aug 2017 08:00:00 GMT
guessDate(now, '4pm on the 25th March') // Sat, 25 Mar 2017 16:00:00 GMT
guessDate(now, 'March 25th at 2am') // Sat, 25 Mar 2017 02:00:00 GMT
guessDate(now, 'Sat May 27, 2017') // Sat, 27 May 2017 08:00:00 GMT
```
### Year
```js
guessDate(now, 'May 27, 2018') // Sun, 27 May 2018 08:00:00 GMT
guessDate(now, 'May 27, 2016') // Fri, 27 May 2016 08:00:00 GMT
guessDate(now, 'January 2018') // Mon, 01 Jan 2018 08:00:00 GMT
```
### Time in day
```js
guessDate(now, '11:23') // Sun, 12 Feb 2017 11:23:00 GMT
guessDate(now, '11am') // Sun, 12 Feb 2017 11:00:00 GMT
guessDate(now, '11pm') // Sun, 12 Feb 2017 23:00:00 GMT
guessDate(now, '15:59') // Sun, 12 Feb 2017 15:59:00 GMT
guessDate(now, '5:15am') // Sun, 12 Feb 2017 05:15:00 GMT
guessDate(now, '5:45pm') // Sun, 12 Feb 2017 17:45:00 GMT
guessDate(now, '20:15') // Sun, 12 Feb 2017 20:15:00 GMT
guessDate(now, '25:05') // Mon, 13 Feb 2017 01:05:00 GMT
guessDate(now, '21:03:30') // Sun, 12 Feb 2017 21:03:30 GMT
```
### Mixed date and time
```js
guessDate(now, '6th December 2017 20:15') // Wed, 06 Dec 2017 20:15:00 GMT
```
### Specific problematic dates
```js
guessDate(now, 'Sept 1') // Wed, 01 Sep 2021 08:00:00 GMT
guessDate(now, 'Sept 4') // Sat, 04 Sep 2021 08:00:00 GMT
guessDate(now, 'Sat') // Sat, 04 Sep 2021 08:00:00 GMT
guessDate(now, 'April 2nd') // Sat, 02 Apr 2022 08:00:00 GMT
```