Date 对象
启用日期和时间的基本存储和检索。
语法
dateObj = new Date() dateObj = new Date(dateVal) dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]])
参数
dateObj
必要参数。Date分配到的变量名称。
dateVal
必要参数。如果是数值,dateVal表示指定日期与1970年1月1日午夜之间相差的协调世界时的毫秒数。如果是字符串,则根据日期和时间字符串中的规则分本dateVal。dateVal参数也可以是从一些ActiveX对象返回的VT_DATE值。
year
必要参数。完整的年份,例如,1976(而不是76)。
month
必要参数。月份,用从0到11的整数表示(1月至12月)。
date
必要参数。日期,用从1到31的整数表示。
hours
可选参数。如果提供了minutes参数,就必须提供此参数。一个指定小时的,从0到23的整数(午夜到11pm)。
minutes
可选参数。如果提供了second参数,那么必须提供此参数。一个指定秒的,从0到59的整数。
seconds
可选参数。如果提供了milliseconds参数,那么必须提供此参数。一个指定秒的,从0到59的整数。
ms
可选参数。一个指定毫秒的,从0到999的整数。
备注
Date对象包含具体时间(可以精确到毫秒)的数字。如果参数值大于其取值范围或者为负,则会相应地修改存储的其他值。例如,如果指定150秒,则JavaScript将该数字重新定义为2分30秒。
如果数字是NaN,则对象不表示特定的时间时刻。如果没有将任何参数传递到Date对象,该函数将初始化为当前时间(UTC)。必须先为对象赋值,然后才能使用它。
可在Date对象中表示的日期范围大约为1970年1月1日左右的285616年。
欲进一步了解如何使用Date对象和相关方法,请参阅计算日期和时间。
示例
下面的示例演示了Date对象的用法。
var dateString = "Today's date is: "; var newDate = new Date(); // Get the month, day, and year. dateString += (newDate.getMonth() + 1) + "/"; dateString += newDate.getDate() + "/"; dateString += newDate.getFullYear(); document.write(dateString); // Output: Today's date is: <date>
必备条件
Internet Explorer 6之前的Internet Explorer 中已引入了Date对象。更高版本中已引入以下列表中的某些成员。欲进一步了解,请参阅版本信息或单个成员对应的文档。
属性
下表列出了Date Object的属性。
属性 | 描述 |
---|---|
constructor 属性 | 指定创建一个对象的函数。 |
prototype 属性 | 为对象的类返回原型的引用。 |
函数
下表列出了Date Object的函数。
Functions | 描述 |
---|---|
Date.now 函数 | 返回1970年1月1日与当前日期和时间之间的毫秒数。 |
Date.parse 函数 | 解析一个包含日期的字符串,并返回该日期与1970年1月1日午夜之间相差的毫秒数。 |
Date.UTC 函数 | 返回协调通用时间(UTC)1970年1月1日午夜之间相差的毫秒数。 |
方法
下表列出了Date Object的方法。
方法 | 描述 |
---|---|
getDate 方法 | 使用当地时间返回一个星期某天的值。 |
getDay 方法 | 使用当地时间返回一个星期某天值。 |
getFullYear 方法 | 使用当地时间返回年份值。 |
getHours 方法 | 使用当地时间返回小时值。 |
getMilliseconds 方法 | 使用当地时间返回毫秒值。 |
getMinutes 方法 | 使用当地时间返回分钟值。 |
getMonth 方法 | 使用当地时间返回月份值。 |
getSeconds 方法 | 使用当地时间返回秒值。 |
getTime 方法 | 将Date对象中的时间值返回为自1970年1月1日午夜起经过的毫秒数。 |
getTimezoneOffset 方法 | 返回主机的时间与协调通用时间(UTC)之间的分钟差值。 |
getUTCDate 方法 | 使用UTC返回一个月某天的值。 |
getUTCDay 方法 | 使用UTC返回一个星期某天的值。 |
getUTCFullYear 方法 | 使用UTC返回年份值。 |
getUTCHours 方法 | 使用UTC返回小时值。 |
getUTCMilliseconds 方法 | 使用UTC返回毫秒值。 |
getUTCMinutes 方法 | 使用UTC返回分钟值。 |
getUTCMonth 方法 | 使用UTC返回月份值。 |
getUTCSeconds 方法 | 使用UTC返回秒值。 |
getVarDate 方法 | 将Date对象中的VT_DATE值返回。 |
getYear 方法 | 返回年份值。 |
hasOwnProperty 方法 | 返回一个布尔值,该值指示一个对象是否具有指定名称的属性。 |
isPrototypeOf 方法 | 返回一个布尔值,该值指示对象是否存在于另一个对象的原型链中。 |
propertyIsEnumerable 方法 | 返回一个布尔值,该值指定属性是否为对象的一部分以及该属性是否是可枚举的。 |
setDate 方法 | 使用本地时间设置一个月中某一日的数值。 |
setFullYear 方法 | 使用本地时间设置年份值。 |
setHours 方法 | 使用本地时间设置小时值。 |
setMilliseconds 方法 | 使用本地时间设置毫秒值。 |
setMinutes 方法 | 使用本地时间设置分钟值。 |
setMonth 方法 | 使用本地时间设置月份值。 |
setSeconds 方法 | 使用本地时间设置秒值。 |
setTime 方法 | 设置Date对象中的日期和时间值。 |
setUTCDate 方法 | 使用UTC设置一个月中某一日的数值。 |
setUTCFullYear 方法 | 使用UTC设置年份值。 |
setUTCHours 方法 | 使用UTC设置小时值。 |
setUTCMilliseconds 方法 | 使用UTC设置毫秒值。 |
setUTCMinutes 方法 | 使用UTC设置分钟值。 |
setUTCMonth 方法 | 使用UTC设置月份值。 |
setUTCSeconds 方法 | 使用UTC设置秒值。 |
setYear 方法 | 使用本地时间设置年份值。 |
toDateString 方法 | 以字符串的形式返回一个日期。 |
toGMTString 方法 | 返回使用格林尼治标准时间(GMT)转换为字符串的日期。 |
toISOString 方法 | 以字符串值的形式返回采用ISO格式的日期。 |
toJSON 方法 | 用于在JSON序列化之前转换目标类型的数据。 |
toLocaleDateString 方法 | 将一个日期以字符串值的形式返回,该字符串应适合于宿主环境的当前区域设置。 |
toLocaleString 方法 | 返回使用当前区域设置转换为字符串的对象。 |
toLocaleTimeString 方法 | 以字符串值的形式返回一个时间,此字符串值应与宿主环境的当前区域设置相适应。 |
toString 方法 | 返回表示对象的字符串。 |
toTimeString 方法 | 以字符串值形式返回时间。 |
toUTCString 方法 | 返回使用UTC转换为字符串的日期。 |
valueOf 方法 | 返回指定对象的原始值。 |