Japan Bank Holiday and Gotobi Library MT4
- 程序库
- 版本: 1.0
Japan Bank Holiday and Gotobi Library MT4 在您自己的 EA、指标或脚本中回答日元市场的日历问题：今天是否为日本银行休息日、是否为五十日（gotobi）、下一次东京定盘价（仲值）在何时，以及按您经纪商的服务器时间，日本现在是几点。
所有规则均通过计算得出，无需更新节假日表。1980-2027 年的结果与日本内阁府公布的国民节假日列表逐日一致。不使用 DLL、不发送网络请求、不读写文件、不含任何交易函数。
可以回答的问题
- 日本国民节假日，包括调休假日（振替休日）和国民休息日（国民の休日），并给出每个节日的英文名称。
- 日本银行休息日：周六、周日、国民节假日以及 12 月 31 日至 1 月 3 日。其余日期为营业日。
- 五十日（gotobi）：每月 5、10、15、20、25 日和月末最后一天。若该日为银行休息日，则提前到前一个营业日。
- 东京定盘价（仲值）的时间：日本时间 09:55。
- 经纪商服务器时间与日本时间的相互换算。日本不实行夏令时（JST = UTC+9）。
函数
- JpIsBankHoliday(date) - 周六、周日、国民节假日及 12 月 31 日至 1 月 3 日返回 true。
- JpIsBusinessDay(date) - 东京银行营业日返回 true。
- JpIsNationalHoliday(date) - 国民节假日（含调休假日和国民休息日）返回 true。
- JpHolidayName(date) - 英文名称，例如 "Marine Day"、"Substitute Holiday" 或 "Bank Holiday"；其他日期返回空字符串。
- JpIsGotobi(date) - 五十日返回 true。
- JpGotobiDaysOfMonth(year, month, days[]) - 某个月的全部五十日；返回个数。
- JpNextGotobi(date) / JpPrevGotobi(date) - 该日期当天或之后的第一个五十日 / 当天或之前的最后一个五十日。
- JpTokyoFixing(date) - 当天日本时间 09:55。
- JpNowJst() - 当前日本时间。
- JpServerToJst(time) / JpJstToServer(time) - 服务器时间与日本时间的相互换算。
- JpServerGmtOffsetSeconds() - 服务器相对 GMT 的偏移（秒）（自动：TimeCurrent() - TimeGMT()，按 15 分钟取整）。
- JpSetServerGmtOffset(seconds) - 固定偏移，例如 GMT+2 为 7200。
- JpSetServerTimeZone(seconds, rule) - 非夏令时期间的偏移加夏令时规则：0 无，1 美国，2 欧盟。
- JpSetServerGmtOffsetAuto() - 恢复自动偏移（默认）。
- JpLibraryVersion() - 版本号 "1.00"。
日期参数使用日本时间，可以传入当天的任意时刻。节假日和五十日的日期以日本时间 00:00 返回。
使用方法
Market 会将本库安装为 MQL4\Libraries\Market\Japan Bank Holiday and Gotobi Library MT4.ex4。请把下面的导入块粘贴到您程序的开头（或保存为 MQL4\Include\JpMarketCalendar.mqh 后包含该文件）：
#import "Market\\Japan Bank Holiday and Gotobi Library MT4.ex4" string JpLibraryVersion(); bool JpIsNationalHoliday(datetime date_jst); bool JpIsBankHoliday(datetime date_jst); bool JpIsBusinessDay(datetime date_jst); string JpHolidayName(datetime date_jst); bool JpIsGotobi(datetime date_jst); int JpGotobiDaysOfMonth(int year, int month, datetime &out[]); datetime JpNextGotobi(datetime from_jst); datetime JpPrevGotobi(datetime from_jst); datetime JpTokyoFixing(datetime date_jst); int JpServerGmtOffsetSeconds(); bool JpSetServerGmtOffset(int seconds); bool JpSetServerTimeZone(int standard_offset_seconds, int dst_rule); void JpSetServerGmtOffsetAuto(); datetime JpServerToJst(datetime server_time); datetime JpJstToServer(datetime jst); datetime JpNowJst(); #import
EA 示例：
int OnInit()
{
// In the Strategy Tester TimeGMT() returns server time: set the offset yourself
if(MQLInfoInteger(MQL_TESTER))
JpSetServerTimeZone(2 * 3600, 1); // GMT+2, +1 hour in US summer time
return(INIT_SUCCEEDED);
}
void OnTick()
{
datetime jst = JpNowJst(); // Japan time now
if(JpIsGotobi(jst))
Comment("Gotobi - Tokyo fixing at ",
TimeToString(JpJstToServer(JpTokyoFixing(jst))), " server time");
else if(JpIsBankHoliday(jst))
Comment("Japanese bank holiday ", JpHolidayName(jst));
else
Comment("Next gotobi: ", TimeToString(JpNextGotobi(jst), TIME_DATE));
} 所用规则
- 日本《国民节假日法》及其修订：固定日期的节日、周一节日（成人节和体育节自 2000 年起，海之日和敬老日自 2003 年起）、自 2016 年起的山之日、按年号划分的天皇诞辰，以及 2020 年和 2021 年调整的日期。
- 调休假日：国民节日恰逢周日时，其后第一个不是国民节日的日子放假（2007 年起；此前仅限次日）。
- 国民休息日：夹在两个国民节日之间的日子（1986 年起），例如 2026 年 9 月 22 日。
- 一次性节日：1989-02-24、1990-11-12、1993-06-09、2019-05-01 和 2019-10-22。
- 春分日和秋分日：使用适用于 1980-2099 年的标准近似公式。截至 2027 年的每一年都与官方日期一致，直到 2099 年的每一年都与天文计算结果一致。日本政府在前一年 2 月公布春分日和秋分日。
- 银行休息日：周六、周日、国民节假日以及 12 月 31 日至 1 月 3 日（《银行法》；所有年份都采用现行规则）。
- 五十日：若当天为银行休息日，则提前到同月的前一个营业日。若 5 日需要提前到上个月（例如 2027 年 5 月），该营业日本身已是上个月的月末五十日，因此只在上个月列出。
须知
- 适用年份：1980-2099 年。超出此范围时，函数返回 false、0、空字符串或 -1。
- 策略测试器：在测试器中 TimeGMT() 返回服务器时间，因此自动偏移为 0。请像示例那样在 OnInit() 中调用 JpSetServerGmtOffset() 或 JpSetServerTimeZone()。若在测试器中使用自动偏移，本库会在测试器日志中输出一次提示。
- MT4 没有 TimeTradeServer()，因此自动偏移使用 TimeCurrent()，即最后一笔报价的时间。报价持续到来时它是正确的；终端刚启动时或休市期间可能不正确（超出 -12 至 +14 小时范围的值会被忽略）。在 MT4 中，用 JpSetServerTimeZone() 设置偏移更为稳妥。
- 自动偏移是当前的偏移。若要跨越夏令时切换来换算历史 K 线，请用 JpSetServerTimeZone() 设置服务器的规则。
- 设置只对调用它的程序生效：请在每个 EA 或指标的 OnInit() 中调用。
- JpGotobiDaysOfMonth() 需要动态数组：datetime days[];
- 结果按年缓存；同一年内重复调用一次约需 0.1 微秒。
技术支持
如有任何不清楚之处，请在 MQL5 上给我发私信。
