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日午夜之间相差的协调世界时的毫秒数。如果是字符串,则根据日期和时间字符串中的规则分本dateValdateVal参数也可以是从一些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 方法返回指定对象的原始值。

如果你喜欢这篇文章,敬请给站长打赏↑

除特别注明外,本站所有文章均为本站站长原译,转载请注明出处。