JavaScript Date物件


Date物件是內建的JavaScript語言的資料型別。日期物件使用new Date( )建立,如下所示。

一旦一個Date物件被建立後,許多方法讓你操作它。最簡單的方法,可讓您獲得並設定年,月,日,小時,分鐘,物件的秒和毫秒等欄位,採用本地時間或UTC(通用或GMT)時間。

ECMAScript標準要求Date物件能夠代表任何日期和時間,精確到毫秒,在億天之前或之後,1970年1月1日。這是一系列的正負273785年,所以JavaScript是能夠代表的日期和時間,直到275755年。

Syntax:

這裡有不同的 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: 使用上面給出的建構函式的最後形式,這是每個引數的說明:

    1. year: 整數值表示年份。為了相容(為了避免千年蟲問題),你應該總是指定完整年份; 使用1998年,而不是98。
    2. month: 整數值表示月份,以0開頭一月至11月。
    3. date: 整數值代表月份的一天。
    4. hour: 表示天(24小時刻度)的小時整數值。
    5. minute: 整數值表示的時間讀取分鐘段。
    6. second: 整數值表示的時間讀取第二部分。
    7. millisecond: 整數值表示的時間閱讀毫秒段。

Date屬性:

這裡是每個屬性和它們的描述的列表。

屬性 描述
constructor 指定建立物件的原型函式
prototype prototype屬性可以讓屬性和方法新增到物件

Date方法:

這裡是每種方法及其描述的列表。

方法 描述
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()構造本身呼叫:

方法 描述
Date.parse( ) 解析的日期和時間的字串表示,並返回該日期的內部毫秒表示
Date.UTC( ) 返回指定UTC日期和時間的毫秒表示