設(shè)置 Date 對(duì)象中用本地時(shí)間表示的年份值。

dateObj.setFullYear(numYear[, numMonth[, numDate]])

參數(shù)

dateObj

必選項(xiàng)。任意 Date 對(duì)象。

numYear

必選項(xiàng)。一個(gè)等于年份的數(shù)值。

numMonth

可選項(xiàng)。一個(gè)等于月份的數(shù)值。如果提供了 numDate，那么此項(xiàng)也必須提供。

numDate

可選項(xiàng)。一個(gè)等于日期的數(shù)值。

說(shuō)明

如果沒(méi)有指定可選項(xiàng)，那么所有使用可選項(xiàng)的 set 方法都將使用從相應(yīng)的 get 方法返回的數(shù)值作為可選項(xiàng)的數(shù)值。例如，如果 numMonth 參數(shù)是可選的，但是沒(méi)有被指定，JScript 將使用從 getMonth 方法返回的值作為該參數(shù)的值。

此外，如果參數(shù)的的值超出其范圍或者是負(fù)數(shù)，其他被保存的值都將相應(yīng)地得到修改。

要設(shè)置用全球標(biāo)準(zhǔn)時(shí)間 (UTC) 表示的年份，請(qǐng)使用 setUTCFullYear 方法。

Date 對(duì)象中所支持的年份的范圍大約是 1970 年的前后各 285,616 年。

示例

下面這個(gè)例子說(shuō)明了 setFullYear 方法的用法。

function SetFullYearDemo(newyear){
   var d, s;                 // 聲明變量。
   d = new Date();           // 創(chuàng)建 Date 對(duì)象。
   d.setFullYear(newyear);   // 設(shè)置年份。
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                // 返回新的日期設(shè)置。
}

要求

版本 3

請(qǐng)參閱

Date 對(duì)象的方法 | getFullYear 方法 | getUTCFullYear 方法 | setUTCFullYear 方法

應(yīng)用于：Date 對(duì)象