金融日历

面向金融市场（美国、中国、香港）的交易日日历工具。

概述

本技能提供基于交易日感知的调度辅助功能，帮助您：

• 检查某日期是否为交易日
• 查看即将来临的交易日
• 同步最新的节假日日历数据
• 规划任务执行时间（自动跳过非交易日）

重要说明：本技能可识别交易日并计算最优运行时间，但不会执行已计划的任务。如需实际执行定时任务，请配合使用 /loop。

命令

检查交易日

/finance-cron check  [date]

检查指定市场在某日期是否为交易日。

示例：

/finance-cron check US           # 检查今日
/finance-cron check CN 2024-12-25  # 检查具体日期

显示下一个交易日

/finance-cron next  [n]

显示指定市场的接下来 N 个交易日。

示例：

/finance-cron next US 5  # 显示接下来 5 个美国交易日

同步日历

/finance-cron sync [market]

从数据源同步最新的交易日历。

示例：

/finance-cron sync    # 同步全部市场
/finance-cron sync US  # 仅同步美国市场

规划任务调度

/finance-cron add   

规划一个交易日感知型任务，并返回下次执行时间。

注意：该命令仅计算并显示任务应运行的时间，不执行任务本身。如需按计划真正执行任务，请结合 /loop 使用：

示例工作流：

# 首先，规划任务
/finance-cron add US 09:30 echo "US market opening"
# 输出：Next Run: 2024-01-15 (Mon) 09:30

# 然后，使用 /loop 实现实际调度
/loop 0 9 * * 1-5 /finance-cron check US && echo "US market opening"

列出已规划任务

/finance-cron list

列出所有已规划任务及其下次预定执行时间。

支持市场

与 /loop 的集成

如需实现任务的实际定时执行，请在 /loop 中加入交易日检查逻辑：

# 仅在美股交易日的上午 9:30 执行命令
/loop 30 9 * * 1-5 /finance-cron check US --quiet && your_command

# --quiet 参数（如已实现）将抑制输出，使调度更干净

供其他技能调用的 API

本技能还导出程序化接口：

import { isTradingDay, getNextTradingDay, getDueTasks } from 'finance-cron';

// 检查今日是否为美股交易日
const canTrade = isTradingDay('US');

// 获取下一个美股交易日
const nextDay = getNextTradingDay('US');

// 获取待执行任务列表（供外部调度器使用）
const dueTasks = getDueTasks();