传奇脚本时间日期检测变量全套使用教程
在传奇版本搭建、功能脚本编写过程中，时间日期检测是高频实用的核心功能，无论是限时福利领取、分时段地图开放、周期活动开启，都需要依靠专属时间变量与检测命令实现精准控制。本文详细整理传奇脚本中日期检测、星期检测、时分秒时段检测的全套命令用法、实战案例及常用时间变量，适配各类传奇版本脚本开发场景，新手也可…
在传奇版本搭建、功能脚本编写过程中，时间日期检测是高频实用的核心功能，无论是限时福利领取、分时段地图开放、周期活动开启，都需要依靠专属时间变量与检测命令实现精准控制。本文详细整理传奇脚本中日期检测、星期检测、时分秒时段检测的全套命令用法、实战案例及常用时间变量，适配各类传奇版本脚本开发场景，新手也可快速上手套用。
一、传奇脚本核心时间明细检测命令说明
传奇脚本内置多款专属时间检测命令，可精准定位系统日期、星期、小时、分钟，适配不同限时功能开发需求，各命令核心功能及使用规则如下：
1、CHECKCURRENTDATE：核心日期检测命令，支持等于、大于、小于指定日期判断，检测后的日期差值会存入人物变量$STR(M0)。若设定检测日期晚于服务器当前日期，$STR(M0)数值为负数，脚本编辑中按F5可实时刷新获取当前服务器日期时间。
2、DAYOFWEEK：星期检测命令，可精准匹配周一至周日，对应英文参数为MON、TUE、WED、THU、FRI、SAT、SUN，常用于每周固定周期活动设置。
3、HOUR：小时时段检测命令，支持设置区间小时数值，精准筛选指定时间段，例如HOUR 17 18代表检测17点至18点时段。
4、MIN：分钟时段检测命令，搭配小时命令使用，精准锁定分钟区间，例如MIN 00 01代表检测00分至01分区间，可实现精准分时段功能限制。
二、CHECKCURRENTDATE日期检测脚本实战案例
该命令是传奇限时活动、限期奖励领取的常用命令，支持三种日期判断逻辑，以下为可直接复制的完整实战脚本代码，适配所有主流传奇版本。
2.1 检测当天等于指定日期（限时领奖）
;==========================================
;检查当天是否等于指定日期
[@CHECKCURRENTDATE0]
#IF
CHECKCURRENTDATE = 2010-05-18
#SAY
今天是：<$DATETIME>，恭喜你现在可以领取奖品了。
#ELSESAY
今天是：<$DATETIME>，\
只有在2010年5月18号当天才可以领取奖品。
;==========================================
2.2 检测当天大于指定日期（过期判断）
;==========================================
;检查当天是否大于指定日期
[@CHECKCURRENTDATE1]
#IF
CHECKCURRENTDATE > 2010-06-18
#SAY
今天是：<$DATETIME>，恭喜你现在可以领取奖品了。
#ELSESAY
今天是：<$DATETIME>，\
距2010年6月18号领取奖品时间过去了<$STR(M0)>天。\
;==========================================
2.3 检测当天小于指定日期（倒计时判断）
;==========================================
;检查当天是否小于指定日期
[@CHECKCURRENTDATE2]
#IF
CHECKCURRENTDATE < 2010-07-18
#SAY
今天是：<$DATETIME>。
#ELSESAY
今天是：<$DATETIME>，\
距2010年7月18号领取奖品时间还剩下<$STR(M0)>天。
;==========================================
三、DAYOFWEEK星期检测脚本实战案例
利用星期检测命令可制作传奇每周固定活动，例如周末专属福利、工作日限时副本等，以下为完整全套星期判断脚本，覆盖周一至周日全部场景。
;==========================================
;功能：DAYOFWEEK 测试星期(MON\TUE\WED\THU\FRI\SAT\SUN)
;==========================================
[@MAIN]
<星期一/@星期一> <星期二/@星期二> <星期三/@星期三> <星期四/@星期四>\
<星期五/@星期五> <星期六/@星期六> <星期天/@星期天>\
[@星期六]
#IF
DAYOFWEEK SAT
#SAY
今天是星期六！
#ELSESAY
今天不是星期六！
[@星期五]
#IF
DAYOFWEEK FRI
#SAY
今天是星期五！
#ELSESAY
今天不是星期五！
[@星期四]
#IF
DAYOFWEEK THU
#SAY
今天是星期四！
#ELSESAY
今天不是星期四！
[@星期三]
#IF
DAYOFWEEK WED
#SAY
今天是星期三！
#ELSESAY
今天不是星期三！
[@星期二]
#IF
DAYOFWEEK TUE
#SAY
今天是星期二！
#ELSESAY
今天不是星期二！
[@星期一]
#IF
DAYOFWEEK MON
#SAY
今天是星期一！
#ELSESAY
今天不是星期一！
[@星期天]
#IF
DAYOFWEEK SUN
#SAY
今天是星期天！
#ELSESAY
今天不是星期天！
;==========================================
四、HOUR+MIN时分时段检测脚本案例
时段检测可精准控制传奇地图进入、活动参与、福利领取的具体时间区间，通过小时+分钟双重判断，避免时段漏洞，是定时开放地图、限时活动的核心脚本。
核心参数说明：HOUR 控制小时区间，MIN 控制分钟区间，以下为17点00分-18点01分限时进入地图的实战脚本：
;==========================================
;时间时段检测 17:00-18:01限时功能
;==========================================
#IF
HOUR 17 18
MIN 00 01
#ACT
MAP D001
#ELSEACT
MESSAGEBOX 对不起：<$USERNAME>，进入的时间为17：00-18：00之间。
;==========================================
五、传奇脚本全套时间变量汇总
除检测命令外，传奇脚本内置多款时间变量，可直接调用展示服务器时间、玩家在线状态、服务器运行数据，适配各类界面展示、数据统计功能，全套常用变量如下：
$YEAR //获取当前服务器年份
$MONTH //获取当前服务器月份
$DAY //获取当前服务器日期
$HOUR //获取当前服务器小时
$MINUTE //获取当前服务器分钟
$SECOND //获取当前服务器秒数
$MILLISECONDS //获取当前服务器毫秒数
$LOGINTIME //获取玩家本次登录时间
$LOGINLONG //获取玩家本次登录时长
$HIGHONLINEINFO //获取在线时长最长的玩家信息
$SERVERRUNTIME //获取服务器累计运行时间
$DATETIME //获取服务器完整日期时间
