Flutter TextFormField的dd/mm/yyyy格式出生日期校验及自动补斜杠
Flutter 出生日期输入框(TextFormField)实现方案
要实现「输完天自动补斜杠+dd/mm/yyyy格式校验」的需求,不需要额外引入第三方依赖,通过Flutter原生的输入格式化能力和表单校验能力就能完成,整体拆成两部分实现:
1. 自动补斜杠的交互实现
这个功能靠自定义TextInputFormatter实现,核心逻辑是在用户输入数字的过程中,自动在对应位置插入斜杠分隔符,不需要用户手动输入:
- 自动过滤所有非数字输入,用户敲键盘、粘贴内容时只会保留数字字符
- 当累计输入2位数字(也就是天的部分输完),自动在末尾插入第一个斜杠
- 累计输入4位数字(也就是天2位 + 月2位全部输完),自动在末尾插入第二个斜杠
- 总数字长度最多保留8位(对应2位天+2位月+4位年),避免输入超出日期结构范围
自定义格式化器的实现代码:
class BirthDateInputFormatter extends TextInputFormatter { @override TextEditingValue formatEditUpdate( TextEditingValue oldValue, TextEditingValue newValue) { // 仅保留输入内容中的数字,过滤斜杠、字母等其他字符 final digitsOnly = newValue.text.replaceAll(RegExp(r'[^\d]'), ''); // 超过8位数字时不允许继续输入 if (digitsOnly.length > 8) { return oldValue; } String formattedResult = ''; for (int index = 0; index < digitsOnly.length; index++) { // 先追加当前数字 formattedResult += digitsOnly[index]; // 天、月部分全部输入完成后,自动插入斜杠分隔符 if (index == 1 || index == 3) { formattedResult += '/'; } } // 自动将光标定位到文本末尾,避免输入时光标跳动 return TextEditingValue( text: formattedResult, selection: TextSelection.collapsed(offset: formattedResult.length), ); } }
把这个格式化器绑定到TextFormField上,配合数字键盘和长度限制:
TextFormField( keyboardType: TextInputType.number, // 调出数字键盘,减少不必要的输入操作 inputFormatters: [ BirthDateInputFormatter(), LengthLimitingTextInputFormatter(10), // 限制总输入长度为10,匹配xx/xx/xxxx结构 ], decoration: const InputDecoration( hintText: 'dd/mm/yyyy', ), // 后续接入校验逻辑 )
2. 输入校验逻辑实现
格式化器只能处理常规输入过程的格式转换,还需要独立的校验逻辑兜底,覆盖粘贴、系统自动填充等绕过输入格式化的场景,校验分三层:
- 格式校验:确保输入完全匹配
dd/mm/yyyy的结构,没有缺漏、字符错误 - 范围校验:确保月份在1-12的合理区间内,日期是真实存在的(避免2月30日、4月31日这类不存在的日期)
- 场景校验:确保输入的日期不晚于当前时间,符合出生日期的业务逻辑
校验逻辑的实现代码:
String? validateBirthDate(String? inputValue) { if (inputValue == null || inputValue.isEmpty) { return '请输入出生日期'; } // 第一步:正则匹配格式 final formatReg = RegExp(r'^(\d{2})/(\d{2})/(\d{4})$'); final matchResult = formatReg.firstMatch(inputValue); if (matchResult == null) { return '请按照dd/mm/yyyy格式输入'; } // 第二步:拆分各部分数值 final day = int.parse(matchResult.group(1)!); final month = int.parse(matchResult.group(2)!); final year = int.parse(matchResult.group(3)!); if (month < 1 || month > 12) { return '月份必须在1-12之间'; } // 第三步:校验日期真实存在 try { final inputDate = DateTime(year, month, day); // 兜底校验:DateTime会自动把溢出的日期进位(比如2月30日会变成3月2日),需要和用户输入的数值对比 if (inputDate.year != year || inputDate.month != month || inputDate.day != day) { return '输入的日期不存在'; } // 校验不能是未来日期 final currentTime = DateTime.now(); if (inputDate.isAfter(currentTime)) { return '出生日期不能晚于当前日期'; } } catch (e) { return '请输入合法的日期'; } return null; }
把校验函数绑定到TextFormField的validator参数上,就可以随表单提交自动触发校验了。
边界场景说明
- 输入时用户手动输入斜杠会被自动过滤,不会出现重复斜杠的问题
- 用户删除内容时,格式化器会自动重新排列剩余数字的分隔符,不会出现斜杠位置错乱
- 用户粘贴不符合格式的内容时,格式化器会自动提取其中的数字,重新拼成符合格式的日期字符串
内容的提问来源于stack exchange,提问作者Murali Krishnan
相关产品推荐
相关产品推荐

