如何为JDatePickerImpl 1.3.4的JFormattedTextField设置java.util.Date

你遇到的核心问题是JDatePicker的底层模型（DateModel）是基于java.util.Calendar而非java.util.Date设计的，直接操作文本框或者只设置年月日数值都没和模型的内部状态同步，才导致了异常和显示为空的情况。下面是具体的解决步骤：

1. 理解问题本质 #

• 当你用jDatePickerImpl.getJFormattedTextField().setText(dateStart+"")时，文本框显示了字符串，但JDatePicker的模型依然持有不匹配的类型值。点击组件时，内部的DateLabelFormatter会尝试把模型中的值强制转换为Calendar，而此时值是Date类型，就抛出了ClassCastException。
• 你调用setDate(int,int,int)只设置了模型的年月日字段，但没有把完整的Calendar对象绑定到模型的value上，也没标记日期为“选中”状态，所以视图没有触发更新，导致文本框为空。

2. 正确的设置方式：将util.Date转成Calendar同步到模型 #

直接把java.util.Date转换成Calendar，然后完整同步到JDatePicker的模型中，确保内部类型一致：

// 1. 将从数据库获取的java.util.Date转换为Calendar
java.util.Date dateStart = ...;
Calendar calendar = Calendar.getInstance();
calendar.setTime(dateStart);

// 2. 同步到JDatePicker的模型
DateModel model = jDatePanelImpl.getModel();
// 设置年月日
model.setDate(
    calendar.get(Calendar.YEAR),
    calendar.get(Calendar.MONTH),
    calendar.get(Calendar.DAY_OF_MONTH)
);
// 关键：将Calendar对象设置为模型的选中值，并标记为已选中
model.setValue(calendar);
model.setSelected(true);

3. 验证DateLabelFormatter的兼容性 #

检查你的DateLabelFormatter实现，确保它只处理Calendar类型的value（这是JDatePicker的默认预期），避免类型转换错误：

public class DateLabelFormatter extends JFormattedTextField.AbstractFormatter {
    private SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyy-MM-dd");

    @Override
    public Object stringToValue(String text) throws ParseException {
        Date date = dateFormatter.parse(text);
        Calendar cal = Calendar.getInstance();
        cal.setTime(date);
        return cal; // 返回Calendar类型，符合模型预期
    }

    @Override
    public String valueToString(Object value) throws ParseException {
        if (value instanceof Calendar) { // 先判断类型，避免转换异常
            Calendar cal = (Calendar) value;
            return dateFormatter.format(cal.getTime());
        }
        return "";
    }
}

4. 为什么之前的方法无效？ #

• 直接setText：绕过了JDatePicker的模型层，导致模型值和文本框显示不一致，点击时内部类型校验失败。
• 只调用setDate(int,int,int)：仅更新了模型的年月日字段，但没有设置模型的核心value（Calendar对象），视图无法感知到日期已变更，所以显示为空。

这样操作后，既能正确显示从数据库获取的java.util.Date，点击JDatePicker组件时也不会再抛出类型转换异常了。

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