DIV CSS 佈局教程網

JS 取得當前日期時間與格式化:Date 物件完整整理
編輯:關於JavaScript     

日期處理是 JS 裡最容易出錯的環節之一:月份從 0 開始、年份有兩位數與四位數之別、格式化全靠手動補零。這篇把常用的取用方法與可重複使用的格式化工具一次整理好。

一、Date 的基本取用方法

 var myDate = new Date();

myDate.getYear();            //年份(兩位)
myDate.getFullYear();        //完整年份(四位,建議使用)
myDate.getMonth();           //月份(0-11,0 代表一月)
myDate.getDate();            //日(1-31)
myDate.getDay();             //星期(0-6,0 代表週日)
myDate.getTime();            //自 1970.1.1 起的毫秒數
myDate.getHours();           //小時(0-23)
myDate.getMinutes();         //分(0-59)
myDate.getSeconds();         //秒(0-59)
myDate.getMilliseconds();    //毫秒(0-999)

myDate.toLocaleDateString(); //目前日期
myDate.toLocaleTimeString(); //目前時間
myDate.toLocaleString();     //日期與時間

兩個最常見的失誤:getMonth() 要加 1 才是人類認知的月份;getYear() 在部分實作會回傳 1900 基準的兩位數,請一律改用 getFullYear()。

二、可重複使用的日期工具庫

以下方法掛在 Date.prototype 上,形成一套小型工具集:

  • isLeapYear 判斷閏年
  • Format 日期格式化
  • DateAdd 日期加減
  • DateDiff 比較日期差
  • toString 轉字串
  • toArray 分割為陣列
  • DatePart 取部分資訊
  • MaxDayOfDate 取該月最大天數
  • WeekNumOfYear 一年中的第幾週
  • StringToDate 字串轉日期
  • IsValidDate / CheckDateTime 驗證有效性
  • daysBetween 相差天數
 // ---------- 判斷閏年 ----------
Date.prototype.isLeapYear = function() {
  return (0 == this.getYear() % 4 && ((this.getYear() % 100 != 0) || (this.getYear() % 400 == 0)));
};

// ---------- 日期格式化 ----------
// 格式:YYYY/yyyy/YY/yy 年份、MM/M 月份、W/w 星期
//     dd/DD/d/D 日期、hh/HH/h/H 時間、mm/m 分鐘、ss/SS/s/S 秒
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() > 9 ? this.getMonth().toString() : '0' + this.getMonth());
  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;
};

// ---------- 兩個日期相差的天數(YYYY-MM-dd) ----------
function daysBetween(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);
}

// ---------- 日期計算 ----------
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());
  }
};

// ---------- 比較日期差 ----------
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();
  }
};

// ---------- 日期輸出字串(重載 toString) ----------
Date.prototype.toString = function(showWeek) {
  var myDate = this;
  var str = myDate.toLocaleDateString();
  if (showWeek) {
   var Week = ['日','一','二','三','四','五','六'];
   str += ' 星期' + Week[myDate.getDay()];
  }
  return str;
};

// ---------- 日期合法性驗證(YYYY-MM-DD 或 YYYY/MM/DD) ----------
function IsValidDate(DateStr) {
  var sDate = DateStr.replace(/(^\s+|\s+$)/g, '');   //去兩端空白
  if (sDate == '') return true;

  //符合 YYYY-M-D 等格式者,替換後應為空字串
  var s = sDate.replace(/[\d]{4,4}[\-/]{1}[\d]{1,2}[\-/]{1}[\d]{1,2}/g, '');
  if (s == '') {
   var t = new Date(sDate.replace(/\-/g, '/'));
   var ar = sDate.split(/[-/:]/);
   if (ar[0] != t.getYear() || ar[1] != t.getMonth() + 1 || ar[2] != t.getDate()) {
    return false;
   }
  } else {
   return false;
  }
  return true;
}

// ---------- 日期時間檢查(YYYY-MM-DD HH:MM:SS) ----------
function CheckDateTime(str) {
  var reg = /^(\d+)-(\d{1,2})-(\d{1,2}) (\d{1,2}):(\d{1,2}):(\d{1,2})$/;
  var r = str.match(reg);
  if (r == null) return false;
  r[2] = r[2] - 1;
  var d = new Date(r[1], r[2], r[3], r[4], r[5], r[6]);
  if (d.getFullYear() != r[1]) return false;
  if (d.getMonth() != r[2])    return false;
  if (d.getDate() != r[3])     return false;
  if (d.getHours() != r[4])    return false;
  if (d.getMinutes() != r[5])  return false;
  if (d.getSeconds() != r[6])  return false;
  return true;
}

// ---------- 分割成陣列 ----------
Date.prototype.toArray = function() {
  var myDate = this;
  var 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 星期、ww 週、h 時、n 分、s 秒
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;
};

// ---------- 字串轉日期 ----------
// 支援 MM/dd/YYYY、MM-dd-YYYY、YYYY/MM/dd、YYYY-MM-dd
function StringToDate(DateStr) {
  var converted = Date.parse(DateStr);
  var myDate = new Date(converted);
  if (isNaN(myDate)) {
   var arys = DateStr.split('-');
   myDate = new Date(arys[0], --arys[1], arys[2]);
  }
  return myDate;
}

三、實作一個即時時鐘

輸出「2012年12月03日 17:21:16 星期一」這樣的格式:

 function clockon() {
  var now = new Date();
  var year  = now.getFullYear();
  var month = now.getMonth() + 1;
  var date  = now.getDate();
  var day   = now.getDay();
  var hour  = now.getHours();
  var minu  = now.getMinutes();
  var sec   = now.getSeconds();

  if (month < 10) month = "0" + month;
  if (date < 10)  date  = "0" + date;
  if (hour < 10)  hour  = "0" + hour;
  if (minu < 10)  minu  = "0" + minu;
  if (sec < 10)   sec   = "0" + sec;

  var arr_week = new Array("星期日","星期一","星期二","星期三","星期四","星期五","星期六");
  var week = arr_week[day];

  var time = year + "年" + month + "月" + date + "日 " +
       hour + ":" + minu + ":" + sec + " " + week;
  $("#bgclock").html(time);
  setTimeout("clockon()", 200);
}

四、幾個實務提醒

直接擴充 Date.prototype 雖然方便,但在多人協作或引入第三方套件時容易撞名,建議改成獨立命名空間的函式(例如 DateUtil.format(d, 'YYYY-MM-DD'))。另外,若要處理時區或跨國業務,Date 物件本身的能力相當有限,moment.js、day.js 或原生的 Intl.DateTimeFormat 會更可靠——尤其後者能直接輸出各語言的在地化格式,不必自己維護語系表。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved