分享自己寫的JS版日期格式化和解析工具類,絕對好用!


前言

本來想模仿Java里面的SimpleDateFormat()對象的,但是感覺這樣用起來不方便,所以還是直接寫成單獨的方法算了。

原文鏈接

日期格式化

使用說明

formatDate(date, fmt),其中fmt支持的格式有:

  • y(年)
  • M(月)
  • d(日)
  • q(季度)
  • w(星期)
  • H(24小時制的小時)
  • h(12小時制的小時)
  • m(分鍾)
  • s(秒)
  • S(毫秒)

另外,字符的個數決定輸出字符的長度,如,yy輸出16,yyyy輸出2016,ww輸出周五,www輸出星期五,等等。

代碼

完整代碼一共30行:

/**
 * 將日期格式化成指定格式的字符串
 * @param date 要格式化的日期,不傳時默認當前時間,也可以是一個時間戳
 * @param fmt 目標字符串格式,支持的字符有:y,M,d,q,w,H,h,m,S,默認:yyyy-MM-dd HH:mm:ss
 * @returns 返回格式化后的日期字符串
 */
function formatDate(date, fmt)
{
	date = date == undefined ? new Date() : date;
	date = typeof date == 'number' ? new Date(date) : date;
	fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
	var obj =
	{
		'y': date.getFullYear(), // 年份,注意必須用getFullYear
		'M': date.getMonth() + 1, // 月份,注意是從0-11
		'd': date.getDate(), // 日期
		'q': Math.floor((date.getMonth() + 3) / 3), // 季度
		'w': date.getDay(), // 星期,注意是0-6
		'H': date.getHours(), // 24小時制
		'h': date.getHours() % 12 == 0 ? 12 : date.getHours() % 12, // 12小時制
		'm': date.getMinutes(), // 分鍾
		's': date.getSeconds(), // 秒
		'S': date.getMilliseconds() // 毫秒
	};
	var week = ['天', '一', '二', '三', '四', '五', '六'];
	for(var i in obj)
	{
		fmt = fmt.replace(new RegExp(i+'+', 'g'), function(m)
		{
			var val = obj[i] + '';
			if(i == 'w') return (m.length > 2 ? '星期' : '周') + week[val];
			for(var j = 0, len = val.length; j < m.length - len; j++) val = '0' + val;
			return m.length == 1 ? val : val.substring(val.length - m.length);
		});
	}
	return fmt;
}

使用示例

formatDate(); // 2016-09-02 13:17:13
formatDate(new Date(), 'yyyy-MM-dd'); // 2016-09-02
// 2016-09-02 第3季度 星期五 13:19:15:792
formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS');
formatDate(1472793615764); // 2016-09-02 13:20:15

日期解析

說明

parseDate(str, fmt),其中fmt支持的格式有:

  • y(年)
  • M(月)
  • d(日)
  • H(24小時制的小時)
  • h(12小時制的小時)
  • m(分鍾)
  • s(秒)
  • S(毫秒)

完整代碼

完整代碼共17行:

/**
 * 將字符串解析成日期
 * @param str 輸入的日期字符串,如'2014-09-13'
 * @param fmt 字符串格式,默認'yyyy-MM-dd',支持如下:y、M、d、H、m、s、S,不支持w和q
 * @returns 解析后的Date類型日期
 */
function parseDate(str, fmt)
{
	fmt = fmt || 'yyyy-MM-dd';
	var obj = {y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0};
	fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function(m, $1, $2, $3, $4, idx, old)
	{
		str = str.replace(new RegExp($1+'(\\d{'+$2.length+'})'+$4), function(_m, _$1)
		{
			obj[$3] = parseInt(_$1);
			return '';
		});
		return '';
	});
	obj.M--; // 月份是從0開始的,所以要減去1
	var date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
	if(obj.S !== 0) date.setMilliseconds(obj.S); // 如果設置了毫秒
	return date;
}

示例代碼

parseDate('2016-08-11'); // Thu Aug 11 2016 00:00:00 GMT+0800
parseDate('2016-08-11 13:28:43', 'yyyy-MM-dd HH:mm:ss') // Thu Aug 11 2016 13:28:43 GMT+0800

其它日期相關方法

其它自己還簡單封裝了幾個方法,這里干脆一起貼出來了,包括上面的:

/**
 * =====================================
 *               日期相關方法
 * =====================================
 */
;(function($)
{
	$.extend(
	{
		/**
		 * 將日期格式化成指定格式的字符串
		 * @param date 要格式化的日期,不傳時默認當前時間,也可以是一個時間戳
		 * @param fmt 目標字符串格式,支持的字符有:y,M,d,q,w,H,h,m,S,默認:yyyy-MM-dd HH:mm:ss
		 * @returns 返回格式化后的日期字符串
		 */
		formatDate: function(date, fmt)
		{
			date = date == undefined ? new Date() : date;
			date = typeof date == 'number' ? new Date(date) : date;
			fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
			var obj =
			{
				'y': date.getFullYear(), // 年份,注意必須用getFullYear
				'M': date.getMonth() + 1, // 月份,注意是從0-11
				'd': date.getDate(), // 日期
				'q': Math.floor((date.getMonth() + 3) / 3), // 季度
				'w': date.getDay(), // 星期,注意是0-6
				'H': date.getHours(), // 24小時制
				'h': date.getHours() % 12 == 0 ? 12 : date.getHours() % 12, // 12小時制
				'm': date.getMinutes(), // 分鍾
				's': date.getSeconds(), // 秒
				'S': date.getMilliseconds() // 毫秒
			};
			var week = ['天', '一', '二', '三', '四', '五', '六'];
			for(var i in obj)
			{
				fmt = fmt.replace(new RegExp(i+'+', 'g'), function(m)
				{
					var val = obj[i] + '';
					if(i == 'w') return (m.length > 2 ? '星期' : '周') + week[val];
					for(var j = 0, len = val.length; j < m.length - len; j++) val = '0' + val;
					return m.length == 1 ? val : val.substring(val.length - m.length);
				});
			}
			return fmt;
		},
		/**
		 * 將字符串解析成日期
		 * @param str 輸入的日期字符串,如'2014-09-13'
		 * @param fmt 字符串格式,默認'yyyy-MM-dd',支持如下:y、M、d、H、m、s、S,不支持w和q
		 * @returns 解析后的Date類型日期
		 */
		parseDate: function(str, fmt)
		{
			fmt = fmt || 'yyyy-MM-dd';
			var obj = {y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0};
			fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function(m, $1, $2, $3, $4, idx, old)
			{
				str = str.replace(new RegExp($1+'(\\d{'+$2.length+'})'+$4), function(_m, _$1)
				{
					obj[$3] = parseInt(_$1);
					return '';
				});
				return '';
			});
			obj.M--; // 月份是從0開始的,所以要減去1
			var date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
			if(obj.S !== 0) date.setMilliseconds(obj.S); // 如果設置了毫秒
			return date;
		},
		/**
		 * 將一個日期格式化成友好格式,比如,1分鍾以內的返回“剛剛”,
		 * 當天的返回時分,當年的返回月日,否則,返回年月日
		 * @param {Object} date
		 */
		formatDateToFriendly: function(date)
		{
			date = date || new Date();
			date = typeof date === 'number' ? new Date(date) : date;
			var now = new Date();
			if((now.getTime() - date.getTime()) < 60*1000) return '剛剛'; // 1分鍾以內視作“剛剛”
			var temp = this.formatDate(date, 'yyyy年M月d');
			if(temp == this.formatDate(now, 'yyyy年M月d')) return this.formatDate(date, 'HH:mm');
			if(date.getFullYear() == now.getFullYear()) return this.formatDate(date, 'M月d日');
			return temp;
		},
		/**
		 * 將一段時長轉換成友好格式,如:
		 * 147->“2分27秒”
		 * 1581->“26分21秒”
		 * 15818->“4小時24分”
		 * @param {Object} second
		 */
		formatDurationToFriendly: function(second)
		{
			if(second < 60) return second + '秒';
			else if(second < 60*60) return (second-second%60)/60+'分'+second%60+'秒';
			else if(second < 60*60*24) return (second-second%3600)/60/60+'小時'+Math.round(second%3600/60)+'分';
			return (second/60/60/24).toFixed(1)+'天';
		},
		/** 
		 * 將時間轉換成MM:SS形式 
		 */
		formatTimeToFriendly: function(second)
		{
			var m = Math.floor(second / 60);
			m = m < 10 ? ( '0' + m ) : m;
			var s = second % 60;
			s = s < 10 ? ( '0' + s ) : s;
			return m + ':' + s;
		},
		/**
		 * 判斷某一年是否是閏年
		 * @param year 可以是一個date類型,也可以是一個int類型的年份,不傳默認當前時間
		 */
		isLeapYear: function(year)
		{
			if(year === undefined) year = new Date();
			if(year instanceof Date) year = year.getFullYear();
			return (year % 4 == 0 && year % 100 != 0) || (year % 400 == 0);
		},
		/**
		 * 獲取某一年某一月的總天數,沒有任何參數時獲取當前月份的
		 * 方式一:$.getMonthDays();
		 * 方式二:$.getMonthDays(new Date());
		 * 方式三:$.getMonthDays(2013, 12);
		 */
		getMonthDays: function(date, month)
		{
			var y, m;
			if(date == undefined) date = new Date();
			if(date instanceof Date)
			{
				y = date.getFullYear();
				m = date.getMonth();
			}
			else if(typeof date == 'number')
			{
				y = date;
				m = month-1;
			}
			var days = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; // 非閏年的一年中每個月份的天數
			//如果是閏年並且是2月
			if(m == 1 && this.isLeapYear(y)) return days[m]+1;
			return days[m];
		},
		/**
		 * 計算2日期之間的天數,用的是比較毫秒數的方法
		 * 傳進來的日期要么是Date類型,要么是yyyy-MM-dd格式的字符串日期
		 * @param date1 日期一
		 * @param date2 日期二
		 */
		countDays: function(date1, date2)
		{
			var fmt = 'yyyy-MM-dd';
			// 將日期轉換成字符串,轉換的目的是去除“時、分、秒”
			if(date1 instanceof Date && date2 instanceof Date)
			{
				date1 = this.format(fmt, date1);
				date2 = this.format(fmt, date2);
			}
			if(typeof date1 === 'string' && typeof date2 === 'string')
			{
				date1 = this.parse(date1, fmt);
				date2 = this.parse(date2, fmt);
				return (date1.getTime() - date2.getTime()) / (1000*60*60*24);
			}
			else
			{
				console.error('參數格式無效!');
				return 0;
			}
		}
	});
})(jQuery);


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM