关于日期处理类的utils

最新推荐文章于 2025-08-25 14:19:05 发布

原创最新推荐文章于 2025-08-25 14:19:05 发布 · 290 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#js #javascript

本文介绍了JavaScript中用于日期处理的实用工具类，包括判断闰年、日期对象转换为指定格式字符串、日期加减计算、日期差计算等功能。提供了一系列导出函数，如isLeapYear、dateToStr、dateAdd等，方便进行日期操作。

/**
* 日期处理工具类
*/

/**
* 判断闰年
* @param date Date日期对象
* @return boolean true 或false
*/
export function isLeapYear(date) {
return (0 == date.getYear() % 4 && ((date.getYear() % 100 != 0) || (date.getYear() % 400 == 0)));
}

/**
* 日期对象转换为指定格式的字符串
* @param formatStr 日期格式,格式定义如下 yyyy-MM-dd HH:mm:ss
* @param date Date日期对象, 如果缺省，则为当前时间
*
* YYYY/yyyy/YY/yy 表示年份
* MM/M 月份
* W/w 星期
* dd/DD/d/D 日期
* hh/HH/h/H 时间
* mm/m 分钟
* ss/SS/s/S 秒
* @return string 指定格式的时间字符串
*/
export function dateToStr(date, formatStr) {
   let str = formatStr || 'yyyy-MM-dd HH:mm:ss';
   let Week = ['日', '一', '二', '三', '四', '五', '六'];
   str = str.replace(/yyyy|YYYY/, date.getFullYear().toString());
   str = str.replace(/yy|YY/, (date.getFullYear() % 100) > 9 ? (date.getFullYear() % 100).toString() : '0' + (date.getFullYear() %
       100));
   str = str.replace(/MM/, date.getMonth() >= 9 ? (date.getMonth() + 1).toString() : '0' + (date.getMonth() + 1));
   str = str.replace(/M/g, date.getMonth().toString());
   str = str.replace(/w|W/g, Week[date.getDay()]);

str = str.replace(/dd|DD/, date.getDate() > 9 ? date.getDate().toString() : '0' + date.getDate());
str = str.replace(/d|D/g, date.getDate().toString());

   str = str.replace(/hh|HH/, date.getHours() > 9 ? date.getHours().toString() : '0' + date.getHours());
   str = str.replace(/h|H/g, date.getHours().toString());
   str = str.replace(/mm/, date.getMinutes() > 9 ? date.getMinutes().toString() : '0' + date.getMinutes());
   str = str.replace(/m/g, date.getMinutes().toString());

str = str.replace(/ss|SS/, date.getSeconds() > 9 ? date.getSeconds().toString() : '0' + date.getSeconds());
str = str.replace(/s|S/g, date.getSeconds().toString());

return str;
}

/**
* 日期计算
* @param strInterval string 可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
* @param num int
* @param date Date 日期对象
* @return Date 返回日期对象
*/
export function dateAdd(strInterval, num, date) {
   date = date || new Date();
   switch (strInterval) {
       case 's':
           return new Date(date.getTime() + (1000 * num));
       case 'n':
           return new Date(date.getTime() + (60000 * num));
       case 'h':
           return new Date(date.getTime() + (3600000 * num));
       case 'd':
           return new Date(date.getTime() + (86400000 * num));
       case 'w':
           return new Date(date.getTime() + ((86400000 * 7) * num));
       case 'm':
           return new Date(date.getFullYear(), (date.getMonth()) + num, date.getDate(), date.getHours(), date.getMinutes(),
               date.getSeconds());
       case 'y':
           return new Date((date.getFullYear() + num), date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(),
               date.getSeconds());
   }
}

/**
* 日期计算
* @param strInterval string 可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
* @param num int
* @param dateStr 字符串日期
* @param format 日期格式
*/
export function dateStrAdd(strInterval, num, dateStr, format) {
   const date = strFormatToDate(format, dateStr);
   const dateAdded = dateAdd(strInterval, num, date);
   return dateToStr(dateAdded, format);
}

/**
* 比较日期差 dtEnd 格式为日期型或者有效日期格式字符串
* @param strInterval string 可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
* @param dtStart Date 可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
* @param dtEnd Date 可选值 y 年 m月 d日 w星期 ww周 h时 n分 s秒
*/
export function dateDiff(strInterval, dtStart, dtEnd) {
   switch (strInterval) {
       case 's':
           return (dtEnd.getTime() - dtStart.getTime()) / 1000;
       case 'n':
           return (dtEnd.getTime() - dtStart.getTime()) / 60000;
       case 'h':
           return (dtEnd.getTime() - dtStart.getTime()) / 3600000;
       case 'd':
           return (dtEnd.getTime() - dtStart.getTime()) / 86400000;
       case 'w':
           return (dtEnd.getTime() - dtStart.getTime()) / (86400000 * 7);
       case 'm':
           return (dtEnd.getMonth() + 1) + ((dtEnd.getFullYear() - dtStart.getFullYear()) * 12) - (dtStart.getMonth() + 1);
       case 'y':
           return dtEnd.getFullYear() - dtStart.getFullYear();
   }
}

/**
* 字符串转换为日期对象
* @param dateStr string 格式为yyyy-MM-dd HH:mm:ss，必须按年月日时分秒的顺序，中间分隔符不限制
*/
export function strToDate(dateStr) {
return strFormatToDate('yyyy-MM-dd HH:mm:ss', dateStr);
}

/**
* 把指定格式的字符串转换为日期对象yyyy-MM-dd HH:mm:ss
*
*/
export function strFormatToDate(formatStr, dateStr) {
   let year = 0;
   let start = -1;
   let len = (dateStr || '').length;
   if ((start = formatStr.indexOf('yyyy')) > -1 && start < len) {
       year = dateStr.substr(start, 4);
   }
   let month = 0;
   if ((start = formatStr.indexOf('MM')) > -1 && start < len) {
       month = parseInt(dateStr.substr(start, 2)) - 1;
   }
   let day = 0;
   if ((start = formatStr.indexOf('dd')) > -1 && start < len) {
       day = parseInt(dateStr.substr(start, 2));
   }
   let hour = 0;
   if (((start = formatStr.indexOf('HH')) > -1 || (start = formatStr.indexOf('hh')) > 1) && start < len) {
       hour = parseInt(dateStr.substr(start, 2));
   }
   let minute = 0;
   if ((start = formatStr.indexOf('mm')) > -1 && start < len) {
       minute = dateStr.substr(start, 2);
   }
   let second = 0;
   if ((start = formatStr.indexOf('ss')) > -1 && start < len) {
       second = dateStr.substr(start, 2);
   }
   return new Date(year, month, day, hour, minute, second);
}

/**
* 日期对象转换为毫秒数
*/
export function dateToLong(date) {
return date.getTime();
}

/**
* 毫秒转换为日期对象
* @param dateVal number 日期的毫秒数
*/
export function longToDate(dateVal) {
return new Date(dateVal);
}

/**
* 判断字符串是否为日期格式
* @param str string 字符串
* @param formatStr string 日期格式，如下 yyyy-MM-dd
*/
export function isDate(str, formatStr) {
   if (formatStr == null) {
       formatStr = "yyyyMMdd";
   }
   let yIndex = formatStr.indexOf("yyyy");
   if (yIndex == -1) {
       return false;
   }
   let year = str.substring(yIndex, yIndex + 4);
   let mIndex = formatStr.indexOf("MM");
   if (mIndex == -1) {
       return false;
   }
   let month = str.substring(mIndex, mIndex + 2);
   let dIndex = formatStr.indexOf("dd");
   if (dIndex == -1) {
       return false;
   }
   let day = str.substring(dIndex, dIndex + 2);
   if (!this.isNumber(year) || year > "2100" || year < "1900") {
       return false;
   }
   if (!this.isNumber(month) || month > "12" || month < "01") {
       return false;
   }
   if (day > this.getMaxDay(year, month) || day < "01") {
       return false;
   }
   return true;
}

export function getMaxDay(year, month) {
   if (month == 4 || month == 6 || month == 9 || month == 11)
       return "30";
   if (month == 2)
       if (year % 4 == 0 && year % 100 != 0 || year % 400 == 0)
           return "29";
       else
           return "28";
   return "31";
}

/**
* 变量是否为数字
*/
export function isNumber(str) {
let regExp = /^\d+$/g;
return regExp.test(str);
}

/**
* 把日期分割成数组 [年、月、日、时、分、秒]
*/
export function toArray(myDate) {
   myDate = arguments[0] || new Date();
   let myArray = Array();
   myArray[0] = myDate.getFullYear();
   myArray[1] = myDate.getMonth();
   myArray[2] = myDate.getDate();
   myArray[3] = myDate.getHours();
   myArray[4] = myDate.getMinutes();
   myArray[5] = myDate.getSeconds();
   return myArray;
}

/**
* 取得日期数据信息
* 参数 interval 表示数据类型
* y 年 M月 d日 w星期 h时 n分 s秒
*/
export function datePart(interval, myDate) {
   myDate = myDate || new Date();
   let partStr = '';
   let Week = ['日', '一', '二', '三', '四', '五', '六'];
   switch (interval) {
       case 'y':
           partStr = myDate.getFullYear().toString();
           break;
       case 'M':
           partStr = (myDate.getMonth() + 1).toString();
           break;
       case 'd':
           partStr = myDate.getDate().toString();
           break;
       case 'w':
           partStr = Week[myDate.getDay()];
           break;
       case 'h':
           partStr = myDate.getHours().toString();
           break;
       case 'm':
           partStr = myDate.getMinutes().toString();
           break;
       case 's':
           partStr = myDate.getSeconds().toString();
           break;
   }
   return partStr;
}

/**
* 取得当前日期所在月的最大天数
*/
export function maxDayOfDate(date) {
   date = date || new Date();
   date.setDate(1);
   date.setMonth(date.getMonth() + 1);
   let time = date.getTime() - 24 * 60 * 60 * 1000;
   let newDate = new Date(time);
   return newDate.getDate();
}

/**
* 取得日期数据信息
* 参数 interval 表示数据类型
*/
export function dateWeek(myDate) {
   myDate = myDate || new Date();
   let Week = ['day7', 'day1', 'day2', 'day3', 'day4', 'day5', 'day6'];
   let partStr = Week[myDate.getDay()];
   return partStr;
}

/**
* 日期加时分秒
*
export * */
export function formatDateString_yyyyMMddHHmmss(dateStr) {
   if (dateStr == null || dateStr.length < 10) {
       return dateStr;
   }
   dateStr = dateStr.substr(0, 10) + ' 00:00:00';
   return dateStr;
}

/**
* 日期去时分秒
*
* */
export function formatDateString_yyyyMMdd(dateStr) {
   if (dateStr == null || dateStr.length < 10) {
       return dateStr;
   }
   dateStr = dateStr.substr(0, 10);
   return dateStr;
}

/**
* 把Date对象的时间部分去掉
* @param {Date} date
*/
export function getDatePart(date = new Date()) {
const datestr = dateToStr(date, 'yyyy-MM-dd');
return strFormatToDate('yyyy-MM-dd', datestr);
}

/**
* 获取今年的年份
*/
export function getCurrentYear() {
   const date = dateToStr(new Date(), 'yyyy-MM-dd HH:mm:ss');
   if (date && date.length > 4) {
       return date.substr(0, 4);
   }

   return '';
}
//获取上一天日期
export function lastDay(date = new Date()){
   var year = date.getFullYear();
   var month = date.getMonth();
   var day=date.getDate()
   if(date==1){
           if(month==0||month==1||month==3||month==5||month==7||month==8||month==10||month==12){
               if(month==0){
                   year=year-1
                   month=12
                   }
           day=31
           }else if(month==4||month==6||month==9||month==11){
           day=30
           }else{
           var isLeapYear =(0 == year % 4 && ((year% 100 != 0) || (year% 400 == 0)));
           if(isLeapYear){
                       day=29
           }else{
                       day=28
           }
           }
           month=month
       }else{
           day=day-1
           month=month+1
       }
       if(month<10){month='0'+month}
       if(day<10){day="0"+day}
   return year + "-" + month+ "-" + day;
}
// 获取本周第一天日期
export function firstWeekDay(date = new Date(), fmt = 'yyyy-MM-dd') {
   let ww = ((date.getDay() != 0) ? date.getDay() : 7);
   var nd = date.valueOf() - (ww - 1) * 24 * 60 * 60 * 1000;
   return dateToStr(new Date(nd), fmt);
}

// 获取本周最后一天日期
export function lastWeekDay(date = new Date(), fmt = 'yyyy-MM-dd') {
   let ww = ((date.getDay() != 0) ? date.getDay() : 7);
   var nd = date.valueOf() + (7 - ww) * 24 * 60 * 60 * 1000;
   return dateToStr(new Date(nd), fmt);
}

// 获取上周第一天日期
export function firstOfPreWeekDay(date = new Date(), fmt = 'yyyy-MM-dd') {
   let ww = ((date.getDay() != 0) ? date.getDay() : 7);
   var nd = date.valueOf() - (ww - 1+7) * 24 * 60 * 60 * 1000;
   return dateToStr(new Date(nd), fmt);
}

// 获取上周最后一天日期
export function lastOfPreWeekDay(date = new Date(), fmt = 'yyyy-MM-dd') {
   let ww = ((date.getDay() != 0) ? date.getDay() : 7);
   var nd = date.valueOf() + (7 - ww-7) * 24 * 60 * 60 * 1000;
   return dateToStr(new Date(nd), fmt);
}

// 本月第一天
export function firstDayOfMonth(date = new Date()) {
   const dateText = dateToStr(date, 'yyyy-MM-dd HH:mm:ss');
   if (dateText && dateText.length > 10) {
       return dateText.substr(0, 8) + '01';
   }
   return dateText;
}

// 本月最后一天
export function lastDayOfMonth(date = new Date()) {
const dateText = dateToStr(date, 'yyyy-MM-dd HH:mm:ss');

   if (dateText && dateText.length > 10) {
       const y = Number.parseInt(dateText.substr(0, 4));
       const m = Number.parseInt(dateText.substr(5, 7));
       const d = this.getMaxDay(y, m);
       return dateText.substr(0, 8) + d;
   }
   return dateText;
}

//上个月的第一天
export function firstDayOfPrecMonth(date = new Date()) {
   var year = date.getFullYear();
   var month = date.getMonth();
   if (month == 0) {
       month = 12;
       year = year - 1;
   }
   if (month < 10) {
       month = "0" + month;
   }
   return year + "-" + month + "-" + "01";
}
//上个月的最后一天
export function lastDayOfPrecMonth(date = new Date()){ //2021-1-1
   var year=date.getFullYear();
   var month = date.getMonth();
   var day
   if (month == 0) {
       month = 12;
       year = year - 1;
   }
   if(month==1||month==3||month==5||month==7||month==8||month==10||month==12){
       day=31
   }else if(month==4||month==6||month==9||month==11){
       day=30
   }else{
       var isLeapYear =this.isLeapYear(date);
       if(isLeapYear){
           day=29
       }else{
           day=28
       }
   }
   if (month < 10) {
       month = "0" + month;
   }
       return year + "-" + month + "-" + day;
}
/**
* 根据日期字符串取得距离当前日期的间隔分钟
* 参数 dataStr 日期字符串   'yyyy-MM-dd HH:mm:ss'
*/
export function getTimeLong(dataStr, format = 'yyyy-MM-dd HH:mm:ss') {
   const currentTime = new Date().getTime();
   const createDate = strFormatToDate(
       format,
       dataStr
   );
   const createTime = dateToLong(createDate);
   const duringTime = Math.abs(currentTime - createTime);
   const minute = duringTime / 1000 / 60;
   return Math.ceil(minute);
}
//转换月份的形式
export function dateChange(date){
   if(date<10){
       return "0"+date
   }
}
//计算两个日期间的天数差
export function getDaysDiff(date1,date2){
   var date1Str = date1.split("-");
   var date1Obj = new Date(date1Str[0],(date1Str[1]-1),date1Str[2]);
   var date2Str = date2.split("-");
   var date2Obj = new Date(date2Str[0],(date2Str[1]-1),date2Str[2]);
   var t1 = date1Obj.getTime();
   var t2 = date2Obj.getTime();
   var datetime=1000*60*60*24;
   var minusDays = Math.floor(((t2-t1)/datetime));
   var days = Math.abs(minusDays);
   return days;
}
export default {
   isLeapYear,
   dateToStr,
   dateAdd,
   dateStrAdd,
   dateDiff,
   strToDate,
   strFormatToDate,
   dateToLong,
   longToDate,
   isDate,
   getMaxDay,
   isNumber,
   toArray,
   datePart,
   maxDayOfDate,
   dateWeek,
   formatDateString_yyyyMMdd,
   formatDateString_yyyyMMddHHmmss,
   getCurrentYear,

   lastDay,
   firstWeekDay,
   lastWeekDay,
   firstOfPreWeekDay,
   lastOfPreWeekDay,
   firstDayOfMonth,
   lastDayOfMonth,
   getDatePart,
   firstDayOfPrecMonth,
   lastDayOfPrecMonth,
   getTimeLong,
   dateChange,
   getDaysDiff
}