Date.prototype.getYear()

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

getYear() 方法用於獲取此日期根據本地時間表示的年份。由於 getYear() 返回的年份不是完整的(存在“千年蟲”問題),因此它已被棄用,並由 getFullYear() 方法取代。

語法

js
getYear()

引數

無。

返回值

一個整數,表示給定日期根據本地時間表示的年份,減去 1900。如果日期 無效,則返回 NaN

  • 對於 2000 年及以後的年份,返回值將是 100 或更大。例如,如果年份是 2026,getYear() 將返回 126。
  • 對於 1900 年至 1999 年(含)之間的年份,getYear() 返回的值將在 0 到 99 之間。例如,如果年份是 1976,getYear() 將返回 76。
  • 對於 1900 年之前的年份,getYear() 返回的值將小於 0。例如,如果年份是 1800,getYear() 將返回 -100。

此方法本質上返回 getFullYear() 的值減去 1900。您應該使用 getFullYear() 來代替,以便完整地指定年份。

示例

1900 年至 1999 年間的年份

第二個語句將值 95 賦給變數 year

js
const xmas = new Date("1995-12-25");
const year = xmas.getYear(); // returns 95

1999 年以上的年份

第二個語句將值 100 賦給變數 year

js
const xmas = new Date("2000-12-25");
const year = xmas.getYear(); // returns 100

1900 年以下的年份

第二個語句將值 -100 賦給變數 year

js
const xmas = new Date("1800-12-25");
const year = xmas.getYear(); // returns -100

設定和獲取 1900 年至 1999 年間的年份

第三個語句將值 95 賦給變數 year,表示 1995 年。

js
const xmas = new Date("2015-12-25");
xmas.setYear(95);
const year = xmas.getYear(); // returns 95

規範

規範
ECMAScript® 2026 語言規範
# sec-date.prototype.getyear

瀏覽器相容性

另見