chrono-node 2.3.1 → 2.3.5

package/src/locales/zh/index.ts

@@ -0,0 +1,63 @@
+/**
+ * Chrono components for zh support
+ * TODO: Complete general zh support (current support only zh-Hant)
+ */
+
+import { Chrono, Configuration } from "../../chrono";
+import ExtractTimezoneOffsetRefiner from "../../common/refiners/ExtractTimezoneOffsetRefiner";
+import { includeCommonConfiguration } from "../../configurations";
+import { ParsedResult, ParsingOption } from "../../index";
+import ZHHantCasualDateParser from "./hant/parsers/ZHHantCasualDateParser";
+import ZHHantDateParser from "./hant/parsers/ZHHantDateParser";
+import ZHHantDeadlineFormatParser from "./hant/parsers/ZHHantDeadlineFormatParser";
+import ZHHantRelationWeekdayParser from "./hant/parsers/ZHHantRelationWeekdayParser";
+import ZHHantTimeExpressionParser from "./hant/parsers/ZHHantTimeExpressionParser";
+import ZHHantWeekdayParser from "./hant/parsers/ZHHantWeekdayParser";
+import ZHHantMergeDateRangeRefiner from "./hant/refiners/ZHHantMergeDateRangeRefiner";
+import ZHHantMergeDateTimeRefiner from "./hant/refiners/ZHHantMergeDateTimeRefiner";
+
+// Shortcuts
+export const hant = new Chrono(createCasualConfiguration());
+
+export const casual = new Chrono(createCasualConfiguration());
+export const strict = new Chrono(createConfiguration());
+
+export function parse(text: string, ref?: Date, option?: ParsingOption): ParsedResult[] {
+    return casual.parse(text, ref, option);
+}
+
+export function parseDate(text: string, ref?: Date, option?: ParsingOption): Date {
+    return casual.parseDate(text, ref, option);
+}
+
+/**
+ * @ignore (to be documented later)
+ */
+export function createCasualConfiguration(): Configuration {
+    const option = createConfiguration();
+    option.parsers.unshift(new ZHHantCasualDateParser());
+    return option;
+}
+
+/**
+ * @ignore (to be documented later)
+ */
+export function createConfiguration(): Configuration {
+    const configuration = includeCommonConfiguration({
+        parsers: [
+            new ZHHantDateParser(),
+            new ZHHantRelationWeekdayParser(),
+            new ZHHantWeekdayParser(),
+            new ZHHantTimeExpressionParser(),
+            new ZHHantDeadlineFormatParser(),
+        ],
+        refiners: [new ZHHantMergeDateRangeRefiner(), new ZHHantMergeDateTimeRefiner()],
+    });
+
+    // REMOVE ExtractTimezoneOffsetRefiner
+    configuration.refiners = configuration.refiners.filter(
+        (refiner) => !(refiner instanceof ExtractTimezoneOffsetRefiner)
+    );
+
+    return configuration;
+}

package/src/results.ts

@@ -8,7 +8,7 @@ dayjs.extend(quarterOfYear);
 
 export class ReferenceWithTimezone {
     readonly instant: Date;
-    readonly timezoneOffset: number;
+    readonly timezoneOffset?: number;
 
     constructor(input?: ParsingReference | Date) {
         input = input ?? new Date();
@@ -17,7 +17,7 @@ export class ReferenceWithTimezone {
             this.timezoneOffset = -input.getTimezoneOffset();
         } else {
             this.instant = input.instant ?? new Date();
-            this.timezoneOffset = toTimezoneOffset(input.timezone ?? -this.instant.getTimezoneOffset());
+            this.timezoneOffset = toTimezoneOffset(input.timezone);
         }
     }
 }
@@ -142,7 +142,7 @@ export class ParsingComponents implements ParsedComponents {
 
     date(): Date {
         const date = this.dateWithoutTimezoneAdjustment();
-        return new Date(date.getTime() + this.getSystemTimezoneAdjustmentMinute() * 60000);
+        return new Date(date.getTime() + this.getSystemTimezoneAdjustmentMinute(date) * 60000);
     }
 
     private dateWithoutTimezoneAdjustment() {
@@ -160,31 +160,41 @@ export class ParsingComponents implements ParsedComponents {
         return date;
     }
 
-    private getSystemTimezoneAdjustmentMinute() {
-        const currentTimezoneOffset = -new Date().getTimezoneOffset();
-        const targetTimezoneOffset = this.get("timezoneOffset") ?? this.reference.timezoneOffset;
+    private getSystemTimezoneAdjustmentMinute(date?: Date) {
+        if (!date || date.getTime() < 0) {
+            // Javascript date timezone calculation got effect when the time epoch < 0
+            // e.g. new Date('Tue Feb 02 1300 00:00:00 GMT+0900 (JST)') => Tue Feb 02 1300 00:18:59 GMT+0918 (JST)
+            date = new Date();
+        }
+
+        const currentTimezoneOffset = -date.getTimezoneOffset();
+        const targetTimezoneOffset =
+            this.get("timezoneOffset") ?? this.reference.timezoneOffset ?? currentTimezoneOffset;
 
         return currentTimezoneOffset - targetTimezoneOffset;
     }
 
-    static createRelativeFromRefInstant(
-        refInstant: Date,
+    static createRelativeFromReference(
+        reference: ReferenceWithTimezone,
         fragments: { [c in OpUnitType | QUnitType]?: number }
     ): ParsingComponents {
-        let date = dayjs(refInstant);
+        let date = dayjs(reference.instant);
         for (const key in fragments) {
             date = date.add(fragments[key as OpUnitType], key as OpUnitType);
         }
 
-        const reference = new ReferenceWithTimezone(refInstant);
         const components = new ParsingComponents(reference);
         if (fragments["hour"] || fragments["minute"] || fragments["second"]) {
             assignSimilarTime(components, date);
             assignSimilarDate(components, date);
-            components.assign("timezoneOffset", -refInstant.getTimezoneOffset());
+            if (reference.timezoneOffset !== null) {
+                components.assign("timezoneOffset", -reference.instant.getTimezoneOffset());
+            }
         } else {
             implySimilarTime(components, date);
-            components.imply("timezoneOffset", -refInstant.getTimezoneOffset());
+            if (reference.timezoneOffset !== null) {
+                components.imply("timezoneOffset", -reference.instant.getTimezoneOffset());
+            }
 
             if (fragments["d"]) {
                 components.assign("day", date.date());

package/src/timezone.ts

@@ -192,7 +192,11 @@ export const TIMEZONE_ABBR_MAP = {
     YEKT: 360,
 };
 
-export function toTimezoneOffset(timezoneInput: string | number): number {
+export function toTimezoneOffset(timezoneInput: string | number): number | null {
+    if (timezoneInput === null) {
+        return null;
+    }
+
     if (typeof timezoneInput === "number") {
         return timezoneInput;
     }

package/src/utils/dayjs.ts

@@ -1,5 +1,6 @@
 import { ParsingComponents } from "../results";
 import dayjs from "dayjs";
+import { Meridiem } from "../index";
 
 export function assignTheNextDay(component: ParsingComponents, targetDayJs: dayjs.Dayjs) {
     targetDayJs = targetDayJs.add(1, "day");
@@ -18,6 +19,11 @@ export function assignSimilarTime(component: ParsingComponents, targetDayJs: day
     component.assign("minute", targetDayJs.minute());
     component.assign("second", targetDayJs.second());
     component.assign("millisecond", targetDayJs.millisecond());
+    if (component.get("hour") < 12) {
+        component.assign("meridiem", Meridiem.AM);
+    } else {
+        component.assign("meridiem", Meridiem.PM);
+    }
 }
 
 export function implySimilarTime(component: ParsingComponents, targetDayJs: dayjs.Dayjs) {

package/test/en/en_casual.test.ts

@@ -21,6 +21,17 @@ test("Test - Single Expression", () => {
         expect(result.start).toBeDate(new Date(2012, 7, 10, 8, 9, 10, 11));
     });
 
+    testSingleCase(
+        chrono.casual,
+        "The Deadline is now, without implicit local timezone",
+        { instant: new Date(1637674343000), timezone: null },
+        (result) => {
+            expect(result.text).toBe("now");
+            expect(result.start).toBeDate(new Date(1637674343000));
+            expect(result.start.isCertain("timezoneOffset")).toBe(false);
+        }
+    );
+
     testSingleCase(chrono.casual, "The Deadline is today", new Date(2012, 7, 10, 14, 12), (result) => {
         expect(result.index).toBe(16);
         expect(result.text).toBe("today");

package/test/en/en_month_name_little_endian.test.ts

@@ -364,6 +364,16 @@ test("Test - Forward Option", () => {
         expect(result.end.get("day")).toBe(23);
         expect(result.end.get("hour")).toBe(19);
     });
+
+    testSingleCase(chrono, "17 August 2013 - 19 August 2013", (result) => {
+        expect(result.start.get("year")).toBe(2013);
+        expect(result.start.get("month")).toBe(8);
+        expect(result.start.get("day")).toBe(17);
+
+        expect(result.end.get("year")).toBe(2013);
+        expect(result.end.get("month")).toBe(8);
+        expect(result.end.get("day")).toBe(19);
+    });
 });
 
 test("Test - Impossible Dates (Strict Mode)", function () {

package/test/en/en_relative.test.ts

@@ -230,4 +230,12 @@ test("Test - Relative date components' certainty and imply timezone", () => {
         expect(result).toBeDate(new Date("Sun Nov 29 2020 13:34:13 GMT+0900 (Japan Standard Time)"));
         expect(result).toBeDate(new Date("Sun Nov 29 2020 5:34:13 GMT+0100"));
     }
+
+    {
+        const text = "in 20 minutes";
+        const result = chrono.parse(text, { instant: refDate, timezone: null })[0] as ParsingResult;
+
+        expect(result.text).toBe(text);
+        expect(result.start.isCertain("timezoneOffset")).toBe(false);
+    }
 });

package/test/en/en_slash.test.ts

@@ -203,4 +203,15 @@ test("Test - forward dates only option", function () {
 
         expect(result.start).toBeDate(new Date(2000, 5 - 1, 31, 12));
     });
+
+    testSingleCase(chrono, "1/8 at 12pm", new Date("Sep 25 2021 12:00:00"), { forwardDate: true }, (result) => {
+        expect(result.text).toBe("1/8 at 12pm");
+
+        expect(result.start).not.toBeNull();
+        expect(result.start.get("year")).toBe(2022);
+        expect(result.start.get("month")).toBe(1);
+        expect(result.start.get("day")).toBe(8);
+
+        expect(result.start).toBeDate(new Date(2022, 1 - 1, 8, 12));
+    });
 });

package/test/en/en_time_units_ago.test.ts

@@ -1,5 +1,6 @@
 import * as chrono from "../../src/";
 import { testSingleCase, testUnexpectedResult } from "../test_util";
+import { Meridiem } from "../../src/";
 
 test("Test - Single Expression", function () {
     testSingleCase(chrono, "5 days ago, we did something", new Date(2012, 7, 10), (result) => {
@@ -31,6 +32,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("15 minute ago");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(59);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 59));
     });
@@ -40,6 +42,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("15 minute earlier");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(59);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 59));
     });
@@ -49,6 +52,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("15 minute before");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(59);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 59));
     });
@@ -58,6 +62,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("12 hours ago");
         expect(result.start.get("hour")).toBe(0);
         expect(result.start.get("minute")).toBe(14);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 0, 14));
     });
@@ -67,6 +72,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("1h ago");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(14);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
     });
 
     testSingleCase(chrono, "1hr ago", new Date(2012, 7, 10, 12, 14), (result) => {
@@ -74,6 +80,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("1hr ago");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(14);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
     });
 
     testSingleCase(chrono, "   half an hour ago", new Date(2012, 7, 10, 12, 14), (result) => {
@@ -81,6 +88,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("half an hour ago");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(44);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 44));
     });
@@ -90,6 +98,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("12 hours ago");
         expect(result.start.get("hour")).toBe(0);
         expect(result.start.get("minute")).toBe(14);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 0, 14));
     });
@@ -100,6 +109,7 @@ test("Test - Single Expression", function () {
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(13);
         expect(result.start.get("second")).toBe(48);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 13, 48));
     });
@@ -110,6 +120,7 @@ test("Test - Single Expression", function () {
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(13);
         expect(result.start.get("second")).toBe(57);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 13, 57));
     });
@@ -131,6 +142,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("half An hour ago");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(44);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 44));
     });
@@ -152,6 +164,7 @@ test("Test - Single Expression", function () {
         expect(result.text).toBe("a min before");
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(13);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 13));
     });
@@ -213,6 +226,7 @@ test("Test - Nested time ago", function () {
         expect(result.start.get("day")).toBe(10);
         expect(result.start.get("hour")).toBe(7);
         expect(result.start.get("minute")).toBe(1);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
     });
 
     testSingleCase(chrono, "1 day 21 hours ago ", new Date(2012, 7, 10, 22, 30), (result) => {
@@ -220,6 +234,7 @@ test("Test - Nested time ago", function () {
         expect(result.start.get("day")).toBe(9);
         expect(result.start.get("hour")).toBe(1);
         expect(result.start.get("minute")).toBe(30);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
     });
 
     testSingleCase(chrono, "3 min 49 sec ago ", new Date(2012, 7, 10, 22, 30), (result) => {
@@ -228,6 +243,7 @@ test("Test - Nested time ago", function () {
         expect(result.start.get("hour")).toBe(22);
         expect(result.start.get("minute")).toBe(26);
         expect(result.start.get("second")).toBe(11);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
     });
 });
 

package/test/en/en_time_units_later.test.ts

@@ -1,5 +1,6 @@
 import * as chrono from "../../src/";
 import { testSingleCase } from "../test_util";
+import { Meridiem } from "../../src/";
 
 test("Test - Later Expression", function () {
     testSingleCase(chrono, "2 days later", new Date(2012, 7, 10, 12), (result) => {
@@ -77,6 +78,7 @@ test("Test - From now Expression", () => {
         expect(result.text).toBe("15 minute from now");
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(29);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 29));
     });
@@ -86,6 +88,7 @@ test("Test - From now Expression", () => {
         expect(result.text).toBe("15 minutes earlier");
         expect(result.start.get("hour")).toBe(11);
         expect(result.start.get("minute")).toBe(59);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 11, 59));
     });
@@ -95,6 +98,7 @@ test("Test - From now Expression", () => {
         expect(result.text).toBe("15 minute out");
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(29);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 29));
     });
@@ -115,6 +119,7 @@ test("Test - From now Expression", () => {
         expect(result.start.get("day")).toBe(11);
         expect(result.start.get("hour")).toBe(0);
         expect(result.start.get("minute")).toBe(14);
+        expect(result.start.get("meridiem")).toBe(Meridiem.AM);
     });
 
     testSingleCase(chrono, "   half an hour from now", new Date(2012, 7, 10, 12, 14), (result) => {
@@ -122,6 +127,7 @@ test("Test - From now Expression", () => {
         expect(result.text).toBe("half an hour from now");
         expect(result.start.get("hour")).toBe(12);
         expect(result.start.get("minute")).toBe(44);
+        expect(result.start.get("meridiem")).toBe(Meridiem.PM);
 
         expect(result.start).toBeDate(new Date(2012, 7, 10, 12, 44));
     });

package/test/en/en_timezone_exp.test.ts

@@ -81,20 +81,95 @@ test("Test - Parsing date with timezone abbreviation", function () {
 });
 
 test("Test - Not parsing timezone from relative time", function () {
-    const refDate = new Date(2020, 11 - 1, 14, 13, 48, 22);
+    {
+        const refInstant = new Date("Sun Nov 29 2020 13:24:13 GMT+0900 (Japan Standard Time)");
+        const expectedInstant = new Date("Sun Nov 29 2020 14:24:13 GMT+0900 (Japan Standard Time)");
+
+        testSingleCase(chrono, "in 1 hour get eggs and milk", refInstant, (result, text) => {
+            expect(result.text).toBe("in 1 hour");
+            expect(result.start.get("timezoneOffset")).toBe(-refInstant.getTimezoneOffset());
+            expect(result.start).toBeDate(expectedInstant);
+        });
+    }
+
+    {
+        const refInstant = new Date("Sun Nov 29 2020 13:24:13 GMT+0900 (Japan Standard Time)");
+        const expectedInstant = new Date("Sun Nov 29 2020 14:24:13 GMT+0900 (Japan Standard Time)");
+
+        testSingleCase(chrono, "in 1 hour GMT", refInstant, (result, text) => {
+            expect(result.text).toBe("in 1 hour");
+            expect(result.start).toBeDate(expectedInstant);
+        });
+    }
+
+    {
+        const refInstant = new Date("Sun Nov 29 2020 13:24:13 GMT+0900 (Japan Standard Time)");
+        const expectedInstant = new Date("Sun Nov 29 2020 14:24:13 GMT+0900 (Japan Standard Time)");
+
+        testSingleCase(chrono, "in 1 hour GMT", { instant: refInstant, timezone: "JST" }, (result, text) => {
+            expect(result.text).toBe("in 1 hour");
+            expect(result.start).toBeDate(expectedInstant);
+        });
+    }
+
+    {
+        const refInstant = new Date("Sun Nov 29 2020 13:24:13 GMT+0900 (Japan Standard Time)");
+        const expectedInstant = new Date("Sun Nov 29 2020 14:24:13 GMT+0900 (Japan Standard Time)");
+
+        testSingleCase(chrono, "in 1 hour GMT", { instant: refInstant, timezone: "BST" }, (result, text) => {
+            expect(result.text).toBe("in 1 hour");
+            expect(result.start).toBeDate(expectedInstant);
+        });
+    }
+});
 
-    testSingleCase(chrono, "in 1 hour get eggs and milk", refDate, (result, text) => {
-        expect(result.text).toBe("in 1 hour");
-        expect(result.start.get("timezoneOffset")).toBe(-refDate.getTimezoneOffset());
+test("Test - Relative time (Now) is not effected by timezone setting", function () {
+    const refInstant = new Date(1637674343000);
+
+    testSingleCase(chrono, "now", { instant: refInstant }, (result) => {
+        expect(result.text).toBe("now");
+        expect(result.start).toBeDate(refInstant);
+    });
+
+    testSingleCase(chrono, "now", { instant: refInstant, timezone: null }, (result) => {
+        expect(result.text).toBe("now");
+        expect(result.start).toBeDate(refInstant);
+    });
+
+    testSingleCase(chrono, "now", { instant: refInstant, timezone: "BST" }, (result) => {
+        expect(result.text).toBe("now");
+        expect(result.start).toBeDate(refInstant);
+    });
+
+    testSingleCase(chrono, "now", { instant: refInstant, timezone: "JST" }, (result) => {
+        expect(result.text).toBe("now");
+        expect(result.start).toBeDate(refInstant);
     });
+});
 
-    // This test fail when the system/assume timezone is exactly similar to the mentioned timezone
-    // Temporary disable this test
+test("Test - Relative time (2 hour later) is not effected by timezone setting", function () {
+    const refInstant = new Date(1637674343000);
+    const expectedInstant = new Date(1637674343000 + 2 * 60 * 60 * 1000);
 
-    // testSingleCase(chrono, "in 3 hours GMT", refDate, (result, text) => {
-    //     expect(result.text).toBe("in 3 hours");
-    //     expect(result.start.get("timezoneOffset")).toBe(-refDate.getTimezoneOffset());
-    // });
+    testSingleCase(chrono, "2 hour later", { instant: refInstant }, (result) => {
+        expect(result.text).toBe("2 hour later");
+        expect(result.start).toBeDate(expectedInstant);
+    });
+
+    testSingleCase(chrono, "2 hour later", { instant: refInstant, timezone: null }, (result) => {
+        expect(result.text).toBe("2 hour later");
+        expect(result.start).toBeDate(expectedInstant);
+    });
+
+    testSingleCase(chrono, "2 hour later", { instant: refInstant, timezone: "BST" }, (result) => {
+        expect(result.text).toBe("2 hour later");
+        expect(result.start).toBeDate(expectedInstant);
+    });
+
+    testSingleCase(chrono, "2 hour later", { instant: refInstant, timezone: "JST" }, (result) => {
+        expect(result.text).toBe("2 hour later");
+        expect(result.start).toBeDate(expectedInstant);
+    });
 });
 
 test("Test - Parsing timezone from relative date when valid", function () {

package/test/en/en_weekday.test.ts

@@ -20,30 +20,6 @@ test("Test - Single Expression", function () {
         expect(result.start).toBeDate(new Date(2012, 7, 6, 12));
     });
 
-    testSingleCase(
-        chrono.casual,
-        "Monday (forward dates only)",
-        new Date(2012, 7, 9),
-        { forwardDate: true },
-        (result) => {
-            expect(result.index).toBe(0);
-            expect(result.text).toBe("Monday");
-
-            expect(result.start).not.toBeNull();
-            expect(result.start.get("year")).toBe(2012);
-            expect(result.start.get("month")).toBe(8);
-            expect(result.start.get("day")).toBe(13);
-            expect(result.start.get("weekday")).toBe(1);
-
-            expect(result.start.isCertain("day")).toBe(false);
-            expect(result.start.isCertain("month")).toBe(false);
-            expect(result.start.isCertain("year")).toBe(false);
-            expect(result.start.isCertain("weekday")).toBe(true);
-
-            expect(result.start).toBeDate(new Date(2012, 7, 13, 12));
-        }
-    );
-
     testSingleCase(chrono.casual, "Thursday", new Date(2012, 7, 9), (result) => {
         expect(result.index).toBe(0);
         expect(result.text).toBe("Thursday");
@@ -182,7 +158,31 @@ test("Test - Weekday Overlap", function () {
     });
 });
 
-test("Test - forward dates only option", function () {
+test("Test - forward dates only option", () => {
+    testSingleCase(
+        chrono.casual,
+        "Monday (forward dates only)",
+        new Date(2012, 7, 9),
+        { forwardDate: true },
+        (result) => {
+            expect(result.index).toBe(0);
+            expect(result.text).toBe("Monday");
+
+            expect(result.start).not.toBeNull();
+            expect(result.start.get("year")).toBe(2012);
+            expect(result.start.get("month")).toBe(8);
+            expect(result.start.get("day")).toBe(13);
+            expect(result.start.get("weekday")).toBe(1);
+
+            expect(result.start.isCertain("day")).toBe(false);
+            expect(result.start.isCertain("month")).toBe(false);
+            expect(result.start.isCertain("year")).toBe(false);
+            expect(result.start.isCertain("weekday")).toBe(true);
+
+            expect(result.start).toBeDate(new Date(2012, 7, 13, 12));
+        }
+    );
+
     testSingleCase(
         chrono.casual,
         "this Friday to this Monday",
@@ -219,4 +219,48 @@ test("Test - forward dates only option", function () {
             expect(result.end).toBeDate(new Date(2016, 8 - 1, 8, 12));
         }
     );
+
+    testSingleCase(
+        chrono.casual,
+        "sunday morning",
+        new Date("August 15, 2021, 20:00"),
+        { forwardDate: true },
+        (result) => {
+            expect(result.index).toBe(0);
+            expect(result.text).toBe("sunday morning");
+
+            expect(result.start).not.toBeNull();
+            expect(result.start.get("year")).toBe(2021);
+            expect(result.start.get("month")).toBe(8);
+            expect(result.start.get("day")).toBe(22);
+            expect(result.start.get("weekday")).toBe(0);
+
+            expect(result.start.isCertain("day")).toBe(false);
+            expect(result.start.isCertain("month")).toBe(false);
+            expect(result.start.isCertain("year")).toBe(false);
+            expect(result.start.isCertain("weekday")).toBe(true);
+
+            expect(result.start).toBeDate(new Date(2021, 8 - 1, 22, 6));
+        }
+    );
+
+    testSingleCase(
+        chrono.casual,
+        "vacation monday - friday",
+        new Date("thursday 13 June 2019"),
+        { forwardDate: true },
+        (result) => {
+            expect(result.text).toBe("monday - friday");
+
+            expect(result.start).not.toBeNull();
+            expect(result.start.get("year")).toBe(2019);
+            expect(result.start.get("month")).toBe(6);
+            expect(result.start.get("day")).toBe(17);
+
+            expect(result.end).not.toBeNull();
+            expect(result.end.get("year")).toBe(2019);
+            expect(result.end.get("month")).toBe(6);
+            expect(result.end.get("day")).toBe(21);
+        }
+    );
 });

package/test/en/negative_cases.test.ts

@@ -21,6 +21,8 @@ test("Test - Skip random non-date patterns", function () {
     testUnexpectedResult(chrono, "Total: $1,194.09 [image: View Reservation");
 
     testUnexpectedResult(chrono, "at 6.5 kilograms");
+
+    testUnexpectedResult(chrono, "ah that is unusual", null, { forwardDate: true });
 });
 
 test("Test - URLs % encoded", function () {

package/test/test_util.ts

@@ -61,10 +61,13 @@ export function testWithExpectedDate(chrono: ChronoLike, text: string, expectedD
     });
 }
 
-export function testUnexpectedResult(chrono: ChronoLike, text: string, refDate?: Date) {
+export function testUnexpectedResult(chrono: ChronoLike, text: string, refDate?: Date, options?: ParsingOption) {
     const debugHandler = new BufferedDebugHandler();
+    options = options || {};
+    options.debug = debugHandler;
+
     try {
-        const results = chrono.parse(text, refDate, { debug: debugHandler });
+        const results = chrono.parse(text, refDate, options);
         expect(results).toHaveLength(0);
     } catch (e) {
         debugHandler.executeBufferedBlocks();