内容目录
Date.UTC()
函数用于返回协调通用时间 (UTC)(或GMT)1970 年 1 月 1 日午夜与所提供的日期之间相差的毫秒数。
该函数属于Date对象,所有主流浏览器均支持该函数。
语法
静态函数Date.UTC()
的语法如下:
Date.UTC( year, month, day [, hours [, minutes [, seconds [, milliseconds ]]]] )
参数
参数 | 描述 |
---|---|
year | Number类型指定的年份值。 |
month | Number类型指定的月份值。 |
day | Number类型指定的日期数值。 |
hours | 可选/Number类型指定的小时值。 |
minutes | 可选/Number类型指定的分钟值。 |
seconds | 可选/Number类型指定的秒值。 |
milliseconds | 可选/Number类型指定的毫秒值。 |
Date.UTC()
函数的所有参数都可以超出常规的取值范围,也可以为负数,Date
对象内部会自动计算并转换为对应的日期。例如:参数month
可以超出0 ~ 11的常规取值范围,参数day
可以超出1 ~ 31的常规取值范围。
如果提供了指定的可选参数,就必须提供参数列表中出现在该参数之前的所有可选参数。
注意,参数month
的值比实际月份小1。
返回值
Date.UTC()
函数的返回值为Number类型,返回指定日期与UTC时间 1970 年 1 月 1 日午夜之间相差的毫秒数。Date.UTC()
函数的参数也是基于UTC时间进行计算的。
示例&说明
//当前运行环境的时区设置为 UTC+8
var time = Date.UTC(2013, 2, 25);
var date = new Date(time);
// 输出为本地时间,会+8小时
document.writeln( date.toLocaleString() ); // 2013年3月25日 8:00:00
time = Date.UTC(2008, 7, 8, 12, 30, 45);
date = new Date(time);
// 输出为本地时间,会+8小时
document.writeln( date.toLocaleString() ); // 2008年8月8日 20:30:45
0 条评论
撰写评论