1. 概述
JavaScript 中經常需要對日期型的資料進行操作,操作後給日期元件指派。在對日期資料進行操作時,需要用 JavaScript 中的日期函式來處理日期物件。
本文將介紹 JavaScript 中常用的日期函式,並透過多個範例來示範如何給元件賦一個日期值。
2. 常用日期函式
注:日期函式的操作物件必須是日期物件。
方法 | 說明 |
---|---|
getDate() | 傳回 Date 物件的天 (1 ~ 31) |
getDay() | 傳回 Date 物件的週(0~6),星期天為 0, 以此類推 |
getFullYear() | 傳回 Date 物件表示年份的 4 位數字 |
getMonth() | 傳回 Date 物件的月份(0-11), 一月為 0, 二月為 1, 以此類推 |
getHours() | 傳回 Date 物件的小時 (0 ~ 23) |
getMinutes() | 傳回 Date 物件的分鐘 (0 ~ 59) |
getSeconds() | 傳回 Date 物件的秒數 (0 ~ 59) |
getMilliseconds() | 傳回 Date 物件的毫秒(0 ~ 999) |
getTime() | 傳回 1970 年 1 月 1 日至今的毫秒數 |
setDate() | 設定 Date 物件中月的某一天 (1 ~ 31) |
setMonth() | 設定 Date 物件中月份 (0 ~ 11) |
setFullYear() | 設定 Date 物件中的年份(四位數字) |
setHours() | 設定 Date 物件中的小時 (0 ~ 23) |
setMinutes() | 設定 Date 物件中的分鐘 (0 ~ 59) |
setSeconds() | 設定 Date 物件中的秒鐘 (0 ~ 59) |
setMilliseconds() | 設定 Date 物件中的毫秒 (0 ~ 999) |
setTime() | 以毫秒設定 Date 物件 |
toDateString() | 把 Date 物件的日期部分轉換為字串 |
toTimeString() | 把 Date 物件的時間部分轉換為字串 |
toLocaleString() | 根據本地時間格式,把 Date 物件轉換為字串 |
toLocaleDateString() | 根據本地時間格式,把 Date 物件的日期部分轉換為字串 |
toLocaleTimeString() | 根據本地時間格式,把 Date 物件的時間部分轉換為字串 |
3. 範例
透過參數面板上的元件來進行一些範例示範。如下圖所示:
注:對日期的加減,對月份的加減,對年份的加減等等,都是使用對應的 get 方法然後再使用 set 方法進行設定。
3.1 獲取當前日期
實現點選“按鈕”的時候,給日期元件賦一個當前日期。
給按鈕新增點選事件,JavaScript 程式碼如下:
var mydate = new Date(); //建立日期物件,回傳值為當前日期(包含時分秒)
this.options.form.getWidgetByName("date").setValue(mydate); //指派給日期元件
效果如下:
3.2 獲取前一天的值
對日期的加減是透過 setDate()方法。在 3.1 範例中,獲得當前日期後取前一天的。
var mydate = new Date(); //建立日期物件,回傳值為當前日期(包含時分秒)
mydate.setDate(mydate.getDate()-1); //設定日期物件中的“日”,為當前日-1
this.options.form.getWidgetByName("date").setValue(mydate); //指派給日期元件
效果如下:
3.3 獲取前一個月的值
對月份的加減透過 setMonth() 方法。在原當前日例子中,獲得當前日期的月份減 1。
var mydate = new Date(); //建立日期物件,回傳值為當前日期(包含時分秒)
mydate.setMonth(mydate.getMonth()-1); //設定日期物件中的“月”,為當前月-1
this.options.form.getWidgetByName("date").setValue(mydate); //指派給日期元件
效果如下: