JavaScript Date 对象参考手册

Date 对象

Date 对象用于处理日期和时间。

创建 Date 对象的语法：

var myDate=new Date()      

注释：Date 对象会自动把当前日期和时间保存为其初始值。

Date()定义和用法

Date() 方法可返回当天的日期和时间。

语法

Date()      

实例

在本例中，我们将输出今天的日期和时间：

<script type="text/javascript">

document.write(Date())

</script>      

输出：

Wed Aug 14 21:40:50 UTC+0800 2013
      

getDate()定义和用法

getDate() 方法可返回月份的某一天。

语法

dateObject.getDate()      

返回值

dateObject 所指的月份中的某一天，使用本地时间。返回值是 1 ~ 31 之间的一个整数。

提示和注释：

注释：该方法总是结合一个 Date 对象来使用。

实例

例子 1

在本例中，我们将输出当前月份的日期：

<script type="text/javascript">

var d = new Date()
document.write(d.getDate())

</script>      

输出：

14
      

例子 2

在本例中，我们定义了一个带有具体日期的变量，并输出变量中月份的天：

<script type="text/javascript">

var birthday = new Date("July 21, 1983 01:15:00")
document.write(birthday.getDate())

</script>      

输出：

21      

getDay()定义和用法

getDay() 方法可返回表示星期的某一天的数字。

语法

dateObject.getDay()      

返回值

dateObject 所指的星期中的某一天，使用本地时间。返回值是 0（周日） 到 6（周六） 之间的一个整数。

提示和注释：

注释：该方法总是结合一个 Date 对象来使用。

实例

例子 1

在本例中，我们将以数字取得星期的当前一天：

<script type="text/javascript">

var d=new Date()
document.write(         d.getDay()                )

</script>      

输出：

3
      

例子 2

现在，我们将创建一个数组，这样就可以使上面的例子输出星期的名称，而不是数字：

<script type="text/javascript">

var d=new Date()

var weekday=new Array(7)
weekday[0]="Sunday"
weekday[1]="Monday"
weekday[2]="Tuesday"
weekday[3]="Wednesday"
weekday[4]="Thursday"
weekday[5]="Friday"
weekday[6]="Saturday"

document.write("Today it is " + weekday[         d.getDay()                ])

</script>      

输出：

Today it is Wednesday
      

getMonth()定义和用法

getMonth() 方法可返回表示月份的数字。

语法

dateObject.getMonth()      

返回值

dateObject 的月份字段，使用本地时间。返回值是 0（一月） 到 11（十二月） 之间的一个整数。

提示和注释：

注释：该方法总是结合一个 Date 对象来使用。

实例

例子 1

在本例中，我们将取得当前的日期，并把它输出：

<script type="text/javascript">

var d=new Date()

document.write(d.getMonth())

</script>      

输出：

7
      

例子 2

现在，我们将创建一个数组，以输出月份的名称，而不是一个数字：

<script type="text/javascript">

var d=new Date()

var month=new Array(12)
month[0]="January"
month[1]="February"
month[2]="March"
month[3]="April"
month[4]="May"
month[5]="June"
month[6]="July"
month[7]="August"
month[8]="September"
month[9]="October"
month[10]="November"
month[11]="December"

document.write("The month is " + month[d.getMonth()])

</script>      

输出：

The month is August
      

getFullYear()定义和用法

getFullYear() 方法可返回一个表示年份的 4 位数字。

语法

dateObject.getFullYear()      

返回值

当 dateObject 用本地时间表示时返回的年份。返回值是一个四位数，表示包括世纪值在内的完整年份，而不是两位数的缩写形式。

提示和注释：

注释：该方法总是结合一个 Date 对象来使用。

实例

例子 1

在本例中，我们将取得当前的年份，并输出它：

<script type="text/javascript">

var d = new Date()
document.write(d.getFullYear())

</script>      

输出：

2013      

例子 2

在本例中，我们将从具体到日期提取年份：

<script type="text/javascript">

var born = new Date("July 21, 1983 01:15:00")
document.write(born.getFullYear())

</script>      

输出：

1983      

getHours()定义和用法

返回 Date 对象的小时 (0 ~ 23)。

getMinutes()定义和用法

返回 Date 对象的分钟 (0 ~ 59)。

getSeconds()定义和用法

返回 Date 对象的秒数 (0 ~ 59)。

getMilliseconds()定义和用法

返回 Date 对象的毫秒(0 ~ 999)。

getTime()定义和用法

返回 1970 年 1 月 1 日至今的毫秒数。

getTimezoneOffset()定义和用法

getTimezoneOffset() 方法可返回格林威治时间和本地时间之间的时差，以分钟为单位。

语法

dateObject.getTimezoneOffset()      

返回值

本地时间与 GMT 时间之间的时间差，以分钟为单位。

说明

getTimezoneOffset() 方法返回的是本地时间与 GMT 时间或 UTC 时间之间相差的分钟数。实际上，该函数告诉我们运行 JavaScript 代码的时区，以及指定的时间是否是夏令时。

返回之所以以分钟计，而不是以小时计，原因是某些国家所占有的时区甚至不到一个小时的间隔。

提示和注释：

注释：由于使用夏令时的惯例，该方法的返回值不是一个常量。

注释：该方法总是结合一个 Date 对象来使用。

实例

例子 1

在下面的例子中，我们将取得 GMT 时间与本地时间以分钟计的时间差：

<script type="text/javascript">

var d = new Date()
document.write(         d.getTimezoneOffset()                )

</script>      

输出：

-480      

例子 2

现在，我们将把上面的例子转换为 GMT +/- 小时：

<script type="text/javascript">

var d = new Date()
var gmtHours =          d.getTimezoneOffset()                /60
document.write("The local time zone is: GMT " + gmtHours)

</script>      

输出：

The local time zone is: GMT -8      

Date 对象方法

FF: Firefox, IE: Internet Explorer

方法	描述	FF	IE
Date()	返回当日的日期和时间。	1	3
getDate()	从 Date 对象返回一个月中的某一天 (1 ~ 31)。	1	3
getDay()	从 Date 对象返回一周中的某一天 (0 ~ 6)。	1	3
getMonth()	从 Date 对象返回月份 (0 ~ 11)。	1	3
getFullYear()	从 Date 对象以四位数字返回年份。	1	4
getYear()	请使用 getFullYear() 方法代替。	1	3
getHours()	返回 Date 对象的小时 (0 ~ 23)。	1	3
getMinutes()	返回 Date 对象的分钟 (0 ~ 59)。	1	3
getSeconds()	返回 Date 对象的秒数 (0 ~ 59)。	1	3
getMilliseconds()	返回 Date 对象的毫秒(0 ~ 999)。	1	4
getTime()	返回 1970 年 1 月 1 日至今的毫秒数。	1	3
getTimezoneOffset()	返回本地时间与格林威治标准时间 (GMT) 的分钟差。	1	3
getUTCDate()	根据世界时从 Date 对象返回月中的一天 (1 ~ 31)。	1	4
getUTCDay()	根据世界时从 Date 对象返回周中的一天 (0 ~ 6)。	1	4
getUTCMonth()	根据世界时从 Date 对象返回月份 (0 ~ 11)。	1	4
getUTCFullYear()	根据世界时从 Date 对象返回四位数的年份。	1	4
getUTCHours()	根据世界时返回 Date 对象的小时 (0 ~ 23)。	1	4
getUTCMinutes()	根据世界时返回 Date 对象的分钟 (0 ~ 59)。	1	4
getUTCSeconds()	根据世界时返回 Date 对象的秒钟 (0 ~ 59)。	1	4
getUTCMilliseconds()	根据世界时返回 Date 对象的毫秒(0 ~ 999)。	1	4
parse()	返回1970年1月1日午夜到指定日期（字符串）的毫秒数。	1	3
setDate()	设置 Date 对象中月的某一天 (1 ~ 31)。	1	3
setMonth()	设置 Date 对象中月份 (0 ~ 11)。	1	3
setFullYear()	设置 Date 对象中的年份（四位数字）。	1	4
setYear()	请使用 setFullYear() 方法代替。	1	3
setHours()	设置 Date 对象中的小时 (0 ~ 23)。	1	3
setMinutes()	设置 Date 对象中的分钟 (0 ~ 59)。	1	3
setSeconds()	设置 Date 对象中的秒钟 (0 ~ 59)。	1	3
setMilliseconds()	设置 Date 对象中的毫秒 (0 ~ 999)。	1	4
setTime()	以毫秒设置 Date 对象。	1	3
setUTCDate()	根据世界时设置 Date 对象中月份的一天 (1 ~ 31)。	1	4
setUTCMonth()	根据世界时设置 Date 对象中的月份 (0 ~ 11)。	1	4
setUTCFullYear()	根据世界时设置 Date 对象中的年份（四位数字）。	1	4
setUTCHours()	根据世界时设置 Date 对象中的小时 (0 ~ 23)。	1	4
setUTCMinutes()	根据世界时设置 Date 对象中的分钟 (0 ~ 59)。	1	4
setUTCSeconds()	根据世界时设置 Date 对象中的秒钟 (0 ~ 59)。	1	4
setUTCMilliseconds()	根据世界时设置 Date 对象中的毫秒 (0 ~ 999)。	1	4
toSource()	返回该对象的源代码。	1	-
toString()	把 Date 对象转换为字符串。	1	4
toTimeString()	把 Date 对象的时间部分转换为字符串。	1	4
toDateString()	把 Date 对象的日期部分转换为字符串。	1	4
toGMTString()	请使用 toUTCString() 方法代替。	1	3
toUTCString()	根据世界时，把 Date 对象转换为字符串。	1	4
toLocaleString()	根据本地时间格式，把 Date 对象转换为字符串。	1	3
toLocaleTimeString()	根据本地时间格式，把 Date 对象的时间部分转换为字符串。	1	3
toLocaleDateString()	根据本地时间格式，把 Date 对象的日期部分转换为字符串。	1	3
UTC()	根据世界时返回 1970 年 1 月 1 日 到指定日期的毫秒数。	1	3
valueOf()	返回 Date 对象的原始值。	1	4