# 日期格式化和解析

其实日期格式化有很多公开的库, 比如moment, 不过那个比较全, 很多时候我们可能只想要比较轻量级一些的,可以采用下面的

# 1、基础代码

/**
 * Parse or format dates
 * @class fecha
 */
var fecha = {};
var token =
  /d{1,4}|M{1,4}|yy(?:yy)?|S{1,3}|Do|ZZ|([HhMsDm])\1?|[aA]|"[^"]*"|'[^']*'/g;
var twoDigits = "\\d\\d?";
var threeDigits = "\\d{3}";
var fourDigits = "\\d{4}";
var word = "[^\\s]+";
var literal = /\[([^]*?)\]/gm;
var noop = function () {};

function regexEscape(str) {
  return str.replace(/[|\\{()[^$+*?.-]/g, "\\$&");
}

function shorten(arr, sLen) {
  var newArr = [];
  for (var i = 0, len = arr.length; i < len; i++) {
    newArr.push(arr[i].substr(0, sLen));
  }
  return newArr;
}

function monthUpdate(arrName) {
  return function (d, v, i18n) {
    var index = i18n[arrName].indexOf(
      v.charAt(0).toUpperCase() + v.substr(1).toLowerCase(),
    );
    if (~index) {
      d.month = index;
    }
  };
}

function pad(val, len) {
  val = String(val);
  len = len || 2;
  while (val.length < len) {
    val = "0" + val;
  }
  return val;
}

var dayNames = [
  "Sunday",
  "Monday",
  "Tuesday",
  "Wednesday",
  "Thursday",
  "Friday",
  "Saturday",
];
var monthNames = [
  "January",
  "February",
  "March",
  "April",
  "May",
  "June",
  "July",
  "August",
  "September",
  "October",
  "November",
  "December",
];
var monthNamesShort = shorten(monthNames, 3);
var dayNamesShort = shorten(dayNames, 3);
fecha.i18n = {
  dayNamesShort: dayNamesShort,
  dayNames: dayNames,
  monthNamesShort: monthNamesShort,
  monthNames: monthNames,
  amPm: ["am", "pm"],
  DoFn: function DoFn(D) {
    return (
      D +
      ["th", "st", "nd", "rd"][
        D % 10 > 3 ? 0 : ((D - (D % 10) !== 10) * D) % 10
      ]
    );
  },
};

var formatFlags = {
  // 获取周几
  D: function (dateObj) {
    return dateObj.getDay();
  },
  // 获取周几 补全到2位
  DD: function (dateObj) {
    return pad(dateObj.getDay());
  },
  // 获取 1st、2nd、3rd、4th、5th、6th、7th、8th、9th
  Do: function (dateObj, i18n) {
    return i18n.DoFn(dateObj.getDate());
  },
  // 获取每月几号
  d: function (dateObj) {
    return dateObj.getDate();
  },
  // 补全每月几号
  dd: function (dateObj) {
    return pad(dateObj.getDate());
  },
  // 获取周几前三位英文
  ddd: function (dateObj, i18n) {
    return i18n.dayNamesShort[dateObj.getDay()];
  },
  // 获取周几英文
  dddd: function (dateObj, i18n) {
    return i18n.dayNames[dateObj.getDay()];
  },
  // 获取月份
  M: function (dateObj) {
    return dateObj.getMonth() + 1;
  },
  // 获取2位数月份
  MM: function (dateObj) {
    return pad(dateObj.getMonth() + 1);
  },
  // 获取月份的前三位英文
  MMM: function (dateObj, i18n) {
    return i18n.monthNamesShort[dateObj.getMonth()];
  },
  // 获取月份的英文
  MMMM: function (dateObj, i18n) {
    return i18n.monthNames[dateObj.getMonth()];
  },
  // 获取2位数的年份
  yy: function (dateObj) {
    return pad(String(dateObj.getFullYear()), 4).substr(2);
  },
  // 获取4位数的年份
  yyyy: function (dateObj) {
    return pad(dateObj.getFullYear(), 4);
  },
  // 获取12小时制
  h: function (dateObj) {
    return dateObj.getHours() % 12 || 12;
  },
  // 获取12小时制2位数
  hh: function (dateObj) {
    return pad(dateObj.getHours() % 12 || 12);
  },
  H: function (dateObj) {
    return dateObj.getHours();
  },
  HH: function (dateObj) {
    return pad(dateObj.getHours());
  },
  m: function (dateObj) {
    return dateObj.getMinutes();
  },
  mm: function (dateObj) {
    return pad(dateObj.getMinutes());
  },
  s: function (dateObj) {
    return dateObj.getSeconds();
  },
  ss: function (dateObj) {
    return pad(dateObj.getSeconds());
  },
  S: function (dateObj) {
    return Math.round(dateObj.getMilliseconds() / 100);
  },
  SS: function (dateObj) {
    return pad(Math.round(dateObj.getMilliseconds() / 10), 2);
  },
  SSS: function (dateObj) {
    return pad(dateObj.getMilliseconds(), 3);
  },
  // am pm
  a: function (dateObj, i18n) {
    return dateObj.getHours() < 12 ? i18n.amPm[0] : i18n.amPm[1];
  },
  // AM PM
  A: function (dateObj, i18n) {
    return dateObj.getHours() < 12
      ? i18n.amPm[0].toUpperCase()
      : i18n.amPm[1].toUpperCase();
  },

  ZZ: function (dateObj) {
    var o = dateObj.getTimezoneOffset();
    return (
      (o > 0 ? "-" : "+") +
      pad(Math.floor(Math.abs(o) / 60) * 100 + (Math.abs(o) % 60), 4)
    );
  },
};

var parseFlags = {
  d: [
    twoDigits,
    function (d, v) {
      d.day = v;
    },
  ],
  Do: [
    twoDigits + word,
    function (d, v) {
      d.day = parseInt(v, 10);
    },
  ],
  M: [
    twoDigits,
    function (d, v) {
      d.month = v - 1;
    },
  ],
  yy: [
    twoDigits,
    function (d, v) {
      var da = new Date(),
        cent = +("" + da.getFullYear()).substr(0, 2);
      d.year = "" + (v > 68 ? cent - 1 : cent) + v;
    },
  ],
  h: [
    twoDigits,
    function (d, v) {
      d.hour = v;
    },
  ],
  m: [
    twoDigits,
    function (d, v) {
      d.minute = v;
    },
  ],
  s: [
    twoDigits,
    function (d, v) {
      d.second = v;
    },
  ],
  yyyy: [
    fourDigits,
    function (d, v) {
      d.year = v;
    },
  ],
  S: [
    "\\d",
    function (d, v) {
      d.millisecond = v * 100;
    },
  ],
  SS: [
    "\\d{2}",
    function (d, v) {
      d.millisecond = v * 10;
    },
  ],
  SSS: [
    threeDigits,
    function (d, v) {
      d.millisecond = v;
    },
  ],
  D: [twoDigits, noop],
  ddd: [word, noop],
  MMM: [word, monthUpdate("monthNamesShort")],
  MMMM: [word, monthUpdate("monthNames")],
  a: [
    word,
    function (d, v, i18n) {
      var val = v.toLowerCase();
      if (val === i18n.amPm[0]) {
        d.isPm = false;
      } else if (val === i18n.amPm[1]) {
        d.isPm = true;
      }
    },
  ],
  ZZ: [
    "[^\\s]*?[\\+\\-]\\d\\d:?\\d\\d|[^\\s]*?Z",
    function (d, v) {
      var parts = (v + "").match(/([+-]|\d\d)/gi),
        minutes;

      if (parts) {
        minutes = +(parts[1] * 60) + parseInt(parts[2], 10);
        d.timezoneOffset = parts[0] === "+" ? minutes : -minutes;
      }
    },
  ],
};
parseFlags.dd = parseFlags.d;
parseFlags.dddd = parseFlags.ddd;
parseFlags.DD = parseFlags.D;
parseFlags.mm = parseFlags.m;
parseFlags.hh = parseFlags.H = parseFlags.HH = parseFlags.h;
parseFlags.MM = parseFlags.M;
parseFlags.ss = parseFlags.s;
parseFlags.A = parseFlags.a;

// Some common format strings
fecha.masks = {
  default: "ddd MMM dd yyyy HH:mm:ss",
  shortDate: "M/D/yy",
  mediumDate: "MMM d, yyyy",
  longDate: "MMMM d, yyyy",
  fullDate: "dddd, MMMM d, yyyy",
  shortTime: "HH:mm",
  mediumTime: "HH:mm:ss",
  longTime: "HH:mm:ss.SSS",
};

/***
 * Format a date
 * @method format
 * @param {Date|number} dateObj
 * @param {string} mask Format of the date, i.e. 'mm-dd-yy' or 'shortDate'
 */
fecha.format = function (dateObj, mask, i18nSettings) {
  var i18n = i18nSettings || fecha.i18n;

  if (typeof dateObj === "number" || typeof dateObj === "string") {
    dateObj = new Date(Number(dateObj));
  }

  if (
    Object.prototype.toString.call(dateObj) !== "[object Date]" ||
    isNaN(dateObj.getTime())
  ) {
    throw new Error("Invalid Date in fecha.format");
  }

  mask = fecha.masks[mask] || mask || fecha.masks["default"];

  var literals = [];

  // Make literals inactive by replacing them with ??
  mask = mask.replace(literal, function ($0, $1) {
    literals.push($1);
    return "@@@";
  });
  // Apply formatting rules
  mask = mask.replace(token, function ($0) {
    return $0 in formatFlags
      ? formatFlags[$0](dateObj, i18n)
      : $0.slice(1, $0.length - 1);
  });

  // Inline literal values back into the formatted value
  return mask.replace(/@@@/g, function () {
    return literals.shift();
  });
};

/**
 * Parse a date string into an object, changes - into /
 * @method parse
 * @param {string} dateStr Date string
 * @param {string} format Date parse format
 * @returns {Date|boolean}
 */
fecha.parse = function (dateStr, format, i18nSettings) {
  var i18n = i18nSettings || fecha.i18n;

  if (typeof format !== "string") {
    throw new Error("Invalid format in fecha.parse");
  }

  format = fecha.masks[format] || format;

  // Avoid regular expression denial of service, fail early for really long strings
  // https://www.owasp.org/index.php/Regular_expression_Denial_of_Service_-_ReDoS
  if (dateStr.length > 1000) {
    return null;
  }

  var dateInfo = {};
  var parseInfo = [];
  var literals = [];
  format = format.replace(literal, function ($0, $1) {
    literals.push($1);
    return "@@@";
  });
  var newFormat = regexEscape(format).replace(token, function ($0) {
    if (parseFlags[$0]) {
      var info = parseFlags[$0];
      parseInfo.push(info[1]);
      return "(" + info[0] + ")";
    }

    return $0;
  });
  newFormat = newFormat.replace(/@@@/g, function () {
    return literals.shift();
  });
  var matches = dateStr.match(new RegExp(newFormat, "i"));
  if (!matches) {
    return null;
  }

  for (var i = 1; i < matches.length; i++) {
    parseInfo[i - 1](dateInfo, matches[i], i18n);
  }

  var today = new Date();
  if (
    dateInfo.isPm === true &&
    dateInfo.hour != null &&
    +dateInfo.hour !== 12
  ) {
    dateInfo.hour = +dateInfo.hour + 12;
  } else if (dateInfo.isPm === false && +dateInfo.hour === 12) {
    dateInfo.hour = 0;
  }

  var date;
  if (dateInfo.timezoneOffset != null) {
    dateInfo.minute = +(dateInfo.minute || 0) - +dateInfo.timezoneOffset;
    date = new Date(
      Date.UTC(
        dateInfo.year || today.getFullYear(),
        dateInfo.month || 0,
        dateInfo.day || 1,
        dateInfo.hour || 0,
        dateInfo.minute || 0,
        dateInfo.second || 0,
        dateInfo.millisecond || 0,
      ),
    );
  } else {
    date = new Date(
      dateInfo.year || today.getFullYear(),
      dateInfo.month || 0,
      dateInfo.day || 1,
      dateInfo.hour || 0,
      dateInfo.minute || 0,
      dateInfo.second || 0,
      dateInfo.millisecond || 0,
    );
  }
  return date;
};

export default fecha;

# 2、用法

格式化的含义就从 formatFlags 查看注释即可

    const dateObj = new Date(2023, 11 - 1, 22, 12, 30, 31);
    console.debug(fecha.format(dateObj, 'yyyy-MM-dd')); // 2023-11-22
    console.debug(fecha.format(dateObj, 'yyyy-MM-dd HH:mm:ss')); // 2023-11-22 12:30:31
    console.debug(fecha.parse('2019=10=10', 'yyyy=MM=dd'));
	  console.debug(fecha.format(dateObj, 'yyyy')); // 2023

# 3、8位数字或者15位数字格式化

很多时候,系统设置存日期存的不是时间戳,而是一些数字,比如20250102或者20250102.152312,这时候需要稍微格式化一下

function formatDateTime(datetime) {
  if (!datetime) return '';
	datetime = String(datetime);
  if (datetime.length === 8) {
    return datetime.toString().replace(/^(\d{4})(\d{2})(\d{2})$/, '$1-$2-$3');
  }
  if (
    datetime != '' &&
    datetime != undefined &&
    datetime.toString().indexOf('.') != -1 &&
    datetime.toString() != '0.000000'
  ) {
    while (datetime.length < 15) {
      datetime += '0';
    }
    return datetime
      .toString()
      .replace(/^(\d{4})(\d{2})(\d{2}).(\d{2})(\d{2})(\d{2})$/, '$1-$2-$3 $4:$5:$6');
  } else {
    return '';
  }
}

formatDateTime('20250101'); // 返回 2025-01-01
formatDateTime('20250102.152312'); // 返回 2025-01-01 15:23:12

拷贝自fecha (opens new window)

上次更新: 11/24/2025, 8:43:18 AM