全球经济日历（Global Economic Calendar）

概述

一份全面的经济事件日历，覆盖四大主要区域——中国（国家统计局 NBS、中国人民银行 PBoC）、美国（联邦公开市场委员会 FOMC、美国劳工统计局 BLS）、欧盟（欧洲央行 ECB、欧盟统计局 Eurostat）和日本（日本央行 BOJ、日本财务省 MoF），以及全球性事件（OPEC、G20）。包含 2026 年第三季度至第四季度共 50+ 项预排期事件，每项均标注市场影响评级、历史波动性背景及所影响的资产类别。

核心功能

1. 预置事件数据库：涵盖 50+ 项经济事件，日期基于 2026 年 Q3–Q4 的合理模拟（含 FOMC、NBS、ECB、BOJ、OPEC、CPI 发布等），并按市场影响程度进行 1–5 星评级。

2. 实时数据获取：安装后通过 akshare 实时拉取中国宏观数据（CPI、PMI、LPR、贸易差额、M2）；若不可用，则自动回退至网页源（Forex Factory、Investing.com）。

3. 市场影响分析：每项事件均标注以下信息：

   • 受影响市场（A 股、美股、大宗商品、外汇 FX、黄金、原油、加密货币 Crypto）
   • 方向性倾向（看涨 / 看跌 / 中性 / 数据依赖型）
   • 历史波动性背景（低 / 中 / 高）

4. 交互式 HTML 仪表盘：支持月视图日历，具备以下特性：

   • 按影响等级颜色编码的事件标识
   • 区域筛选开关（CN / US / EU / JP）
   • 带完整元数据的事件详情弹窗
   • “本周重点关注”板块，高亮显示最高影响事件
   • 月份间导航功能

5. CLI 命令行接口：提供丰富格式化的终端输出，支持 today、week、month、dashboard、stats、live、search 等命令。

使用方法

CLI 命令

# 查看今日事件
python econcal.py today

# 查看本周事件（仅限高影响事件）
python econcal.py week --min-impact 4

# 查看 2026 年 9 月事件（仅限中国与美国）
python econcal.py month -m 9 -r CN,US

# 为 2026 年 9 月生成 HTML 仪表盘
python econcal.py dashboard -m 9 -o dashboard.html

# 显示数据库统计信息
python econcal.py stats

# 获取实时中国宏观数据
python econcal.py live

# 搜索事件
python econcal.py search FOMC

Python API

from econ_calendar.events import EventDatabase

db = EventDatabase()

# 获取 2026 年 9 月全部事件
events = db.by_month(2026, 9)
for e in events:
    print(f"{e.date} | {'u2605'*e.impact} | {e.title}")

# 获取未来 14 天内即将发生的事件
from datetime import date
upcoming = db.upcoming(ref_date=date.today(), days=14)

from econ_calendar.dashboard import generate_dashboard

# 生成 HTML 仪表盘
path = generate_dashboard("september_2026.html", year=2026, month=9)
print(f"Dashboard: {path}")

from econ_calendar.fetcher import MacroFetcher, fetch_cn_macro

# 获取实时中国宏观数据
fetcher = MacroFetcher()
upcoming = fetcher.fetch_upcoming(days=7)
cn_data = fetch_cn_macro()

安装方式

pip install -r requirements.txt

如需启用实时数据获取，请额外安装（可选）：

pip install akshare

事件覆盖范围（2026 年 Q3–Q4）

数据来源

• 预置事件：人工整理自各国央行及统计局官方发布的日程表。
• 中国实时数据：akshare Python 库。
• 网页回退源：Forex Factory RSS、Investing.com 经济日历。
• 历史模式参考：国家统计局 NBS 月度发布日程、FOMC 会议日程、ECB / BOJ 政策会议安排。

限制说明

• 2026 年下半年预置日期基于历史发布规律推算；实际发布时间可能浮动 1–2 天。
• 通过 akshare 获取实时数据需确保该库已正确安装且运行正常。
• 网页抓取源可能受限于访问频率限制，或因 HTML 结构变更导致解析失败。
• 本工具仅作信息参考之用，不构成任何金融投资建议。