chrono-node 2.8.2 → 2.8.4

package/src/locales/sv/constants.ts

@@ -0,0 +1,215 @@
+import { OpUnitType, QUnitType } from "dayjs";
+import { matchAnyPattern, repeatedTimeunitPattern } from "../../utils/pattern";
+import { findMostLikelyADYear } from "../../calculation/years";
+import { TimeUnits } from "../../utils/timeunits";
+
+export const WEEKDAY_DICTIONARY: { [word: string]: number } = {
+    "söndag": 0,
+    "sön": 0,
+    "so": 0,
+    "måndag": 1,
+    "mån": 1,
+    "må": 1,
+    "tisdag": 2,
+    "tis": 2,
+    "ti": 2,
+    "onsdag": 3,
+    "ons": 3,
+    "on": 3,
+    "torsdag": 4,
+    "tors": 4,
+    "to": 4,
+    "fredag": 5,
+    "fre": 5,
+    "fr": 5,
+    "lördag": 6,
+    "lör": 6,
+    "lö": 6,
+};
+
+export const MONTH_DICTIONARY: { [word: string]: number } = {
+    "januari": 1,
+    "jan": 1,
+    "jan.": 1,
+    "februari": 2,
+    "feb": 2,
+    "feb.": 2,
+    "mars": 3,
+    "mar": 3,
+    "mar.": 3,
+    "april": 4,
+    "apr": 4,
+    "apr.": 4,
+    "maj": 5,
+    "juni": 6,
+    "jun": 6,
+    "jun.": 6,
+    "juli": 7,
+    "jul": 7,
+    "jul.": 7,
+    "augusti": 8,
+    "aug": 8,
+    "aug.": 8,
+    "september": 9,
+    "sep": 9,
+    "sep.": 9,
+    "sept": 9,
+    "oktober": 10,
+    "okt": 10,
+    "okt.": 10,
+    "november": 11,
+    "nov": 11,
+    "nov.": 11,
+    "december": 12,
+    "dec": 12,
+    "dec.": 12,
+};
+
+export const ORDINAL_NUMBER_DICTIONARY: { [word: string]: number } = {
+    "första": 1,
+    "andra": 2,
+    "tredje": 3,
+    "fjärde": 4,
+    "femte": 5,
+    "sjätte": 6,
+    "sjunde": 7,
+    "åttonde": 8,
+    "nionde": 9,
+    "tionde": 10,
+    "elfte": 11,
+    "tolfte": 12,
+    "trettonde": 13,
+    "fjortonde": 14,
+    "femtonde": 15,
+    "sextonde": 16,
+    "sjuttonde": 17,
+    "artonde": 18,
+    "nittonde": 19,
+    "tjugonde": 20,
+    "tjugoförsta": 21,
+    "tjugoandra": 22,
+    "tjugotredje": 23,
+    "tjugofjärde": 24,
+    "tjugofemte": 25,
+    "tjugosjätte": 26,
+    "tjugosjunde": 27,
+    "tjugoåttonde": 28,
+    "tjugonionde": 29,
+    "trettionde": 30,
+    "trettioförsta": 31,
+};
+
+export const INTEGER_WORD_DICTIONARY: { [word: string]: number } = {
+    "en": 1,
+    "ett": 1,
+    "två": 2,
+    "tre": 3,
+    "fyra": 4,
+    "fem": 5,
+    "sex": 6,
+    "sju": 7,
+    "åtta": 8,
+    "nio": 9,
+    "tio": 10,
+    "elva": 11,
+    "tolv": 12,
+    "tretton": 13,
+    "fjorton": 14,
+    "femton": 15,
+    "sexton": 16,
+    "sjutton": 17,
+    "arton": 18,
+    "nitton": 19,
+    "tjugo": 20,
+    "trettiо": 30,
+    "fyrtio": 40,
+    "femtio": 50,
+    "sextio": 60,
+    "sjuttio": 70,
+    "åttio": 80,
+    "nittio": 90,
+    "hundra": 100,
+    "tusen": 1000,
+};
+
+export const TIME_UNIT_DICTIONARY: { [word: string]: OpUnitType | QUnitType } = {
+    "sekund": "second",
+    "sekunder": "second",
+    "sek": "second",
+    "minut": "minute",
+    "minuter": "minute",
+    "min": "minute",
+    "timme": "hour",
+    "timmar": "hour",
+    "tim": "hour",
+    "dag": "day",
+    "dagar": "day",
+    "vecka": "week",
+    "veckor": "week",
+    "månad": "month",
+    "månader": "month",
+    "mån": "month",
+    "år": "year",
+    "kvartаl": "quarter",
+    "kvartal": "quarter",
+};
+
+export function parseTimeUnits(timeunitText): TimeUnits {
+    const fragments = {};
+    let remainingText = timeunitText;
+    let match = SINGLE_TIME_UNIT_REGEX.exec(remainingText);
+    while (match) {
+        collectDateTimeFragment(fragments, match);
+        remainingText = remainingText.substring(match[0].length);
+        match = SINGLE_TIME_UNIT_REGEX.exec(remainingText);
+    }
+    return fragments;
+}
+
+function collectDateTimeFragment(fragments, match) {
+    const num = parseNumberPattern(match[1]);
+    const unit = TIME_UNIT_DICTIONARY[match[2].toLowerCase()];
+    fragments[unit] = num;
+}
+
+export const NUMBER_PATTERN = `(?:${matchAnyPattern(INTEGER_WORD_DICTIONARY)}|\\d+)`;
+export const ORDINAL_NUMBER_PATTERN = `(?:${matchAnyPattern(ORDINAL_NUMBER_DICTIONARY)}|\\d{1,2}(?:e|:e))`;
+export const TIME_UNIT_PATTERN = `(?:${matchAnyPattern(TIME_UNIT_DICTIONARY)})`;
+
+const SINGLE_TIME_UNIT_PATTERN = `(${NUMBER_PATTERN})\\s{0,5}(${matchAnyPattern(TIME_UNIT_DICTIONARY)})\\s{0,5}`;
+const SINGLE_TIME_UNIT_REGEX = new RegExp(SINGLE_TIME_UNIT_PATTERN, "i");
+
+export const TIME_UNITS_PATTERN = repeatedTimeunitPattern("", SINGLE_TIME_UNIT_PATTERN);
+
+export function parseNumberPattern(match: string): number {
+    const num = match.toLowerCase();
+    if (INTEGER_WORD_DICTIONARY[num] !== undefined) {
+        return INTEGER_WORD_DICTIONARY[num];
+    }
+    return parseInt(num);
+}
+
+export function parseOrdinalNumberPattern(match: string): number {
+    const num = match.toLowerCase();
+    if (ORDINAL_NUMBER_DICTIONARY[num] !== undefined) {
+        return ORDINAL_NUMBER_DICTIONARY[num];
+    }
+    return parseInt(num);
+}
+
+export function parseYear(match: string): number {
+    if (/\d+/.test(match)) {
+        let yearNumber = parseInt(match);
+        if (yearNumber < 100) {
+            yearNumber = findMostLikelyADYear(yearNumber);
+        }
+        return yearNumber;
+    }
+
+    const num = match.toLowerCase();
+    if (INTEGER_WORD_DICTIONARY[num] !== undefined) {
+        return INTEGER_WORD_DICTIONARY[num];
+    }
+
+    return parseInt(match);
+}

package/src/locales/sv/index.ts

@@ -0,0 +1,45 @@
+import { includeCommonConfiguration } from "../../configurations";
+import { Chrono, Configuration, Parser, Refiner } from "../../chrono";
+import { ParsingResult, ParsingComponents, ReferenceWithTimezone } from "../../results";
+import { Component, ParsedResult, ParsingOption, ParsingReference, Meridiem, Weekday } from "../../types";
+import SlashDateFormatParser from "../../common/parsers/SlashDateFormatParser";
+import ISOFormatParser from "../../common/parsers/ISOFormatParser";
+import SVWeekdayParser from "./parsers/SVWeekdayParser";
+import SVMonthNameLittleEndianParser from "./parsers/SVMonthNameLittleEndianParser";
+import SVCasualDateParser from "./parsers/SVCasualDateParser";
+
+export { Chrono, Parser, Refiner, ParsingResult, ParsingComponents, ReferenceWithTimezone };
+export { Component, ParsedResult, ParsingOption, ParsingReference, Meridiem, Weekday };
+
+// Shortcuts
+export const casual = new Chrono(createCasualConfiguration());
+export const strict = new Chrono(createConfiguration(true));
+
+export function parse(text: string, ref?: ParsingReference | Date, option?: ParsingOption): ParsedResult[] {
+    return casual.parse(text, ref, option);
+}
+
+export function parseDate(text: string, ref?: ParsingReference | Date, option?: ParsingOption): Date {
+    return casual.parseDate(text, ref, option);
+}
+
+export function createCasualConfiguration(littleEndian = true): Configuration {
+    const option = createConfiguration(false, littleEndian);
+    option.parsers.unshift(new SVCasualDateParser());
+    return option;
+}
+
+export function createConfiguration(strictMode = true, littleEndian = true): Configuration {
+    return includeCommonConfiguration(
+        {
+            parsers: [
+                new ISOFormatParser(),
+                new SlashDateFormatParser(littleEndian),
+                new SVMonthNameLittleEndianParser(),
+                new SVWeekdayParser(),
+            ],
+            refiners: [],
+        },
+        strictMode
+    );
+}

package/src/locales/sv/parsers/SVCasualDateParser.ts

@@ -0,0 +1,114 @@
+import { ParsingContext } from "../../../chrono";
+import { ParsingComponents, ParsingResult } from "../../../results";
+import dayjs from "dayjs";
+import { AbstractParserWithWordBoundaryChecking } from "../../../common/parsers/AbstractParserWithWordBoundary";
+import { assignSimilarDate, assignTheNextDay, implySimilarTime } from "../../../utils/dayjs";
+import * as references from "../../../common/casualReferences";
+
+const PATTERN = new RegExp(
+    `(nu|idag|imorgon|övermorgon|igår|förrgår|i\\s*förrgår)` +
+        `(?:\\s*(?:på\\s*)?(morgonen?|förmiddagen?|middagen?|eftermiddagen?|kvällen?|natten?|midnatt))?` +
+        `(?=\\W|$)`,
+    "i"
+);
+
+const DATE_GROUP = 1;
+const TIME_GROUP = 2;
+
+export default class SVCasualDateParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(context: ParsingContext): RegExp {
+        return PATTERN;
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray): ParsingComponents | ParsingResult {
+        let targetDate = dayjs(context.refDate);
+        const dateKeyword = (match[DATE_GROUP] || "").toLowerCase();
+        const timeKeyword = (match[TIME_GROUP] || "").toLowerCase();
+
+        let component = context.createParsingComponents();
+        switch (dateKeyword) {
+            case "nu":
+                component = references.now(context.reference);
+                break;
+
+            case "idag":
+                component = references.today(context.reference);
+                break;
+
+            case "imorgon":
+            case "imorn":
+                assignTheNextDay(component, targetDate);
+                break;
+
+            case "igår":
+                targetDate = targetDate.add(-1, "day");
+                assignSimilarDate(component, targetDate);
+                implySimilarTime(component, targetDate);
+                break;
+
+            case "förrgår":
+            case "i förrgår":
+                targetDate = targetDate.add(-2, "day");
+                assignSimilarDate(component, targetDate);
+                implySimilarTime(component, targetDate);
+                break;
+        }
+
+        switch (timeKeyword) {
+            case "morgon":
+            case "morgonen":
+                component.imply("hour", 6);
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+
+            case "förmiddag":
+            case "förmiddagen":
+                component.imply("hour", 9);
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+
+            case "middag":
+            case "middagen":
+                component.imply("hour", 12);
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+
+            case "eftermiddag":
+            case "eftermiddagen":
+                component.imply("hour", 15);
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+
+            case "kväll":
+            case "kvällen":
+                component.imply("hour", 20);
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+
+            case "natt":
+            case "natten":
+            case "midnatt":
+                if (timeKeyword === "midnatt") {
+                    component.imply("hour", 0);
+                } else {
+                    component.imply("hour", 2);
+                }
+                component.imply("minute", 0);
+                component.imply("second", 0);
+                component.imply("millisecond", 0);
+                break;
+        }
+
+        return component;
+    }
+}

package/src/locales/sv/parsers/SVMonthNameLittleEndianParser.ts

@@ -0,0 +1,59 @@
+import { ParsingContext } from "../../../chrono";
+import { ParsingResult } from "../../../results";
+import { findYearClosestToRef } from "../../../calculation/years";
+import { MONTH_DICTIONARY } from "../constants";
+import { parseYear } from "../constants";
+import { matchAnyPattern } from "../../../utils/pattern";
+import { AbstractParserWithWordBoundaryChecking } from "../../../common/parsers/AbstractParserWithWordBoundary";
+
+const PATTERN = new RegExp(
+    "(?:den\\s*?)?" +
+        `([0-9]{1,2})` +
+        `(?:\\s*(?:till|\\-|\\–|\\s)\\s*([0-9]{1,2}))?\\s*` +
+        `(${matchAnyPattern(MONTH_DICTIONARY)})` +
+        `(?:(?:-|/|,?\\s*)([0-9]{4}(?![^\\s]\\d)))?` +
+        `(?=\\W|$)`,
+    "i"
+);
+
+const DATE_GROUP = 1;
+const DATE_TO_GROUP = 2;
+const MONTH_NAME_GROUP = 3;
+const YEAR_GROUP = 4;
+
+export default class SVMonthNameLittleEndianParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(): RegExp {
+        return PATTERN;
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray): ParsingResult {
+        const result = context.createParsingResult(match.index, match[0]);
+
+        const month = MONTH_DICTIONARY[match[MONTH_NAME_GROUP].toLowerCase()];
+        const day = parseInt(match[DATE_GROUP]);
+        if (day > 31) {
+            // e.g. "[96 Aug]" => "9[6 Aug]", we need to shift away from the next number
+            match.index = match.index + match[DATE_GROUP].length;
+            return null;
+        }
+
+        result.start.assign("month", month);
+        result.start.assign("day", day);
+
+        if (match[YEAR_GROUP]) {
+            const yearNumber = parseYear(match[YEAR_GROUP]);
+            result.start.assign("year", yearNumber);
+        } else {
+            const year = findYearClosestToRef(context.refDate, day, month);
+            result.start.imply("year", year);
+        }
+
+        if (match[DATE_TO_GROUP]) {
+            const endDate = parseInt(match[DATE_TO_GROUP]);
+            result.end = result.start.clone();
+            result.end.assign("day", endDate);
+        }
+
+        return result;
+    }
+}

package/src/locales/sv/parsers/SVWeekdayParser.ts

@@ -0,0 +1,47 @@
+import { ParsingContext } from "../../../chrono";
+import { ParsingComponents } from "../../../results";
+import { WEEKDAY_DICTIONARY } from "../constants";
+import { matchAnyPattern } from "../../../utils/pattern";
+import { AbstractParserWithWordBoundaryChecking } from "../../../common/parsers/AbstractParserWithWordBoundary";
+import { createParsingComponentsAtWeekday } from "../../../calculation/weekdays";
+
+const PATTERN = new RegExp(
+    "(?:(?:\\,|\\(|\\（)\\s*)?" +
+        "(?:på\\s*?)?" +
+        "(?:(förra|senaste|nästa|kommande)\\s*)?" +
+        `(${matchAnyPattern(WEEKDAY_DICTIONARY)})` +
+        "(?:\\s*(?:\\,|\\)|\\）))?" +
+        "(?:\\s*(förra|senaste|nästa|kommande)\\s*vecka)?" +
+        "(?=\\W|$)",
+    "i"
+);
+
+const PREFIX_GROUP = 1;
+const SUFFIX_GROUP = 3;
+const WEEKDAY_GROUP = 2;
+
+export default class SVWeekdayParser extends AbstractParserWithWordBoundaryChecking {
+    innerPattern(): RegExp {
+        return PATTERN;
+    }
+
+    innerExtract(context: ParsingContext, match: RegExpMatchArray): ParsingComponents {
+        const dayOfWeek = match[WEEKDAY_GROUP].toLowerCase();
+        const offset = WEEKDAY_DICTIONARY[dayOfWeek];
+        const prefix = match[PREFIX_GROUP];
+        const postfix = match[SUFFIX_GROUP];
+
+        let modifierWord = prefix || postfix;
+        modifierWord = modifierWord || "";
+        modifierWord = modifierWord.toLowerCase();
+
+        let modifier = null;
+        if (modifierWord.match(/förra|senaste/)) {
+            modifier = "last";
+        } else if (modifierWord.match(/nästa|kommande/)) {
+            modifier = "next";
+        }
+
+        return createParsingComponentsAtWeekday(context.reference, offset, modifier);
+    }
+}

package/src/locales/uk/parsers/UKWeekdayParser.ts

@@ -3,7 +3,7 @@ import { ParsingComponents } from "../../../results";
 // TODO: ADD REGEX_PARTS below
 import { WEEKDAY_DICTIONARY } from "../constants";
 import { matchAnyPattern } from "../../../utils/pattern";
-import { createParsingComponentsAtWeekday } from "../../../common/calculation/weekdays";
+import { createParsingComponentsAtWeekday } from "../../../calculation/weekdays";
 import { AbstractParserWithLeftRightBoundaryChecking } from "./AbstractParserWithWordBoundaryChecking";
 
 const PREFIX_GROUP = 1;

package/src/results.ts

@@ -1,24 +1,32 @@
-import { Component, ParsedComponents, ParsedResult, ParsingReference } from "./types";
+import { Component, ParsedComponents, ParsedResult, ParsingReference, TimezoneAbbrMap } from "./types";
 
 import quarterOfYear from "dayjs/plugin/quarterOfYear";
 import dayjs, { QUnitType } from "dayjs";
-import { assignSimilarDate, assignSimilarTime, implySimilarTime } from "./utils/dayjs";
+import { assignSimilarDate, assignSimilarTime, implySimilarTime } from "./utils/dates";
 import { toTimezoneOffset } from "./timezone";
+import { addDuration, Duration } from "./calculation/duration";
 dayjs.extend(quarterOfYear);
 
 export class ReferenceWithTimezone {
     readonly instant: Date;
     readonly timezoneOffset?: number | null;
 
-    constructor(input?: ParsingReference | Date) {
-        input = input ?? new Date();
+    constructor(instant?: Date, timezoneOffset?: number) {
+        this.instant = instant ?? new Date();
+        this.timezoneOffset = timezoneOffset ?? null;
+    }
+
+    static fromDate(date: Date): ReferenceWithTimezone {
+        return new ReferenceWithTimezone(date);
+    }
+
+    static fromInput(input?: ParsingReference | Date, timezoneOverrides?: TimezoneAbbrMap) {
         if (input instanceof Date) {
-            this.instant = input;
-            this.timezoneOffset = null;
-        } else {
-            this.instant = input.instant ?? new Date();
-            this.timezoneOffset = toTimezoneOffset(input.timezone, this.instant);
+            return ReferenceWithTimezone.fromDate(input);
         }
+        const instant: Date = input?.instant ?? new Date();
+        const timezoneOffset = toTimezoneOffset(input?.timezone, instant, timezoneOverrides);
+        return new ReferenceWithTimezone(instant, timezoneOffset);
     }
 
     /**
@@ -215,18 +223,12 @@ export class ParsingComponents implements ParsedComponents {
         return date;
     }
 
-    static createRelativeFromReference(
-        reference: ReferenceWithTimezone,
-        fragments: { [c in QUnitType]?: number }
-    ): ParsingComponents {
-        let date = dayjs(reference.getDateWithAdjustedTimezone());
-        for (const key in fragments) {
-            date = date.add(fragments[key as QUnitType], key as QUnitType);
-        }
+    static createRelativeFromReference(reference: ReferenceWithTimezone, duration: Duration): ParsingComponents {
+        let date = addDuration(reference.getDateWithAdjustedTimezone(), duration);
 
         const components = new ParsingComponents(reference);
         components.addTag("result/relativeDate");
-        if (fragments["hour"] || fragments["minute"] || fragments["second"]) {
+        if (duration["hour"] || duration["minute"] || duration["second"]) {
             components.addTag("result/relativeDateAndTime");
             assignSimilarTime(components, date);
             assignSimilarDate(components, date);
@@ -235,26 +237,27 @@ export class ParsingComponents implements ParsedComponents {
             implySimilarTime(components, date);
             components.imply("timezoneOffset", reference.getTimezoneOffset());
 
-            if (fragments["d"]) {
-                components.assign("day", date.date());
-                components.assign("month", date.month() + 1);
-                components.assign("year", date.year());
-            } else if (fragments["week"]) {
-                components.assign("day", date.date());
-                components.assign("month", date.month() + 1);
-                components.assign("year", date.year());
-                components.imply("weekday", date.day());
+            if (duration["day"]) {
+                components.assign("day", date.getDate());
+                components.assign("month", date.getMonth() + 1);
+                components.assign("year", date.getFullYear());
+                components.assign("weekday", date.getDay());
+            } else if (duration["week"]) {
+                components.assign("day", date.getDate());
+                components.assign("month", date.getMonth() + 1);
+                components.assign("year", date.getFullYear());
+                components.imply("weekday", date.getDay());
             } else {
-                components.imply("day", date.date());
-                if (fragments["month"]) {
-                    components.assign("month", date.month() + 1);
-                    components.assign("year", date.year());
+                components.imply("day", date.getDate());
+                if (duration["month"]) {
+                    components.assign("month", date.getMonth() + 1);
+                    components.assign("year", date.getFullYear());
                 } else {
-                    components.imply("month", date.month() + 1);
-                    if (fragments["year"]) {
-                        components.assign("year", date.year());
+                    components.imply("month", date.getMonth() + 1);
+                    if (duration["year"]) {
+                        components.assign("year", date.getFullYear());
                     } else {
-                        components.imply("year", date.year());
+                        components.imply("year", date.getFullYear());
                     }
                 }
             }

package/src/types.ts

@@ -129,6 +129,8 @@ export type Component =
     | "meridiem"
     | "timezoneOffset";
 
+export type Timeunit = "year" | "month" | "week" | "day" | "hour" | "minute" | "second" | "millisecond";
+
 export enum Meridiem {
     AM = 0,
     PM = 1,

package/src/utils/dates.ts

@@ -1,4 +1,29 @@
 import { ParsingComponents } from "../results";
+import { Meridiem } from "../types";
+
+/**
+ * Assign (force update) the parsing component to the same day as the `target`.
+ * @param component the component to be updated.
+ * @param target the target date with timezone adjusted.
+ */
+export function assignSimilarDate(component: ParsingComponents, target: Date) {
+    component.assign("day", target.getDate());
+    component.assign("month", target.getMonth() + 1);
+    component.assign("year", target.getFullYear());
+}
+
+/**
+ * Assign (force update) the parsing component to the same time as the `target`.
+ * @param component the component to be updated.
+ * @param target the target date with timezone adjusted.
+ */
+export function assignSimilarTime(component: ParsingComponents, target: Date) {
+    component.assign("hour", target.getHours());
+    component.assign("minute", target.getMinutes());
+    component.assign("second", target.getSeconds());
+    component.assign("millisecond", target.getMilliseconds());
+    component.assign("meridiem", target.getHours() < 12 ? Meridiem.AM : Meridiem.PM);
+}
 
 /**
  * Imply (weakly update) the parsing component to the same day as the `target`.
@@ -21,4 +46,5 @@ export function implySimilarTime(component: ParsingComponents, target: Date) {
     component.imply("minute", target.getMinutes());
     component.imply("second", target.getSeconds());
     component.imply("millisecond", target.getMilliseconds());
+    component.imply("meridiem", target.getHours() < 12 ? Meridiem.AM : Meridiem.PM);
 }

package/src/utils/timeunits.ts

@@ -1,8 +1,14 @@
 import { OpUnitType, QUnitType } from "dayjs";
 import { ParsingComponents } from "../results";
 
+/**
+ * @deprecated Use `calculation.duration.Duration`.
+ */
 export type TimeUnits = { [c in OpUnitType | QUnitType]?: number };
 
+/**
+ * @deprecated Use `calculation.duration.*`.
+ */
 export function reverseTimeUnits(timeUnits: TimeUnits): TimeUnits {
     const reversed = {};
     for (const key in timeUnits) {
@@ -13,6 +19,9 @@ export function reverseTimeUnits(timeUnits: TimeUnits): TimeUnits {
     return reversed as TimeUnits;
 }
 
+/**
+ * @deprecated Use `calculation.duration.*`.
+ */
 export function addImpliedTimeUnits(components: ParsingComponents, timeUnits: TimeUnits): ParsingComponents {
     const output = components.clone();