Java如何实现支持未知日/月/年分量的日期类型？

Java 标准库自带的LocalDate、Date等日期类均要求所有分量（年、月、日）必须为合法有效值，无法直接表达部分分量未知的场景，可通过以下两种方案实现需求：

方案1：自定义日期实体（无第三方依赖） #

直接拆分日期的三个分量为独立的包装类字段，天然支持空值标识未知状态，同时可以扩展方法适配业务规则：

• 字段定义用Integer存储年、月、日，空值代表对应分量未知
• 可增加精度标识字段，明确当前日期的有效粒度：仅年有效/年月有效/全日期有效
• 内置转换方法，可根据业务需要输出荷兰旧规则的00-00-yyyy格式编码，或是2014年后调整的虚构日期映射

代码示例：

public class PartialBirthDate {
    // 对应分量为null则表示未知
    private Integer year;
    private Integer month;
    private Integer day;

    // 基础合法性校验
    public boolean isValid() {
        if (month != null && (month < 1 || month > 12)) return false;
        // 仅存在日分量无实际业务意义，判定为不合法
        if (day != null && month == null) return false;
        if (day == null) return true;
        // 可补充对应年月的日期合法性校验逻辑，比如2月不会出现30日
        return day <= YearMonth.of(year, month).lengthOfMonth();
    }

    // 输出荷兰旧规则编码格式
    public String toDutchLegacyFormat() {
        String d = day == null ? "00" : String.format("%02d", day);
        String m = month == null ? "00" : String.format("%02d", month);
        String y = year == null ? "0000" : String.format("%04d", year);
        return String.format("%s-%s-%s", d, m, y);
    }
}

方案2：使用第三方成熟实现 #

如果不想自己维护校验逻辑，可以直接用业界成熟的工具类：

• Apache Commons Lang 3 提供了PartialDate类，原生支持单独设置年、月、日的空值状态，内置了完整的日期合法性校验
• Time4J 库提供了CalendarVariant相关实现，支持更复杂的部分日期业务场景，也可直接适配各国的特殊日期编码规则

业务适配提示 #

如果需要对接荷兰2014年后的虚构日期政策，可在上述实现中扩展映射方法：根据未知分量的位置，内置政策规定的默认虚构值，在需要输出完整日期的场景自动填充即可。

内容的提问来源于stack exchange，提问作者Ivana