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 |
瀏覽器相容性
載入中…