此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
Date.prototype.getDay()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Date 實例的getDay() 方法會根據本地時間回傳指定日期的星期幾,其中 0 代表星期日。若要取得月份中的日期,請參見Date.prototype.getDate()。
In this article
嘗試一下
const birthday = new Date("August 19, 1975 23:15:30");const day1 = birthday.getDay();// 星期日 - 星期六:0 - 6console.log(day1);// 預期輸出:2語法
js
getDay()參數
無。
回傳值
一個介於 0 到 6 之間的整數,根據本地時間表示給定日期的星期幾:0 代表星期日,1 代表星期一,2 代表星期二,依此類推。如果日期為無效,則回傳NaN。
描述
getDay() 的回傳值是從零開始的,這對於索引星期陣列很有用,例如:
js
const valentines = new Date("1995-02-14");const day = valentines.getDay();const dayNames = ["星期日", "星期一", "星期二" /* , … */];console.log(dayNames[day]); // "星期一"然而,為了國際化,你應該優先使用帶有options 參數的Intl.DateTimeFormat。
js
const options = { weekday: "long" };console.log(new Intl.DateTimeFormat("en-US", options).format(valentines));// "Monday"console.log(new Intl.DateTimeFormat("de-DE", options).format(valentines));// "Montag"範例
>使用 getDay()
weekday 變數的值為1,這是基於Date 物件xmas95 的值,因為 1995 年 12 月 25 日是星期一。
js
const xmas95 = new Date("1995-12-25T23:15:30");const weekday = xmas95.getDay();console.log(weekday); // 1規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-date.prototype.getday> |