1. 給開發者的 Web 技術文件
  2. JavaScript
  3. JavaScript 參考文件
  4. 標準內建物件
  5. Date
  6. Date.prototype.getDay()

此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

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()。

嘗試一下

const birthday = new Date("August 19, 1975 23:15:30");
const day1 = birthday.getDay();
// 星期日 - 星期六：0 - 6

console.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® 2027 Language Specification
# sec-date.prototype.getday

瀏覽器相容性

參見

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content