基於prototype擴充的JavaScript常用函數庫

複製代碼 代碼如下:/**
2 * 檢索數組元素（原型擴充或重載）
3 * @param {o} 被檢索的元素值
4 * @type int
5 * @returns 元素索引
6 */
7 Array.prototype.contains = function(o) {
8 var index = -1;
9 for(var i=0;i<this.length;i++){if(this[i]==o){index = i;break;}}
return index;
}

/**
* 日期格式化（原型擴充或重載）
* 格式 YYYY/yyyy/YY/yy 表示年份
* MM/M 月份
* W/w 星期
* dd/DD/d/D 日期
* hh/HH/h/H 時間
* mm/m 分鐘
* ss/SS/s/S 秒
* @param {formatStr} 格式模版
* @type string
* @returns 日期文字
*/
Date.prototype.format = function(formatStr){
var str = formatStr;
var Week = ['日','一','二','三','四','五','六'];
str=str.replace(/yyyy|YYYY/,this.getFullYear());
str=str.replace(/yy|YY/,(this.getYear() % 100)>9?(this.getYear() % 100).toString():'0' + (this.getYear() % 100));
str=str.replace(/MM/,(this.getMonth()+1)>9?(this.getMonth()+1).toString():'0' + (this.getMonth()+1));
str=str.replace(/M/g,this.getMonth());
str=str.replace(/w|W/g,Week[this.getDay()]);
str=str.replace(/dd|DD/,this.getDate()>9?this.getDate().toString():'0' + this.getDate());
str=str.replace(/d|D/g,this.getDate());
str=str.replace(/hh|HH/,this.getHours()>9?this.getHours().toString():'0' + this.getHours());
str=str.replace(/h|H/g,this.getHours());
str=str.replace(/mm/,this.getMinutes()>9?this.getMinutes().toString():'0' + this.getMinutes());
str=str.replace(/m/g,this.getMinutes());
str=str.replace(/ss|SS/,this.getSeconds()>9?this.getSeconds().toString():'0' + this.getSeconds());
str=str.replace(/s|S/g,this.getSeconds());
return str;
}

/**
* 比較日期差（原型擴充或重載）
* @param {strInterval} 日期類型：'y、m、d、h、n、s、w'
* @param {dtEnd} 格式為日期型或者 有效日期格式字串
* @type int
* @returns 比較結果
*/
Date.prototype.dateDiff = function(strInterval, dtEnd) {
var dtStart = this;
if (typeof dtEnd == 'string' ) { //如果是字串轉換為日期型
dtEnd = StringToDate(dtEnd);
}
switch (strInterval) {
case 's' :return parseInt((dtEnd - dtStart) / 1000);
case 'n' :return parseInt((dtEnd - dtStart) / 60000);
case 'h' :return parseInt((dtEnd - dtStart) / 3600000);
case 'd' :return parseInt((dtEnd - dtStart) / 86400000);
case 'w' :return parseInt((dtEnd - dtStart) / (86400000 * 7));
case 'm' :return (dtEnd.getMonth()+1)+((dtEnd.getFullYear()-dtStart.getFullYear())*12) - (dtStart.getMonth()+1);
case 'y' :return dtEnd.getFullYear() - dtStart.getFullYear();
}
}

/**
* 日期計算（原型擴充或重載）
* @param {strInterval} 日期類型：'y、m、d、h、n、s、w'
* @param {Number} 數量
* @type Date
* @returns 計算後的日期
*/
Date.prototype.dateAdd = function(strInterval, Number) {
var dtTmp = this;
switch (strInterval) {
case 's' :return new Date(Date.parse(dtTmp) + (1000 * Number));
case 'n' :return new Date(Date.parse(dtTmp) + (60000 * Number));
case 'h' :return new Date(Date.parse(dtTmp) + (3600000 * Number));
case 'd' :return new Date(Date.parse(dtTmp) + (86400000 * Number));
case 'w' :return new Date(Date.parse(dtTmp) + ((86400000 * 7) * Number));
case 'q' :return new Date(dtTmp.getFullYear(), (dtTmp.getMonth()) + Number*3, dtTmp.getDate(), dtTmp.getHours(), dtTmp.getMinutes(), dtTmp.getSeconds());
case 'm' :return new Date(dtTmp.getFullYear(), (dtTmp.getMonth()) + Number, dtTmp.getDate(), dtTmp.getHours(), dtTmp.getMinutes(), dtTmp.getSeconds());
case 'y' :return new Date((dtTmp.getFullYear() + Number), dtTmp.getMonth(), dtTmp.getDate(), dtTmp.getHours(), dtTmp.getMinutes(), dtTmp.getSeconds());
}
}

/**
* 取得日期資料資訊（原型擴充或重載）
* @param {interval} 日期類型：'y、m、d、h、n、s、w'
* @type int
* @returns 指定的日期部分
*/
Date.prototype.datePart = function(interval){
var myDate = this;
var partStr='';
var Week = ['日','一','二','三','四','五','六'];
switch (interval)
{
case 'y' :partStr = myDate.getFullYear();break;
case 'm' :partStr = myDate.getMonth()+1;break;
case 'd' :partStr = myDate.getDate();break;
case 'w' :partStr = Week[myDate.getDay()];break;
case 'ww' :partStr = myDate.WeekNumOfYear();break;
case 'h' :partStr = myDate.getHours();break;
case 'n' :partStr = myDate.getMinutes();break;
case 's' :partStr = myDate.getSeconds();break;
}
return partStr;
}

/**
* 把日期分割成數組（原型擴充或重載）
* @type array
* @returns 日期數組
*/
Date.prototype.toArray = function() {
var myDate = this;
var myArray = Array();
myArray[0] = myDate.getFullYear();
myArray[1] = myDate.getMonth()+1;
myArray[2] = myDate.getDate();
myArray[3] = myDate.getHours();
myArray[4] = myDate.getMinutes();
myArray[5] = myDate.getSeconds();
return myArray;
}

/**
* 取得當前月份的天數（原型擴充或重載）
* @type int
* @returns 天數
*/
Date.prototype.daysOfMonth = function(){
var myDate = this;
var ary = myDate.toArray();
var date1 = (new Date(ary[0],ary[1]+1,1));
var date2 = date1.dateAdd('m',1);
var result = daysDiff(date1.format('yyyy-MM-dd'),date2.format('yyyy-MM-dd'));
return result;
}

/**
* 判斷閏年（原型擴充或重載）
* @type boolean
* @returns 是否為閏年 true/false
*/
Date.prototype.isLeapYear = function() {
return (0==this.getYear()%4&&((this.getYear()%100!=0)||(this.getYear()%400==0)));
}

/**
* 比較兩個日期的天數差（自訂）
* @param {DateOne} 日期一
* @param {DateOne} 日期二
* @type int
* @returns 比較結果
*/
function daysDiff(DateOne,DateTwo)
{
var OneMonth = DateOne.substring(5,DateOne.lastIndexOf ('-'));
var OneDay = DateOne.substring(DateOne.length,DateOne.lastIndexOf ('-')+1);
var OneYear = DateOne.substring(0,DateOne.indexOf ('-'));

var TwoMonth = DateTwo.substring(5,DateTwo.lastIndexOf ('-'));
var TwoDay = DateTwo.substring(DateTwo.length,DateTwo.lastIndexOf ('-')+1);
var TwoYear = DateTwo.substring(0,DateTwo.indexOf ('-'));

var cha=((Date.parse(OneMonth+'/'+OneDay+'/'+OneYear)- Date.parse(TwoMonth+'/'+TwoDay+'/'+TwoYear))/86400000);
return Math.abs(cha);
}

/**
* 日期計算（自訂）
* @param {strInterval} 日期類型：'y、m、d、h、n、s、w'
* @param {Number} 數量
* @param {prmDate} 原日期
* @type Date
* @returns 計算後的日期
*/
function dateAdd(interval,number,prmDate){
number = parseInt(number);
if (typeof(prmDate)=="string"){
prmDate = prmDate.split(/\D/);
--prmDate[1];
eval("var prmDate = new Date("+prmDate.join(",")+")");
}
if (typeof(prmDate)=="object"){
var prmDate = prmDate
}
switch(interval){
case "y": prmDate.setFullYear(prmDate.getFullYear()+number); break;
case "m": prmDate.setMonth(prmDate.getMonth()+number); break;
case "d": prmDate.setDate(prmDate.getDate()+number); break;
case "w": prmDate.setDate(prmDate.getDate()+7*number); break;
case "h": prmDate.setHours(prmDate.getHour()+number); break;
case "n": prmDate.setMinutes(prmDate.getMinutes()+number); break;
case "s": prmDate.setSeconds(prmDate.getSeconds()+number); break;
case "l": prmDate.setMilliseconds(prmDate.getMilliseconds()+number); break;
}
return prmDate;
}

/**
* 擷取字串長度（原型擴充或重載）
* @type int
* @returns 字串長度
*/
String.prototype.len = function() {
var arr=this.match(/[^\x00-\xff]/ig);
return this.length+(arr==null?0:arr.length);
}

/**
* 字串左取指定個數的字元（原型擴充或重載）
* @param {num} 擷取個數
* @type string
* @returns 匹配的字串
*/
String.prototype.left = function(num,mode) {
if(!/\d+/.test(num)) return(this);
var str = this.substr(0,num);
if(!mode) return str;
var n = str.len() - str.length;
num = num - parseInt(n/2);
return this.substr(0,num);
}

/**
* 字串右取指定個數的字元（原型擴充或重載）
* @param {num} 擷取個數
* @type string
* @returns 匹配的字串
*/
String.prototype.right = function(num,mode) {
if(!/\d+/.test(num)) return(this);
var str = this.substr(this.length-num);
if(!mode) return str;
var n = str.len() - str.length;
num = num - parseInt(n/2);
return this.substr(this.length-num);
}

/**
* 字串包含（原型擴充或重載）
* @param {string: str} 要搜尋的子字串
* @param {bool: mode} 是否忽略大小寫
* @type int
* @returns 匹配的個數
*/
String.prototype.matchCount = function(str,mode) {
return eval("this.match(/("+str+")/g"+(mode?"i":"")+").length");
}

/**
* 去除左右空格（原型擴充或重載）
* @type string
* @returns 處理後的字串
*/
String.prototype.trim = function() {
return this.replace(/(^\s*)|(\s*$)/g,"");
}

/**
* 去除左空格（原型擴充或重載）
* @type string
* @returns 處理後的字串
*/
String.prototype.lTrim = function() {
return this.replace(/(^\s*)/g, "");
}

/**
* 去除右空格（原型擴充或重載）
* @type string
* @returns 處理後的字串
*/
String.prototype.rTrim = function() {
return this.replace(/(\s*$)/g, "");
}

/**
* 字串轉換為日期型（原型擴充或重載）
* @type Date
* @returns 日期
*/
String.prototype.toDate = function() {
var converted = Date.parse(this);
var myDate = new Date(converted);
if (isNaN(myDate)) {var arys= this.split('-'); myDate = new Date(arys[0],--arys[1],arys[2]); }
return myDate;
}