用途:在希伯来(犹太)历与公历之间互转日期,查询以色列节日与斋日,为以色列文件生成希伯来历+公历双日期字符串,并计算排除安息日与节日的以色列工作日。
主要能力:使用 pyluach 做日期转换(GregorianDate.to_heb、HebrewDate.to_greg,建议往返校验);用 gematria 格式化希伯来数字(15 写作 tet-vav、16 写作 tet-zayin,年份省略千位);按以色列文件惯例输出双日期;按法定休息日、纪念日、节日前夕三档区分对工作日计数的影响;查询安息日点烛与哈夫达拉时间。
使用方式:脚本 scripts/convert_date.py 支持转换、双日期格式化、列出节日、统计工作日,需 pyluach,运行 python scripts/convert_date.py --help。安息日时间不可自行计算,应查询 Hebcal 接口,如 https://www.hebcal.com/shabbat?cfg=json&geonameid=281184&M=on;常见 geonameid:耶路撒冷 281184、特拉维夫 293397、海法 294801、贝尔谢巴 295530。点烛提前量因城市而异(耶路撒冷 40 分钟、海法 30 分钟,默认 18 分钟),哈夫达拉有多种惯例,需说明所用口径。
适用场景:以色列文件日期、节日查询、工作日统计、安息日时间查询。
限制:希伯来日从日落开始,库返回的是白天日期,日落后需加一天;Yom HaZikaron、Yom HaAtzmaut、Yom HaShoah 有法定星期位移规则且各有生效年份,闰年普珥节在 Adar II;脚本不建模 Rabin Memorial Day 与 Sigd,需另行查询;节日日期使用前应用 pyluach 复核。