Function processSemanticKeyword

lib/utils/parse-date.ts:211–257

(baseTime: Dayjs, timePart: string, originalContext: string)

 * @returns The resolved Date object.
 */
const processSemanticKeyword = (baseTime: Dayjs, timePart: string, originalContext: string): Date => {
    if (!timePart) {
        return baseTime.toDate();
    }

    const isPM = REGEX_IS_PM.test(originalContext);
    const isAM = REGEX_IS_AM.test(originalContext);

    // Normalize formats like "3pm" to "3 pm" to separate digits from text
    const fixTimePart = timePart.replace(REGEX_STICKY_AMPM, '$1 $2m');

    // Attempt 1: Parse as a duration (e.g., "8点" -> 8 hours from start of day)
    const extraDuration = parseDuration(fixTimePart);
    let addedMillis = extraDuration.asMilliseconds();

    // Attempt 2: Handle cases where duration regex fails (e.g., "3 pm" doesn't match standard units)
    const stickyMatch = REGEX_STICKY_AMPM.exec(timePart);
    if (addedMillis === 0 && stickyMatch) {
        addedMillis = Number(stickyMatch[1]) * 60 * 60 * 1000;
    }

    if (addedMillis > 0) {
        const hours = dayjs.duration(addedMillis).asHours();
        // Adjust for 12-hour clock context
        if (isPM && hours < 12) {
            addedMillis += 12 * 60 * 60 * 1000;
        } else if (isAM && hours === 12) {
            addedMillis -= 12 * 60 * 60 * 1000;
        }
        return baseTime.add(addedMillis, 'ms').toDate();
    }

    // Attempt 3: Parse as a standard time string using Day.js formats
    const composedDateStr = `${baseTime.format('YYYY-MM-DD')} ${fixTimePart}`;
    const tried = dayjs(composedDateStr, ['YYYY-MM-DD HH:mm:ss', 'YYYY-MM-DD HH:mm', 'YYYY-MM-DD H:m', 'YYYY-MM-DD h:m a', 'YYYY-MM-DD h a']);

    if (tried.isValid()) {
        let result = tried;
        // Manual adjustment if the parser missed 12-hour context (e.g., "下午" stripped earlier)
        if (isPM && result.hour() < 12) {
            result = result.add(12, 'hours');
        }
        return result.toDate();
    }

    return baseTime.toDate();
};

/**
 * Parses a relative or semantic date string into a JavaScript Date object.