chrono-node 2.3.2 → 2.3.6

package/src/locales/zh/hant/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 "./parsers/ZHHantCasualDateParser";
+import ZHHantDateParser from "./parsers/ZHHantDateParser";
+import ZHHantDeadlineFormatParser from "./parsers/ZHHantDeadlineFormatParser";
+import ZHHantRelationWeekdayParser from "./parsers/ZHHantRelationWeekdayParser";
+import ZHHantTimeExpressionParser from "./parsers/ZHHantTimeExpressionParser";
+import ZHHantWeekdayParser from "./parsers/ZHHantWeekdayParser";
+import ZHHantMergeDateRangeRefiner from "./refiners/ZHHantMergeDateRangeRefiner";
+import ZHHantMergeDateTimeRefiner from "./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/locales/zh/hant/parsers/ZHHantCasualDateParser.ts

@@ -0,0 +1,128 @@
+import dayjs from "dayjs";
+import { ParsingContext } from "../../../../chrono";
+import { AbstractParserWithWordBoundaryChecking } from "../../../../common/parsers/AbstractParserWithWordBoundary";
+import { ParsingComponents, ParsingResult } from "../../../../results";
+
+const NOW_GROUP = 1;
+const DAY_GROUP_1 = 2;
+const TIME_GROUP_1 = 3;
+const TIME_GROUP_2 = 4;
+const DAY_GROUP_3 = 5;
+const TIME_GROUP_3 = 6;
+
+export default class ZHHantCasualDateParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(context: ParsingContext): RegExp {
+        return new RegExp(
+            "(而家|立(?:刻|即)|即刻)|" +
+                "(今|明|前|大前|後|大後|聽|昨|尋|琴)(早|朝|晚)|" +
+                "(上(?:午|晝)|朝(?:早)|早(?:上)|下(?:午|晝)|晏(?:晝)|晚(?:上)|夜(?:晚)?|中(?:午)|凌(?:晨))|" +
+                "(今|明|前|大前|後|大後|聽|昨|尋|琴)(?:日|天)" +
+                "(?:[\\s|,|，]*)" +
+                "(?:(上(?:午|晝)|朝(?:早)|早(?:上)|下(?:午|晝)|晏(?:晝)|晚(?:上)|夜(?:晚)?|中(?:午)|凌(?:晨)))?",
+            "i"
+        );
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray): ParsingComponents | ParsingResult {
+        const index = match.index;
+        const result = context.createParsingResult(index, match[0]);
+
+        const refMoment = dayjs(context.refDate);
+        let startMoment = refMoment;
+
+        if (match[NOW_GROUP]) {
+            result.start.imply("hour", refMoment.hour());
+            result.start.imply("minute", refMoment.minute());
+            result.start.imply("second", refMoment.second());
+            result.start.imply("millisecond", refMoment.millisecond());
+        } else if (match[DAY_GROUP_1]) {
+            const day1 = match[DAY_GROUP_1];
+            const time1 = match[TIME_GROUP_1];
+
+            if (day1 == "明" || day1 == "聽") {
+                // Check not "Tomorrow" on late night
+                if (refMoment.hour() > 1) {
+                    startMoment = startMoment.add(1, "day");
+                }
+            } else if (day1 == "昨" || day1 == "尋" || day1 == "琴") {
+                startMoment = startMoment.add(-1, "day");
+            } else if (day1 == "前") {
+                startMoment = startMoment.add(-2, "day");
+            } else if (day1 == "大前") {
+                startMoment = startMoment.add(-3, "day");
+            } else if (day1 == "後") {
+                startMoment = startMoment.add(2, "day");
+            } else if (day1 == "大後") {
+                startMoment = startMoment.add(3, "day");
+            }
+
+            if (time1 == "早" || time1 == "朝") {
+                result.start.imply("hour", 6);
+            } else if (time1 == "晚") {
+                result.start.imply("hour", 22);
+                result.start.imply("meridiem", 1);
+            }
+        } else if (match[TIME_GROUP_2]) {
+            const timeString2 = match[TIME_GROUP_2];
+            const time2 = timeString2[0];
+            if (time2 == "早" || time2 == "朝" || time2 == "上") {
+                result.start.imply("hour", 6);
+            } else if (time2 == "下" || time2 == "晏") {
+                result.start.imply("hour", 15);
+                result.start.imply("meridiem", 1);
+            } else if (time2 == "中") {
+                result.start.imply("hour", 12);
+                result.start.imply("meridiem", 1);
+            } else if (time2 == "夜" || time2 == "晚") {
+                result.start.imply("hour", 22);
+                result.start.imply("meridiem", 1);
+            } else if (time2 == "凌") {
+                result.start.imply("hour", 0);
+            }
+        } else if (match[DAY_GROUP_3]) {
+            const day3 = match[DAY_GROUP_3];
+
+            if (day3 == "明" || day3 == "聽") {
+                // Check not "Tomorrow" on late night
+                if (refMoment.hour() > 1) {
+                    startMoment = startMoment.add(1, "day");
+                }
+            } else if (day3 == "昨" || day3 == "尋" || day3 == "琴") {
+                startMoment = startMoment.add(-1, "day");
+            } else if (day3 == "前") {
+                startMoment = startMoment.add(-2, "day");
+            } else if (day3 == "大前") {
+                startMoment = startMoment.add(-3, "day");
+            } else if (day3 == "後") {
+                startMoment = startMoment.add(2, "day");
+            } else if (day3 == "大後") {
+                startMoment = startMoment.add(3, "day");
+            }
+
+            const timeString3 = match[TIME_GROUP_3];
+            if (timeString3) {
+                const time3 = timeString3[0];
+                if (time3 == "早" || time3 == "朝" || time3 == "上") {
+                    result.start.imply("hour", 6);
+                } else if (time3 == "下" || time3 == "晏") {
+                    result.start.imply("hour", 15);
+                    result.start.imply("meridiem", 1);
+                } else if (time3 == "中") {
+                    result.start.imply("hour", 12);
+                    result.start.imply("meridiem", 1);
+                } else if (time3 == "夜" || time3 == "晚") {
+                    result.start.imply("hour", 22);
+                    result.start.imply("meridiem", 1);
+                } else if (time3 == "凌") {
+                    result.start.imply("hour", 0);
+                }
+            }
+        }
+
+        result.start.assign("day", startMoment.date());
+        result.start.assign("month", startMoment.month() + 1);
+        result.start.assign("year", startMoment.year());
+
+        return result;
+    }
+}

package/src/locales/zh/hant/parsers/ZHHantDateParser.ts

@@ -0,0 +1,68 @@
+import dayjs from "dayjs";
+import { ParsingContext } from "../../../../chrono";
+import { AbstractParserWithWordBoundaryChecking } from "../../../../common/parsers/AbstractParserWithWordBoundary";
+import { NUMBER, zhStringToNumber, zhStringToYear } from "../constants";
+
+const YEAR_GROUP = 1;
+const MONTH_GROUP = 2;
+const DAY_GROUP = 3;
+
+export default class ZHHantDateParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern() {
+        // prettier-ignore
+        return new RegExp(
+            "(" +
+                "\\d{2,4}|" +
+                "[" + Object.keys(NUMBER).join("") + "]{4}|" +
+                "[" + Object.keys(NUMBER).join("") + "]{2}" +
+            ")?"+
+            "(?:\\s*)" +
+            "(?:年)?" +
+            "(?:[\\s|,|，]*)" +
+
+            "(" +
+                "\\d{1,2}|"+
+                "[" +Object.keys(NUMBER).join("") +"]{1,2}"+
+            ")" +
+            "(?:\\s*)" +
+            "(?:月)" +
+            "(?:\\s*)" +
+            "(" + 
+                "\\d{1,2}|" +
+                "[" + Object.keys(NUMBER).join("") + "]{1,2}" +
+            ")?" +
+            "(?:\\s*)" +
+            "(?:日|號)?"
+        );
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray) {
+        const startMoment = dayjs(context.refDate);
+        const result = context.createParsingResult(match.index, match[0]);
+
+        //Month
+        let month = parseInt(match[MONTH_GROUP]);
+        if (isNaN(month)) month = zhStringToNumber(match[MONTH_GROUP]);
+        result.start.assign("month", month);
+
+        //Day
+        if (match[DAY_GROUP]) {
+            let day = parseInt(match[DAY_GROUP]);
+            if (isNaN(day)) day = zhStringToNumber(match[DAY_GROUP]);
+            result.start.assign("day", day);
+        } else {
+            result.start.imply("day", startMoment.date());
+        }
+
+        //Year
+        if (match[YEAR_GROUP]) {
+            let year = parseInt(match[YEAR_GROUP]);
+            if (isNaN(year)) year = zhStringToYear(match[YEAR_GROUP]);
+            result.start.assign("year", year);
+        } else {
+            result.start.imply("year", startMoment.year());
+        }
+
+        return result;
+    }
+}

package/src/locales/zh/hant/parsers/ZHHantDeadlineFormatParser.ts

@@ -0,0 +1,81 @@
+import dayjs from "dayjs";
+import { ParsingContext } from "../../../../chrono";
+import { AbstractParserWithWordBoundaryChecking } from "../../../../common/parsers/AbstractParserWithWordBoundary";
+import { NUMBER, zhStringToNumber } from "../constants";
+
+const PATTERN = new RegExp(
+    "(\\d+|[" +
+        Object.keys(NUMBER).join("") +
+        "]+|半|幾)(?:\\s*)" +
+        "(?:個)?" +
+        "(秒(?:鐘)?|分鐘|小時|鐘|日|天|星期|禮拜|月|年)" +
+        "(?:(?:之|過)?後|(?:之)?內)",
+    "i"
+);
+
+const NUMBER_GROUP = 1;
+const UNIT_GROUP = 2;
+
+export default class ZHHantDeadlineFormatParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(): RegExp {
+        return PATTERN;
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray) {
+        const result = context.createParsingResult(match.index, match[0]);
+
+        let number = parseInt(match[NUMBER_GROUP]);
+        if (isNaN(number)) {
+            number = zhStringToNumber(match[NUMBER_GROUP]);
+        }
+
+        if (isNaN(number)) {
+            const string = match[NUMBER_GROUP];
+            if (string === "幾") {
+                number = 3;
+            } else if (string === "半") {
+                number = 0.5;
+            } else {
+                //just in case
+                return null;
+            }
+        }
+
+        let date = dayjs(context.refDate);
+        const unit = match[UNIT_GROUP];
+        const unitAbbr = unit[0];
+
+        if (unitAbbr.match(/[日天星禮月年]/)) {
+            if (unitAbbr == "日" || unitAbbr == "天") {
+                date = date.add(number, "d");
+            } else if (unitAbbr == "星" || unitAbbr == "禮") {
+                date = date.add(number * 7, "d");
+            } else if (unitAbbr == "月") {
+                date = date.add(number, "month");
+            } else if (unitAbbr == "年") {
+                date = date.add(number, "year");
+            }
+
+            result.start.assign("year", date.year());
+            result.start.assign("month", date.month() + 1);
+            result.start.assign("day", date.date());
+            return result;
+        }
+
+        if (unitAbbr == "秒") {
+            date = date.add(number, "second");
+        } else if (unitAbbr == "分") {
+            date = date.add(number, "minute");
+        } else if (unitAbbr == "小" || unitAbbr == "鐘") {
+            date = date.add(number, "hour");
+        }
+
+        result.start.imply("year", date.year());
+        result.start.imply("month", date.month() + 1);
+        result.start.imply("day", date.date());
+        result.start.assign("hour", date.hour());
+        result.start.assign("minute", date.minute());
+        result.start.assign("second", date.second());
+        return result;
+    }
+}

package/src/locales/zh/hant/parsers/ZHHantRelationWeekdayParser.ts

@@ -0,0 +1,69 @@
+import dayjs from "dayjs";
+import { ParsingContext } from "../../../../chrono";
+import { AbstractParserWithWordBoundaryChecking } from "../../../../common/parsers/AbstractParserWithWordBoundary";
+import { ParsingResult } from "../../../../results";
+import { WEEKDAY_OFFSET } from "../constants";
+
+const PATTERN = new RegExp(
+    "(?<prefix>上|今|下|這|呢)(?:個)?(?:星期|禮拜|週)(?<weekday>" + Object.keys(WEEKDAY_OFFSET).join("|") + ")"
+);
+
+export default class ZHHantRelationWeekdayParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(): RegExp {
+        return PATTERN;
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray): ParsingResult {
+        const result = context.createParsingResult(match.index, match[0]);
+
+        const dayOfWeek = match.groups.weekday;
+        const offset = WEEKDAY_OFFSET[dayOfWeek];
+        if (offset === undefined) return null;
+
+        let modifier = null;
+        const prefix = match.groups.prefix;
+
+        if (prefix == "上") {
+            modifier = "last";
+        } else if (prefix == "下") {
+            modifier = "next";
+        } else if (prefix == "今" || prefix == "這" || prefix == "呢") {
+            modifier = "this";
+        }
+
+        let startMoment = dayjs(context.refDate);
+        let startMomentFixed = false;
+        const refOffset = startMoment.day();
+
+        if (modifier == "last" || modifier == "past") {
+            startMoment = startMoment.day(offset - 7);
+            startMomentFixed = true;
+        } else if (modifier == "next") {
+            startMoment = startMoment.day(offset + 7);
+            startMomentFixed = true;
+        } else if (modifier == "this") {
+            startMoment = startMoment.day(offset);
+        } else {
+            if (Math.abs(offset - 7 - refOffset) < Math.abs(offset - refOffset)) {
+                startMoment = startMoment.day(offset - 7);
+            } else if (Math.abs(offset + 7 - refOffset) < Math.abs(offset - refOffset)) {
+                startMoment = startMoment.day(offset + 7);
+            } else {
+                startMoment = startMoment.day(offset);
+            }
+        }
+
+        result.start.assign("weekday", offset);
+        if (startMomentFixed) {
+            result.start.assign("day", startMoment.date());
+            result.start.assign("month", startMoment.month() + 1);
+            result.start.assign("year", startMoment.year());
+        } else {
+            result.start.imply("day", startMoment.date());
+            result.start.imply("month", startMoment.month() + 1);
+            result.start.imply("year", startMoment.year());
+        }
+
+        return result;
+    }
+}