jeecgboot/JeecgBoot · error · ParseException

The 'W' option does not make sense with values larger than…

Error message

The 'W' option does not make sense with values larger than 31 (max number of days in a month)

What it means

Thrown when the 'W' (nearest weekday) modifier is used with a day-of-month value greater than 31. Since no month has more than 31 days, a value like 32W or 40W is nonsensical and rejected before the value is added to the nearestWeekdays set.

Solutions

1. Change the day-of-month value preceding 'W' to a number between 1 and 31.
2. If you meant a specific weekday, use the day-of-week field with a number 1–7 instead.
3. Sanitize any dynamic/templated cron string before passing it to CronExpression.

Example fix

// before
String cron = "0 0 0 35W * ?";  // 35 > 31
// after
String cron = "0 0 0 15W * ?";  // nearest weekday to the 15th

// Validate day-of-month 'W' value is <= 31
String domField = fields[3];
for (String token : domField.split(",")) {
    if (token.endsWith("W")) {
        int val = Integer.parseInt(token.substring(0, token.length() - 1));
        if (val > 31) throw new IllegalArgumentException("'W' value must be <= 31");
    }
}

boolean isValidWValue(String token) {
    if (!token.endsWith("W")) return true;
    try {
        int val = Integer.parseInt(token.substring(0, token.length() - 1));
        return val >= 1 && val <= 31;
    } catch (NumberFormatException e) {
        return false;
    }
}

try {
    CronExpression cron = new CronExpression(expr);
} catch (ParseException e) {
    if (e.getMessage().contains("'W' option does not make sense")) {
        // reduce the day-of-month number to <= 31
    }
    throw e;
}

When it happens

Trigger: A cron expression with a day-of-month token of the form <N>W where N > 31 — e.g., '0 0 0 32W * ?' or '0 0 0 40W * ?'.

Common situations: Typo in the day number; misunderstanding of 'W' semantics; variable interpolation that injects an out-of-range value.

Related errors

• Day of month values must be between 1 and 31
• Day-of-Week values must be between 1 and 7
• Hour values must be between 0 and 23
• 'L' option is not valid here.
• Minute and Second values must be between 0 and 59

AI-assisted analysis of jeecgboot/JeecgBoot@96fb33f5ec (2026-08-14). Data as JSON: /api/errors/02426d9c15a6c9bc. Report an issue: GitHub.

Appendix: source

Thrown at jeecg-boot/jeecg-server-cloud/jeecg-visual/jeecg-cloud-xxljob/src/main/java/com/xxl/job/admin/business/scheduler/cron/CronExpression.java:772

            if (type == DAY_OF_WEEK) {
                if(val < 1 || val > 7)
                    throw new ParseException("Day-of-Week values must be between 1 and 7", -1);
                lastDayOfWeek = true;
            } else {
                throw new ParseException("'L' option is not valid here. (pos=" + i + ")", i);
            }
            TreeSet<Integer> set = getSet(type);
            set.add(val);
            i++;
            return i;
        }

        if (c == 'W') {
            if (type != DAY_OF_MONTH) {
                throw new ParseException("'W' option is not valid here. (pos=" + i + ")", i);
            }
            if(val > 31)
                throw new ParseException("The 'W' option does not make sense with values larger than 31 (max number of days in a month)", i);
            nearestWeekdays.add(val);
            i++;
            return i;
        }

        if (c == '#') {
            if (type != DAY_OF_WEEK) {
                throw new ParseException("'#' option is not valid here. (pos=" + i + ")", i);
            }
            i++;
            try {
                nthDayOfWeek = Integer.parseInt(s.substring(i));
                if (nthDayOfWeek < 1 || nthDayOfWeek > 5) {
                    throw new Exception();
                }
            } catch (Exception e) {
                throw new ParseException(
                        "A numeric value between 1 and 5 must follow the '#' option",

View on GitHub (pinned to 96fb33f5ec)