时间、逻辑与类型

本页收录 DateTimeBuiltins 和偏逻辑 / 类型 / 比例计算的工具函数。

日期加天

• 用法：日期加天(日期, 天数)
• 参数：日期字符串、天数
• 返回值：String

赋值 next = 日期加天("2026-04-18", 7)
发送消息("&f七天后: " + next)

日期差天数

• 用法：日期差天数(日期1, 日期2)
• 参数：两个日期字符串
• 返回值：Number

赋值 diff = 日期差天数("2026-04-01", "2026-04-18")
发送消息("&7相差天数: " + diff)

时间加秒

• 用法：时间加秒(时间戳, 秒数)
• 参数：时间戳、秒数
• 返回值：Number

赋值 expire = 时间加秒(当前时间戳(), 30)

时间加分钟

• 用法：时间加分钟(时间戳, 分钟数)
• 参数：时间戳、分钟数
• 返回值：Number

赋值 expire = 时间加分钟(当前时间戳(), 15)

时间加小时

• 用法：时间加小时(时间戳, 小时数)
• 参数：时间戳、小时数
• 返回值：Number

赋值 expire = 时间加小时(当前时间戳(), 2)

是同一天

• 用法：是同一天(日期1, 日期2)
• 参数：两个日期
• 返回值：Boolean

判断 (是同一天(当前日期(), "2026-04-18")) {
  发送消息("&a今天就是活动日")
}

是同一周

• 用法：是同一周(日期1, 日期2)
• 参数：两个日期
• 返回值：Boolean

判断 (是同一周("2026-04-14", "2026-04-18")) {
  发送消息("&a本周任务窗口内")
}

是同一月

• 用法：是同一月(日期1, 日期2)
• 参数：两个日期
• 返回值：Boolean

判断 (是同一月("2026-04-01", 当前日期())) {
  发送消息("&e仍在本月统计周期")
}

获取星期几

• 用法：获取星期几(日期)
• 参数：1 个日期
• 返回值：Number

赋值 weekDay = 获取星期几("2026-04-18")
发送消息("&f星期编号: " + weekDay)

日期转时间戳

• 用法：日期转时间戳(日期)
• 参数：日期字符串
• 返回值：Number

赋值 ts = 日期转时间戳("2026-04-18 20:00:00")

时间戳转日期

• 用法：时间戳转日期(时间戳, 格式)
• 参数：时间戳、日期格式
• 返回值：String

赋值 text = 时间戳转日期(当前时间戳(), "yyyy-MM-dd HH:mm:ss")
发送消息("&7当前时间: " + text)

获取今日开始时间

• 用法：获取今日开始时间()
• 参数：无
• 返回值：Number

赋值 start = 获取今日开始时间()

获取今日结束时间

• 用法：获取今日结束时间()
• 参数：无
• 返回值：Number

赋值 end = 获取今日结束时间()

获取本周开始时间

• 用法：获取本周开始时间()
• 参数：无
• 返回值：Number

赋值 weekStart = 获取本周开始时间()

获取本月开始时间

• 用法：获取本月开始时间()
• 参数：无
• 返回值：Number

赋值 monthStart = 获取本月开始时间()

剩余秒数到午夜

• 用法：剩余秒数到午夜()
• 参数：无
• 返回值：Number

赋值 left = 剩余秒数到午夜()
发送消息("&7距离跨天还剩: " + left + " 秒")

格式化时长

• 用法：格式化时长(秒数)
• 参数：总秒数
• 返回值：String

赋值 text = 格式化时长(3665)
发送消息("&f格式化后: " + text)

当前时间戳

• 用法：当前时间戳()
• 参数：无
• 返回值：Number

赋值 now = 当前时间戳()

当前日期

• 用法：当前日期()
• 参数：无
• 返回值：String

赋值 today = 当前日期()
发送消息("&f今天: " + today)

当前时间

• 用法：当前时间()
• 参数：无
• 返回值：String

赋值 nowText = 当前时间()
发送消息("&f现在: " + nowText)

如果否则

• 用法：如果否则(条件, 真值, 假值)
• 参数：条件、真值、假值
• 返回值：Object

赋值 color = 如果否则(获取进度() >= 100, "&a", "&7")
发送消息(color + "当前状态已刷新")

空值合并

• 用法：空值合并(值...)
• 参数：1 个或更多值
• 返回值：Object

赋值 title = 空值合并(获取手持物品名称(), 获取手持物品类型(), "未知物品")

范围检查

• 用法：范围检查(值, 最小值, 最大值)
• 参数：值、最小值、最大值
• 返回值：Boolean

判断 (范围检查(获取坐标Y(), 60, 80)) {
  发送消息("&a当前高度在目标区间")
}

转数字

• 用法：转数字(值)
• 参数：任意值
• 返回值：Number

赋值 num = 转数字("12.5")
发送消息("&f结果: " + num)

转整数

• 用法：转整数(值)
• 参数：任意值
• 返回值：Number

赋值 count = 转整数("12")
发送消息("&f整数结果: " + count)

转布尔值

• 用法：转布尔值(值)
• 参数：任意值
• 返回值：Boolean

判断 (转布尔值("true")) {
  发送消息("&a转换结果为真")
}

限制范围

• 用法：限制范围(值, 最小值, 最大值)
• 参数：值、最小值、最大值
• 返回值：Number

赋值 chance = 限制范围(85 - 获取经验等级(), 5, 80)

百分比

• 用法：百分比(值, 总值)
• 参数：当前值、总值
• 返回值：Number

赋值 percent = 百分比(获取进度(), 100)
发送消息("&b当前百分比: " + percent)

线性插值

• 用法：线性插值(起始值, 结束值, 比例)
• 参数：起始值、结束值、比例
• 返回值：Number

赋值 value = 线性插值(10, 100, 0.5)
发送消息("&f插值结果: " + value)

是否为数字

• 用法：是否为数字(值)
• 参数：任意值
• 返回值：Boolean

判断 (是否为数字("123.45")) {
  发送消息("&a这是合法数字")
}

默认值

• 用法：默认值(值, 默认)
• 参数：值、默认值
• 返回值：Object

赋值 display = 默认值(获取显示名(), 获取玩家名())

相等

• 用法：相等(值1, 值2)
• 参数：两个值
• 返回值：Boolean

判断 (相等(取全局变量("活动阶段"), "第二周")) {
  发送消息("&6当前正处于第二周")
}