chinabugotech/hutool · error · DateException

No format fit for date String [{}] !

Error message

No format fit for date String [{}] !

What it means

Error "No format fit for date String [{}] !" thrown in chinabugotech/hutool.

Source

Thrown at hutool-core/src/main/java/cn/hutool/core/date/DateUtil.java:956

			} else {
				// 格式类似:2018-09-13T05:34:31-08:00
				return new DateTime(iso8601String, DatePattern.UTC_WITH_XXX_OFFSET_FORMAT);
			}
		} else {
			if (length == DatePattern.UTC_SIMPLE_PATTERN.length() - 2) {
				// 格式类似:2018-09-13T05:34:31
				return parse(iso8601String, DatePattern.UTC_SIMPLE_FORMAT);
			} else if (length == DatePattern.UTC_SIMPLE_PATTERN.length() - 5) {
				// 格式类似:2018-09-13T05:34
				return parse(iso8601String + ":00", DatePattern.UTC_SIMPLE_FORMAT);
			} else if (StrUtil.contains(iso8601String, CharUtil.DOT)) {
				// 可能为:  2021-03-17T06:31:33.99
				iso8601String = normalizeMillSeconds(iso8601String, ".", null);
				return parse(iso8601String, DatePattern.UTC_SIMPLE_MS_FORMAT);
			}
		}
		// 没有更多匹配的时间格式
		throw new DateException("No format fit for date String [{}] !", iso8601String);
	}

	/**
	 * 解析CST时间,格式:<br>
	 * <ol>
	 * <li>EEE MMM dd HH:mm:ss z yyyy(例如:Wed Aug 01 00:00:00 CST 2012)</li>
	 * </ol>
	 *
	 * @param cstString UTC时间
	 * @return 日期对象
	 * @since 4.6.9
	 * @deprecated 理解错误,请使用{@link #parseRFC2822(CharSequence)}
	 */
	@Deprecated
	public static DateTime parseCST(CharSequence cstString) {
		return parseRFC2822(cstString);
	}

View on GitHub (pinned to 8870454b2a)

Solutions

  1. Trim the input and ensure it uses a known date format (e.g. yyyy-MM-dd).
  2. Specify the expected format explicitly via DateUtil.parse(str, format).
  3. Normalize separators and timezone info before parsing.

When it happens

Trigger: Thrown at hutool-core/src/main/java/cn/hutool/core/date/DateUtil.java:956 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/14a0b1b694cdf510. Report an issue: GitHub.