Groovy支持跨年度场景的整数月份差值计算实现方法咨询

算力阿峰

2026-10-30

纯月份整数差值计算实现方案（适配Oracle VBCS Groovy）

Groovy 本身没有针对1-12范围纯月份整数的专属内置计算函数，毕竟这种按跨年循环计算间隔的规则是自定义业务逻辑，但实现逻辑非常简洁，纯整数运算就能完成，完全可以在VBCS的Groovy沙箱环境中直接运行，没有额外依赖。

核心计算逻辑

匹配你提出的两个场景校验规则，核心计算公式为：

从起始月份向后计数，走到目标月份（若目标月份数值小于起始月份则自动按跨次年循环）的间隔数 = ((endMonth - startMonth) % 12 + 12) % 12

公式校验对照：

常规场景：startMonth=1、endMonth=3，代入计算得到结果2，与预期一致
跨期场景：startMonth=11、endMonth=1，代入计算得到结果2，与预期一致

可直接使用的代码实现

行内简化写法（适合直接嵌入VBCS逻辑流、脚本块的单次计算场景）

int startMonth = 11 // 起始月份，1对应1月，12对应12月
int endMonth = 1   // 目标月份

// 核心计算
int monthDiff = ((endMonth - startMonth) % 12 + 12) % 12

封装复用写法（适合VBCS全局工具类、多次重复调用的场景）

/**
 * 计算纯月份值的正向间隔
 * @param startMonth 起始月份，取值范围1-12
 * @param endMonth 目标月份，取值范围1-12，数值小于起始月份时自动按跨次年计算
 * @return 正向间隔数
 */
static int calculateMonthInterval(int startMonth, int endMonth) {
    // 参数合法性兜底，避免非法值导致计算异常
    if (!(startMonth in 1..12) || !(endMonth in 1..12)) {
        throw new IllegalArgumentException("月份参数必须为1-12的整数")
    }
    return ((endMonth - startMonth) % 12 + 12) % 12
}