如何将Java日期时间格式符号转换为momentjs、date-fns等JS库对应符号

一、核心符号映射规则 #

Java SimpleDateFormat/DateTimeFormatter 常用符号和前端主流日期库的对应关系如下：

• Java的yyyy（4位公历年）：对应 momentjs/dayjs 的YYYY，对应 date-fns 的yyyy
• Java的MM（2位月份，补前导零）：前端三大库通用MM
• Java的dd（2位日期，补前导零）：对应 momentjs/dayjs 的DD，对应 date-fns 的dd
• Java的HH（24小时制，补前导零）：前端三大库通用HH
• Java的hh（12小时制，补前导零）：前端三大库通用hh
• Java的mm（2位分钟，补前导零）：前端三大库通用mm
• Java的ss（2位秒，补前导零）：前端三大库通用ss
• Java的SSS（3位毫秒）：前端三大库通用SSS
• Java的E/EE/EEE（星期短缩写）：对应 momentjs/dayjs 的ddd，对应 date-fns 的EEE
• Java的EEEE（星期全称）：对应 momentjs/dayjs 的dddd，对应 date-fns 的EEEE
• Java的a（上午/下午标识）：前端三大库通用A

注意：date-fns的符号规则和momentjs存在差异，YYYY在date-fns中代表ISO周年而非公历年，使用前请确认业务场景的日期类型。

二、轻量场景手动转换实现 #

如果项目中用到的日期格式覆盖范围小，不需要处理儒略历、年周、时区标识等边缘场景，可以直接用简单的字符替换函数实现转换，以下是适配momentjs的JS示例：

function javaFormatToMoment(javaFormat) {
  // 可根据业务需要扩展映射规则
  const replaceMap = {
    'yyyy': 'YYYY',
    'dd': 'DD',
    'E': 'ddd',
    'EEEE': 'dddd',
    'a': 'A'
  };
  let formatStr = javaFormat;
  Object.entries(replaceMap).forEach(([javaKey, targetKey]) => {
    formatStr = formatStr.replaceAll(javaKey, targetKey);
  });
  return formatStr;
}

// 测试用例：输入 "yyyy-MM-dd HH:mm:ss" 输出 "YYYY-MM-DD HH:mm:ss"
console.log(javaFormatToMoment('yyyy-MM-dd HH:mm:ss'))

如果需要适配date-fns，仅需要调整替换映射表中对应的值即可，无需修改逻辑。

三、落地建议 #

• 后端返回ISO8601格式的原始日期字符串是最稳妥的方案，前端直接传入日期库做格式化即可，可避免时区转换、格式解析错误等问题
• 所有格式化逻辑建议统一放在前端视图层处理，不要修改后端返回的原始日期值，避免后续多端适配出现歧义
• 如果需要覆盖全量Java日期格式的转换场景，直接扩展上述映射表的规则即可，不需要引入额外第三方依赖。

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