Date物件是內建的JavaScript語言的資料型別。日期物件使用new Date( )建立,如下所示。
一旦一個Date物件被建立後,許多方法讓你操作它。最簡單的方法,可讓您獲得並設定年,月,日,小時,分鐘,物件的秒和毫秒等欄位,採用本地時間或UTC(通用或GMT)時間。
ECMAScript標準要求Date物件能夠代表任何日期和時間,精確到毫秒,在億天之前或之後,1970年1月1日。這是一系列的正負273785年,所以JavaScript是能夠代表的日期和時間,直到275755年。
這裡有不同的 Date()建構函式:
new Date( ) new Date(milliseconds) new Date(datestring) new Date(year,month,date[,hour,minute,second,millisecond ])
註:括號內外觀和資料總是可選
這裡是引數的說明:
No Argument: 不帶任何引數,則Date()建構函式建立一個Date物件設定為當前日期和時間。
milliseconds:當一個數位引數傳遞,它將被視為以毫秒為單位的日期的內部數位表示,如返回getTime()方法。例如,通過引數5000建立一個代表在70年1月1日5秒過了午夜的日期。
datestring:當一個字串引數傳遞,它是一個日期的字串表示,Date.parse()方法接受的格式。
7 agruments: 使用上面給出的建構函式的最後形式,這是每個引數的說明:
這裡是每個屬性和它們的描述的列表。
屬性 | 描述 |
---|---|
constructor | 指定建立物件的原型函式 |
prototype | prototype屬性可以讓屬性和方法新增到物件 |
這裡是每種方法及其描述的列表。
方法 | 描述 |
---|---|
Date() | 返回今天的日期和時間 |
getDate() | 按照本地時間返回月份的日在指定日期 |
getDay() | 按照本地時間返回星期幾為指定日期 |
getFullYear() | 按照本地時間返回指定日期的年份 |
getHours() | 按照本地時間返回指定日期的小時 |
getMilliseconds() | 按照本地時間返回指定日期的毫秒數 |
getMinutes() | 按照本地時間返回分鐘,在指定的日期 |
getMonth() | 按照本地時間返回指定日期的月份 |
getSeconds() | 按照本地時間返回秒在指定的日期 |
getTime() | 返回指定日期的毫秒數自1970年1月1日00:00:00 UTC以來的數值 |
getTimezoneOffset() | 返回時區以分鐘為當前區域的偏移 |
getUTCDate() | 按照通用時間返回指定日期的月份的日子(日期) |
getUTCDay() | 按照通用時間返回指定日期的一周中的一天 |
getUTCFullYear() | 按照通用時間返回指定日期的年份 |
getUTCHours() | 按照通用時間返回的時間在指定的日期 |
getUTCMilliseconds() | 按照通用時間返回指定日期的毫秒數 |
getUTCMinutes() | 按照通用時間返回分鐘,在指定的日期 |
getUTCMonth() | 按照通用時間返回指定日期的月份 |
getUTCSeconds() | 按照通用時間返回秒在指定的日期 |
getYear() | 棄用 - 返回當年在指定日期按照本地時間。使用方式和getFullYear代替 |
setDate() | 按照本地時間設定月份的日在指定日期 |
setFullYear() | 按照本地時間設定全年為指定日期 |
setHours() | 按照本地時間設定小時在指定的日期 |
setMilliseconds() | 設定毫秒按照本地時間在指定的日期 |
setMinutes() | 設定分鐘,按照本地時間在指定的日期 |
setMonth() | 按照本地時間設定指定日期的月份 |
setSeconds() | 按照本地時間設定秒指定日期 |
setTime() | 設定自1970年1月1日00:00:00 UTC Date物件通過毫秒數表示的時間。 |
setUTCDate() | 按照通用時間設定月份的一天,在指定的日期 |
setUTCFullYear() | 按照通用時間設定全年在指定的日期 |
setUTCHours() | 按照通用時間設定小時為指定日期 |
setUTCMilliseconds() | 設定毫秒根據通用時間在指定的日期 |
setUTCMinutes() | 設定分鐘,按照通用的時間在指定的日期 |
setUTCMonth() | 按照通用時間設定指定日期的月份 |
setUTCSeconds() | 按照通用時間設定秒指定日期 |
setYear() | 棄用 - 設定一年按照本地時間在指定的日期。使用呼叫setFullYear代替 |
toDateString() | 返回的日期為人類可讀的字串的“日期”部分 |
toGMTString() | 已過時 - 使用網際網路GMT約定的日期轉換為字串。使用toUTCString代替 |
toLocaleDateString() | 返回的日期作為字串的“日期”部分,使用當前語言環境的約定 |
toLocaleFormat() | 使用格式字串的日期轉換為字串 |
toLocaleString() | 使用當前區域設定的約定一個日期轉換為字串 |
toLocaleTimeString() | 返回的日期作為字串的“時間”部分,使用當前語言環境的約定 |
toSource() | 返回表示源等效Date物件的字串; 可以使用這個值來建立一個新的物件 |
toString() | 返回表示指定日期物件的字串 |
toTimeString() | 返回的日期為人類可讀的字串“時間”部分 |
toUTCString() | 使用通用的時間約定一個日期轉換為字串 |
valueOf() | 返回Date物件的原始值 |
除了以上列出的許多範例方法,該日期物件還定義了兩個靜態方法。這些方法是通過Date()構造本身呼叫:
方法 | 描述 |
---|---|
Date.parse( ) | 解析的日期和時間的字串表示,並返回該日期的內部毫秒表示 |
Date.UTC( ) | 返回指定UTC日期和時間的毫秒表示 |