如何在Java Swing应用中无需外部库实现合法的yyyy-MM-dd格式日期输入（适配java.sql.Date）

嘿，我完全懂你现在的困扰！想用纯Swing组件做符合要求的日期输入，既要自动补全格式不用手动打横杠，又要能校验出像3202-15-59这种明显离谱的无效日期，还得适配数据库要用的java.sql.Date，之前试的两种方案各自踩坑，确实头疼对吧？

核心解决思路 #

我们把MaskFormatter的格式约束能力和严格的日期合法性校验结合起来，同时适配java.sql.Date的转换需求，完美解决你遇到的所有问题。

一步步实现方案 #

1. 用MaskFormatter自动维护yyyy-MM-dd格式 #

首先用MaskFormatter来搞定格式问题——它能自动帮用户插入横杠，用户只需要输入数字就行，不用手动敲-，彻底解决你之前用DateFormatter要手动输分隔符的麻烦。

如果用代码初始化：

MaskFormatter dateMask = null;
try {
    // 定义yyyy-MM-dd的格式掩码
    dateMask = new MaskFormatter("####-##-##");
    // 可选：用下划线作为占位符，提示用户输入位置
    dateMask.setPlaceholderCharacter('_');
} catch (ParseException e) {
    e.printStackTrace();
}
// 把掩码绑定到JFormattedTextField
JFormattedTextField dateField = new JFormattedTextField(dateMask);
// 设置输入框宽度刚好适配格式
dateField.setColumns(10);

如果你用NetBeans GUI Builder可视化设计：

• 拖一个JFormattedTextField到窗体上
• 右键组件选择「Customize Code」，替换默认的formatter初始化代码为上面的MaskFormatter配置
• 调整组件宽度为合适的大小（比如10列）

2. 增加严格的日期合法性校验 #

MaskFormatter只管格式不管日期是否合法，所以我们要加一层校验逻辑，确保输入的是真实存在的日期。这里用SimpleDateFormat，必须记得打开setLenient(false)——不然它会把13月自动转成下一年的1月，完全达不到我们要的校验效果。

我们可以把校验逻辑绑定到「输入框失去焦点」或者「提交按钮点击」事件上，这里以失去焦点为例：

dateField.addFocusListener(new FocusAdapter() {
    @Override
    public void focusLost(FocusEvent e) {
        validateAndConvertDate(dateField);
    }
});

// 封装校验+转换的方法
private boolean validateAndConvertDate(JFormattedTextField field) {
    String input = field.getText().trim();
    
    // 第一步：先检查格式是否完整（避免用户只输了一半）
    if (!input.matches("\\d{4}-\\d{2}-\\d{2}")) {
        JOptionPane.showMessageDialog(field, "请输入完整的yyyy-MM-dd格式日期哦", "格式不完整", JOptionPane.ERROR_MESSAGE);
        field.requestFocus();
        // 可选：把输入框背景设为淡粉色提示错误
        field.setBackground(Color.PINK);
        return false;
    }
    
    // 第二步：严格校验日期合法性
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
    sdf.setLenient(false); // 关键！关闭宽松模式，严格校验日期
    try {
        // 先解析为java.util.Date
        java.util.Date utilDate = sdf.parse(input);
        // 转换为数据库需要的java.sql.Date（自动截断时间部分）
        java.sql.Date sqlDate = new java.sql.Date(utilDate.getTime());
        
        // 校验通过，恢复输入框背景
        field.setBackground(Color.WHITE);
        // 这里可以把sqlDate存到变量里，后续用于数据库操作
        System.out.println("校验通过的SQL日期：" + sqlDate);
        return true;
    } catch (ParseException ex) {
        JOptionPane.showMessageDialog(field, "这日期不对啊！请检查月份（1-12）和日期（对应月份的有效范围）", "日期无效", JOptionPane.ERROR_MESSAGE);
        field.requestFocus();
        field.setBackground(Color.PINK);
        return false;
    }
}

3. 优化用户体验的小技巧 #

• 限制输入内容为数字：加个DocumentFilter，让输入框只能输入数字，用户连字母、符号都输不进去，从源头减少错误：

  ((AbstractDocument) dateField.getDocument()).setDocumentFilter(new DocumentFilter() {
      @Override
      public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) throws BadLocationException {
          // 只允许插入数字字符
          if (string.matches("\\d*")) {
              super.insertString(fb, offset, string, attr);
          }
      }
  
      @Override
      public void replace(FilterBypass fb, int offset, int length, String text, AttributeSet attrs) throws BadLocationException {
          if (text.matches("\\d*")) {
              super.replace(fb, offset, length, text, attrs);
          }
      }
  });
  

• 提交表单时再次校验：如果有提交按钮，记得在按钮的点击事件里也调用validateAndConvertDate()方法，避免用户直接点提交跳过焦点校验。

最后再提一下java.sql.Date的转换 #

因为java.sql.Date是专门给数据库用的，它会自动把时间部分（时、分、秒）设为0，所以我们用new java.sql.Date(utilDate.getTime())转换是完全正确的，刚好符合数据库的日期存储需求。

内容来源于stack exchange