chinabugotech/hutool · error · IllegalArgumentException

Invalid week name: {}

Error message

Invalid week name: {}

What it means

Error "Invalid week name: {}" thrown in chinabugotech/hutool.

Source

Thrown at hutool-core/src/main/java/cn/hutool/core/date/Week.java:196

		if (StrUtil.startWithAny(name, "星期", "周")) {
			char chineseNumber = name.charAt(name.length() - 1);
			switch (chineseNumber) {
				case '一':
					return MONDAY;
				case '二':
					return TUESDAY;
				case '三':
					return WEDNESDAY;
				case '四':
					return THURSDAY;
				case '五':
					return FRIDAY;
				case '六':
					return SATURDAY;
				case '日':
					return SUNDAY;
			}
			throw new IllegalArgumentException("Invalid week name: " + name);
		}

		Week of = of(ArrayUtil.indexOfIgnoreCase(ALIASES, name) + 1);
		if (null == of) {
			of = Week.valueOf(name.toUpperCase());
		}
		return of;
	}

	/**
	 * 将 {@link DayOfWeek}星期相关值转换为Week枚举对象<br>
	 *
	 * @param dayOfWeek DayOfWeek星期值
	 * @return Week
	 * @see #SUNDAY
	 * @see #MONDAY
	 * @see #TUESDAY
	 * @see #WEDNESDAY

View on GitHub (pinned to 8870454b2a)

Solutions

1. Pass a valid week name (e.g. MONDAY..SUNDAY in English or Chinese equivalents supported by Week).
2. Use Week.of(int) with the standard ordinal instead of name lookup.

When it happens

Trigger: Thrown at hutool-core/src/main/java/cn/hutool/core/date/Week.java:196 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of chinabugotech/hutool@8870454b2a (2026-08-14). Data as JSON: /api/errors/b508f75c11bed3ff. Report an issue: GitHub.