localdate.withdayofyear() 用于构造指定年份的第几天对应的日期，而非定位或搜索；它保留原实例年份，将日序设为参数值并返回新实例，要求日序在该年合法范围内（平年1–365，闰年1–366），超出则抛异常。
LocalDate.withDayOfYear() 的实际作用不是“定位某一天”，而是“构造某一天”
这个方法不会查找、搜索或解析日期，它只是把一个 LocalDate 实例的“年份”保留，再把“日序数”（1–365 或 366）设为指定值，最终返回新实例。它不关心你传入的 dayOfYear 是否“合理”——比如传 400，它会直接抛 DateTimeException；但传 366 在平年也会报错。
所以它适合的场景是：你已经知道年份和该年中的第几天，想快速得到对应日期。比如“2023 年的第 100 天是几号？”——不是去查日历，而是用代码算出来。
- 必须配合已知年份使用，单独调用
LocalDate.now().withDayOfYear(100)得到的是“今年的第 100 天”，不是“任意年的第 100 天” - dayOfYear 范围严格受限：平年是 1–365，闰年是 1–366；超出即抛
DateTimeException: Invalid value for DayOfYear - 它不处理跨年逻辑：传入 366 给 2023 年（平年）会失败，不会自动“溢出”到下一年
正确构造“某年某日序”的写法：先固定年份，再调用 withDayOfYear()
常见错误是试图从一个任意日期出发“调整”到目标日序，比如 LocalDate.of(2024, 1, 1).withDayOfYear(200) —— 这其实没问题，但容易让人误以为它在“修改”原日期。更清晰、更安全的做法是直接用 LocalDate.of(year, 1, 1) 或 LocalDate.parse("2024-01-01") 作为起点，再调用 withDayOfYear()。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
示例：求 2024 年第 200 天的日期：
LocalDate target = LocalDate.of(2024, 1, 1).withDayOfYear(200); // 结果：2024-07-18
- 不要用
LocalDate.now().withYear(2024).withDayOfYear(200)：虽然结果一样，但多一次对象创建，且语义模糊（为什么先 now 再改年？） - 如果 year 是变量，确保它合法（>= 1, LocalDate.of() 会提前抛异常
- 注意：
LocalDate.of(year, 1, 1)比LocalDate.parse(year + "-01-01")性能更好，无字符串解析开销
遇到 DateTimeException: Invalid value for DayOfYear 怎么办
这是最常踩的坑：传了非法日序值。不是所有年份都支持 366，也不是所有输入都能被静默修正。
- 检查 dayOfYear 是否在 1–366 范围内：小于 1 或大于 366 必然失败
- 检查目标年份是否为闰年：用
Year.isLeap(year)判断；若为 false 且 dayOfYear == 366，则必须拒绝或降级处理（比如改为 365） - 别依赖 try-catch 做常规流程控制：异常成本高，应前置校验
- 可封装工具方法，例如：
public static LocalDate ofYearAndDay(int year, int dayOfYear) {
if (dayOfYear (Year.isLeap(year) ? 366 : 365)) {
throw new IllegalArgumentException("Invalid dayOfYear: " + dayOfYear + " for year " + year);
}
return LocalDate.of(year, 1, 1).withDayOfYear(dayOfYear);
}
和 LocalDate.ofYearDay() 的区别：少用、慎用
LocalDate.ofYearDay(year, dayOfYear) 看起来更直白，但它和 withDayOfYear() 行为一致，且内部实现就是先调 of(year, 1, 1) 再调 withDayOfYear()。JDK 文档明确建议：优先使用 of(year, 1, 1).withDayOfYear(...) 形式，因为更清晰、更易调试、且与其它 withXXX 方法风格统一。
-
ofYearDay()是静态工厂方法，不能链式调用；而withDayOfYear()是实例方法，可与其他 withXXX（如withYear()）组合 - 某些旧项目里可能看到
ofYearDay()，但新代码没必要沿用——它没额外优势，反而容易让人忽略“year 必须合法”这一前提 - IDE 通常会对
ofYearDay()给出“deprecated in future”的提示（虽未正式弃用，但不推荐）
getDayOfYear()），也不处理时区、格式化或业务含义（比如“第 100 天是否为工作日”）。如果你需要的是“查找今年第 N 个星期五”或“跳过节假日”，withDayOfYear() 就完全不适用——那得用 TemporalAdjusters 或手动循环。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
