Function nextTimeInfo

src/pkg/utils/cron.ts:151–206

(crontab: string, date = new Date())

 * - week  ：每周一次
 */
export const nextTimeInfo = (crontab: string, date = new Date()): NextTimeResult => {
  const { cronExpr, oncePos } = extractCronExpr(crontab);

  let cron: CronTime;
  try {
    // 使用标准 cron 表达式进行解析
    cron = new CronTime(cronExpr);
  } catch {
    /**
     * 不支持多个 once
     * 示例："* once once * *"
     */
    throw new Error(t("cron_invalid_expr"));
  }

  let luxonDate = (DateTime as any).fromJSDate(date) as LuxonDate;
  let format = "yyyy-MM-dd HH:mm:ss";
  let onceLabel = "";

  /**
   * 若存在 once：
   *
   * 处理思路：
   * 1. 先跳转到下一个周期的起始时间
   * 2. 再从该时间点开始计算 cron 的下一次命中
   */
  if (oncePos >= 1 && oncePos <= 5) {
    const cfg = ONCE_MAP[oncePos as keyof typeof ONCE_MAP];
    onceLabel = cfg.label;
    format = cfg.format;

    /**
     * 示例：
     * 当前时间：2026-01-02 10:23
     * once 位于 hour
     *
     * → 跳转到 11:00:00
     */
    luxonDate = luxonDate.plus({ [cfg.unit]: 1 }).startOf(cfg.unit as any);

    /**
     * 再回退 1 毫秒，
     * 以确保 getNextDateFrom 能命中
     * 「等于周期起点」的 cron 时间
     */
    luxonDate = luxonDate.minus({ milliseconds: 1 });
  }

  const next = cron.getNextDateFrom(luxonDate);

  return {
    next: next,
    format: format,
    once: onceLabel,
  };
};