Function parseRelativeDate

lib/utils/parse-date.ts:288–330

(date: string, ...options: OptionType[])

 * @returns A parsed JavaScript Date object.
 */
export const parseRelativeDate = (date: string, ...options: OptionType[]): Date => {
    if (!date) {
        return new Date();
    }

    const normalized = normalize(date);

    // Strategy 1: Immediate Time
    if (normalized === 'just now') {
        return dayjs().subtract(3, 'seconds').toDate();
    }

    // Strategy 2: Relative Duration
    const agoMatch = REGEX_AGO.exec(normalized);
    if (agoMatch) {
        const duration = parseDuration(agoMatch[1]);
        if (duration.asMilliseconds() > 0) {
            return dayjs().subtract(duration).toDate();
        }
    }

    const inMatch = REGEX_IN.exec(normalized);
    if (inMatch) {
        const duration = parseDuration(inMatch[1] || inMatch[2]);
        if (duration.asMilliseconds() > 0) {
            return dayjs().add(duration).toDate();
        }
    }

    // Strategy 3: Semantic Keywords extraction and processing
    const cleanStr = normalized.replaceAll(/\s+/g, '');
    for (const word of KEYWORDS) {
        const match = word.regExp.exec(cleanStr);
        if (match) {
            const baseTime = word.calc();
            const timePart = cleanStr.replace(word.regExp, '');
            return processSemanticKeyword(baseTime, timePart, normalized);
        }
    }

    // Strategy 4: Fallback to standard Day.js parsing
    return parseDate(date, ...options);
};