Asp.net AJAX JavaScript 基本类型扩展(3)——Date 类型及其扩展

参考:
JScript  语言参考
http://msdn2.microsoft.com/en-us/library/592ceae4-a3cc-4c53-8cc9-9f72d48a9f50
Asp.net AJAX 在线文档
http://www.asp.net/AJAX/Documentation/Live/ClientReference/Global/JavascriptTypeExtensions/Date

TypeExt/default.aspx

Asp.net AJAX JavaScript Date 类型扩展

format 方法
将一个Date类型根据format格式化字符格式化返回string

格式化字符定义
http://msdn2.microsoft.com/en-us/library/bb79761a-ca08-44ee-b142-b06b3e2fc22b.aspx

localeFormat 方法
根据当地设置格式化日期并返回string

当地设置信息
http://msdn2.microsoft.com/en-us/kx54z3k7

parseLocale 方法
根据当地设置和日期格式化字符和日期信息返回一个Date对象
语法
var a = Date.parseLocale(value, formats);

parseInvariant 方法
根据通用日期格式化字符和日期信息返回一个Date对象
语法
var a = Date.parseInvariant(value, formats);

Date 基本类型

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 按照 parse 方法中的规则进行解析。dateVal 参数也可以是从某些 ActiveX(R) 对

象返回的 VT_DATE 值。

year

必选项。完整的年份,比如,1976(而不是 76)。

month

必选项。表示的月份,是从 0 到 11 之间的整数( 1 月至 12 月)。

date

必选项。表示日期,是从 1 到 31 之间的整数。

hours

可选项。 如果提供了 minutes 则必须给出。表示小时,是从 0 到 23 的整数(午夜到 11pm)。

minutes

可选项。 如果提供了 seconds 则必须给出。表示分钟,是从 0 到 59 的整数。

seconds

可选项。 如果提供了 milliseconds 则必须给出。表示秒钟,是从 0 到 59 的整数。

ms

可选项。 表示毫秒,是从 0 到 999 的整数。

说明
Date 对象保存以毫秒为单位表示特定时间段。如果某个参数的值大于其范围或为负数,则存储的其他值将做

相应的调整。例如,如果指定 150 秒,JScript 将该数字重新定义为 2 分 30 秒。

如果数字为 NaN,则表示该对象不代表特定的时间段。如果未向 Date 对象传递参数,它将被初始化为当前

时间 (UTC)。在能够使用该对象前必须为其赋值。

Date 对象能够表示的日期范围约等于 1970 年 1 月 1 日前后各 285,616 年。

Date 对象具有两个不创建 Date 对象就可以调用的静态方法。它们是 parse 和 UTC。

错误
下面的示例演示了 Date 对象的用法。

function DateDemo(){
   var d, s = "Today's date is: ";           // 声明变量。
   d = new Date();                           // 创建 Date 对象。
   s += (d.getMonth() + 1) + "/";            // 获取月份。
   s += d.getDate() + "/";                   // 获取日。
   s += d.getYear();                         // 获取年份。
   return(s);                                // 返回日期。
}
属性
constructor 属性 | prototype 属性

方法
getDate 方法 | getDay 方法 | getFullYear 方法 | getHours 方法 | getMilliseconds 方法 |

getMinutes 方法 | getMonth 方法 | getSeconds 方法 | getTime 方法 | getTimezoneOffset 方法 |

getUTCDate 方法 | getUTCDay 方法 | getUTCFullYear 方法 | getUTCHours 方法 | getUTCMilliSeconds

方法 | getUTCMinutes 方法 | getUTCMonth 方法 | getUTCSeconds 方法 | getVarDate 方法 | getYear

方法 | setDate 方法 | setFullYear 方法 | setHours 方法 | setMilliSeconds 方法 | setMinutes 方法

| setMonth 方法 | setSeconds 方法 | setTime 方法 | setUTCDate 方法 | setUTCFullYear 方法 |

setUTCHours 方法 | setUTCMilliseconds 方法 | setUTCMinutes 方法 | setUTCMonth 方法 |

setUTCSeconds 方法 | setYear 方法 | toGMTString 方法 | toLocaleString 方法 | toUTCString 方法 |

toString 方法 | valueOf 方法 | parse 方法 | UTC 方法

constructor 属性
表示创建对象的函数。

object.constructor

必需的 object是对象或函数的名称。

说明
constructor 属性是所有具有 prototype 的对象的成员。它们包括除 Global 和 Math 对象以外的所有

JScript 固有对象。constructor 属性保存了对构造特定对象实例的函数的引用。 例如:

x = new String("Hi");
if (x.constructor == String)
      // 进行处理(条件为真)。

function MyFunc {
   // 函数体。
}

y = new MyFunc;
if (y.constructor == MyFunc)
      // 进行处理(条件为真)。

prototype 属性
返回对象类型原型的引用。

objectName.prototype

objectName 参数是对象的名称。

说明
用 prototype 属性提供对象的类的一组基本功能。 对象的新实例“继承”赋予该对象原型的操作。

例如,要为 Array 对象添加返回数组中最大元素值的方法。 要完成这一点,声明该函数,将它加入

Array.prototype, 并使用它。

function array_max( ){
   var i, max = this[0];
   for (i = 1; i < this.length; i++)
   {
   if (max < this[i])
   max = this[i];
   }
   return max;
}
Array.prototype.max = array_max;
var x = new Array(1, 2, 3, 4, 5, 6);
var y = x.max( );
该代码执行后,y 保存数组 x 中的最大值,或说 6。

所有 JScript 固有对象都有只读的 prototype 属性。可以象该例中那样为原型添加功能,但该对象不能被

赋予不同的原型。然而,用户定义的对象可以被赋给新的原型。

本语言参考中每个内部对象的方法和属性列表指出哪些是对象原型的部分,哪些不是。

getDate 方法
返回 Date 对象中用本地时间表示的一个月中的日期值。

dateObj.getDate()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的日期值,请使用 getUTCDate 方法。

返回值是一个处于 1 到 31 之间的整数,它代表了相应的 Date 对象中的日期值。

示例
下面这个例子说明了 getDate 方法的用法:

function DateDemo(){
   var d, s = "今天日期是: ";
   d = new Date();
   s += (d.getMonth() + 1) + "/";
   s += d.getDate() + "/";
   s += d.getYear();
   return(s);
}

getDay 方法
返回 Date 对象中用本地时间表示的一周中的日期值。

dateObj.getDay()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的一周中日期值,请使用 getUTCDay 方法。

getDay 方法所返回的值是一个处于 0 到 6 之间的整数,它代表了一周中的某一天,返回值与一周中日期的

对应关系如下:

值 星期
0 星期天
1 星期一
2 星期二
3 星期三
4 星期四
5 星期五
6 星期六


下面这个例子说明了 getDay 方法的用法。

function DateDemo(){
   var d, day, x, s = "今天是: ";
   var x = new Array("星期日", "星期一", "星期二");
   var x = x.concat("星期三","星期四", "星期五");
   var x = x.concat("星期六");
   d = new Date();
   day = d.getDay();
   return(s += x[day]);
}

getFullYear 方法
返回 Date 对象中用本地时间表示的年份值。

dateObj.getFullYear()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的年份值,请使用 getUTCFullYear 方法。

getFullYear 方法以绝对数字的形式返回年份值。例如,1976 年的返回值就是 1976。这样可以避免出现

2000 年问题,从而不会将 2000 年1月1日以后的日期与 1900 年1月1日以后的日期混淆起来。

下面这个例子说明了 GetFullYear 方法的用法。

function DateDemo(){
   var d, s = "今天 UTC 日期是: ";
   d = new Date();
   s += (d.getMonth() + 1) + "/";
   s += d.getDate() + "/";
   s += d.getFullYear();
   return(s);
}

getHours 方法
返回 Date 对象中用本地时间表示的小时值。

dateObj.getHours()

必选项 dateObj 参数为 Date 对象。

说明
要获取用 全球标准时间 (UTC)表示的小时值,请使用 getUTCHours 方法。

getHours 方法返回一个处于 0 到 23 之间的整数,这个值表示从午夜开始计算的小时数。在下面两种情况

下此方法的返回值是 0:时间在 1:00:00 am 之前,或者在创建 Date 对象的时候没有将时间保存在该对象

中。而要确定究竟是哪种情况,唯一的方法就是进一步检查分钟和秒钟值是否也是 0。如果这两个值都是 0

,那就几乎可以确定是没有将时间值保存到 Date 对象中。

下面这个例子说明了 getHours 方法的用法。

function TimeDemo(){
   var d, s = "当前本地时间为: ";
   var c = ":";
   d = new Date();
   s += d.getHours() + c;
   s += d.getMinutes() + c;
   s += d.getSeconds() + c;
   s += d.getMilliseconds();
   return(s);
}

getMilliseconds 方法
返回 Date 对象中用本地时间表示的毫秒值。

dateObj.getMilliseconds()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的毫秒值,请使用 getUTCMilliseconds 方法。

所返回的毫秒值处于 0-999 之间。

示例
下面这个例子说明了 getMilliseconds 方法的用法:

function TimeDemo(){
   var d, s = "当前本地时间为: ";
   var c = ":";
   d = new Date();
   s += d.getHours() + c;
   s += d.getMinutes() + c;
   s += d.getSeconds() + c;
   s += d.getMilliseconds();
   return(s);
}

getMinutes 方法
返回 Date 对象中用本地时间表示的分钟值。

dateObj.getMinutes()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的分钟值,请使用 getUTCMinutes 方法。

getMinutes 方法返回一个处于 0 到 59 之间的整数,返回值就等于保存在 Date 对象中的分钟值。在下面

两种情况下返回值为 0:在时钟整点之后经过的时间少于一分钟,或者是在创建 Date 对象的时候没有将时

间值保存到该对象中。而要确定究竟是哪种情况,唯一的方法是同时检查小时和秒钟值是否也是 0。如果这

两个值都是 0,那就几乎可以确定是没有将时间值保存到该 Date 对象中。

示例
下面这个例子说明了 getMinutes 方法的用法:

function TimeDemo(){
   var d, s = "当前本地时间为: ";
   var c = ":";
   d = new Date();
   s += d.getHours() + c;
   s += d.getMinutes() + c;
   s += d.getSeconds() + c;
   s += d.getMilliseconds();
   return(s);
}

getMonth 方法
返回 Date 对象中用本地时间表示的月份值。

dateObj.getMonth()

必选项 dateObj 参数为 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的月份值,请使用 getUTCMonth 方法。

getMonth 方法返回一个处于 0 到 11 之间的整数,它代表 Date 对象中的月份值。这个整数并不等于按照

惯例来表示月份的数字,而是要比按惯例表示的值小 1。如果一个 Date 对象中保存的时间值是 "Jan 5,

1996 08:47:00",那么 getMonth 方法就会返回 0。

示例
下面这个例子说明了 getMonth 方法的用法:

function DateDemo(){
   var d, s = "今天日期是: ";
   d = new Date();
   s += (d.getMonth() + 1) + "/";
   s += d.getDate() + "/";
   s += d.getYear();
   return(s);
}

getSeconds 方法
返回 Date 对象中用本地时间表示的秒钟值。

dateObj.getSeconds()

必选项 dateObj 参数 Date 对象。

说明
要获取用全球标准时间 (UTC)表示的秒钟值,请使用 getUTCSeconds 方法。

getSeconds 方法返回一个处于 0 到 59 之间的整数,它表示了相应的 Date 对象中的秒钟值。在下面两种

情况下,返回值为 0。第一种情况是在当前的一分钟中所经过的时间少于一秒。另外一种情况是在创建 Date

对象时没有将时间值保存到该对象中。而为了确定究竟属于哪种情况,唯一的方法是同时检查小时和分钟值

是否也都是 0。如果这两个值都是 0,那就几乎可以确定是没有将时间值保存到 Date 对象中。

示例
下面这个例子说明了 getSeconds 方法的用法:

function TimeDemo(){
   var d, s = "当前本地时间为: ";
   var c = ":";
   d = new Date();
   s += d.getHours() + c;
   s += d.getMinutes() + c;
   s += d.getSeconds() + c;
   s += d.getMilliseconds();
   return(s);
}

返回 Date 对象中的时间值。

dateObj.getTime()

必选项 dateObj 参数为 Date 对象。

说明
getTime 方法返回一个整数值,这个整数代表了从 1970 年 1 月 1 日开始计算到 Date 对象中的时间之间

的毫秒数。日期的范围大约是 1970 年 1 月 1 日午夜的前后各 285,616 年。负数代表 1970 年之前的日期

在进行各种日期和时间换算的时候,可以定义一些变量来表示一天、一个小时或一分钟中包含的毫秒数。这

样做通常是很有帮助的。例如:

var MinMilli = 1000 * 60
var HrMilli = MinMilli * 60
var DyMilli = HrMilli * 24
示例
下面这个例子说明了 getTime 方法的用法:

function GetTimeTest(){
   var d, s, t;
   var MinMilli = 1000 * 60;
   var HrMilli = MinMilli * 60;
   var DyMilli = HrMilli * 24;
   d = new Date();
   t = d.getTime();
   s = "It's been "
   s += Math.round(t / DyMilli) + " days since 1/1/70";
   return(s);
}

getTimezoneOffset 方法
返回用分钟表示的主计算机上的时间和全球标准时间 (UTC)之间的差别。

dateObj.getTimezoneOffset()

必选项 dateObj 参数为 Date 对象。

说明
getTimezoneOffset 方法返回一个整数值,这个整数代表了当前计算机上的时间和 UTC 之间相差的分钟数。

这些值和执行脚本的计算机相关。如果这个方法被一个服务器脚本调用,那返回值和服务器相关。而如果这

个方法被一个客户机脚本调用,那么返回值就根据客户机上的时间来确定。

如果所在位置的时间落后于 UTC (比如, Pacific Daylight Time),那么这个值就是正值,而如果所在位置

的时间超前于 UTC (比如说, Japan),那么这个值就是负值。

例如,假设在 12 月 1 日,一台位于 Los Angeles 的客户机与一台位于 New York City 的服务器进行联络

。如果在客户机上执行,getTimezoneOffset 方法将返回 480,而如果在服务器上执行此方法将返回 300。

示例
下面这个例子说明了 getTimezoneOffset 方法的用法。

function TZDemo(){
   var d, tz, s = " The current local time is ";
   d = new Date();
   tz = d.getTimezoneOffset();
   if (tz < 0)
      s += tz / 60 + " hours before GMT";
   else if (tz == 0)
      s += "GMT";
   else
      s += tz / 60 + " hours after GMT";
   return(s);
}

getUTCDate 方法
返回 Date 对象中用全球标准时间 (UTC)表示的日期。

dateObj.getUTCDate()

必选项 dateObj 参数为 Date 对象。

说明
要获取用本地时间表示的日期,请使用 getDate 方法。

返回值是一个处于 1 到 31 之间的整数值,这个整数代表了 Date 对象中的日期值。

示例
下面这个例子说明了 getUTCDate 方法的用法。

function UTCDateDemo(){
   var d, s = "今天 UTC 日期是: ";
   d = new Date();
   s += (d.getUTCMonth() + 1) + "/";
   s += d.getUTCDate() + "/";
   s += d.getUTCFullYear();
   return(s);
}

getUTCDay 方法
返回 Date 对象中用全球标准时间 (UTC)表示的一周中的日期值。

dateObj.getUTCDay()

必选项 dateObj 参数为 Date 对象。

说明
要获取用本地时间表示的一周中的日期值,请使用 getDate 方法。

getUTCDay 方法的返回值是一个处于 0 到 6 之间的整数,它代表了一周中的某一天,返回值与一周中日期

的对应关系如下:

值 星期
0 星期天
1 星期一
2 星期二
3 星期三
4 星期四
5 星期五
6 星期六


示例
下面这个例子说明了 getUTCDay 方法的用法。

function DateDemo(){
   var d, day, x, s = "今天是";
   var x = new Array("星期日", "星期一", "星期二");
   x = x.concat("星期三","星期四", "星期五");
   x = x.concat("星期六");
   d = new Date();
   day = d.getUTCDay();
   return(s += x[day]);
}

getUTCFullYear 方法
返回 Date 对象中用全球标准时间 (UTC)表示的年份值。

dateObj.getUTCFullYear()

必选项 dateObj 参数 Date 对象。

说明
要获取用 本地时间表示的年份值,请使用 getFullYear 方法。

getUTCFullYear 方法以绝对数字的形式返回年份值。这样可以避免出现 2000 年问题,从而不会将 2000 年

1月1日以后的日期与 1900 年1月1日以后的日期混淆起来。

示例
下面这个例子说明了 getUTCFullYear 方法的用法。

function UTCDateDemo(){
   var d, s = "今天 UTC 日期是: ";
   d = new Date();
   s += (d.getUTCMonth() + 1) + "/";
   s += d.getUTCDate() + "/";
   s += d.getUTCFullYear();
   return(s);
}

getUTCHours 方法
返回 Date 对象中用全球标准时间 (UTC)表示的小时值。

dateObj.getUTCHours()

必选项 dateObj 参数为 Date 对象。

说明
要获取用本地时间表示的,从午夜开始已经过的小时数,请使用 getHours 方法。

getUTCHours 方法返回一个处于 0 到 23 之间的整数,这个整数代表了从午夜开始所经过的小时数。在下面

两种情况下返回值为 0:时间在 1:00:00 A.M. 之前或者在创建 Date 对象的时候没有将时间值保存到该对

象中。而要确定究竟属于哪种情况,唯一的办法就是同时检查分钟和秒钟值是否都是 0。如果这两个值都是

0,那么就几乎可以确定是没有将时间值保存到 Date 对象中。

示例
下面这个例子说明了 getUTCHours 方法的用法。

function UTCTimeDemo(){
   var d, s = "当前全球标准时间 (UTC) 是: ";
   var c = ":";
   d = new Date();
   s += d.getUTCHours() + c;
   s += d.getUTCMinutes() + c;
   s += d.getUTCSeconds() + c;
   s += d.getUTCMilliseconds();
   return(s);
}

getUTCMilliseconds 方法
返回 Date 对象中用全球标准时间 (UTC)表示的毫秒值。

dateObj.getUTCMilliseconds()

必选项 dateObj 参数为 Date 对象。

说明
要获取用本地时间表示的毫秒数,请使用 getMilliseconds 方法。

返回的毫秒值的范围是 0-999。

示例
下面这个例子说明了 getUTCMilliseconds 方法的用法。

function UTCTimeDemo(){
   var d, s = "当前全球标准时间 (UTC) 是: ";
   var c = ":";
   d = new Date();
   s += d.getUTCHours() + c;
   s += d.getUTCMinutes() + c;
   s += d.getUTCSeconds() + c;
   s += d.getUTCMilliseconds();
   return(s);
}

getUTCMinutes 方法
返回 Date 对象中用全球标准时间 (UTC)表示的分钟值。

dateObj.getUTCMinutes()

必选项 dateObj 参数为 Date 对象。

说明
要获得用本地时间表示的所保存的分钟数,请使用 getMinutes 方法。

getUTCMinutes 方法返回一个处于 0 到 59 之间的整数,这个整数就等于包含在 Date 对象中的分钟数的值

。在下列两种情况下返回值为 0:在整点过后的时间短于 1 分钟,或者在创建 Date 对象的时候没有将时间

值保存到对象之中。而要确定究竟属于哪种情况,唯一的方法就是同时检查小时和秒钟值是否都是 0。如果

这两个值都是 0,那么几乎可以肯定是没有将时间保存到 Date 对象中。

示例
下面这个例子说明了 getUTCMinutes 方法的用法。

function UTCTimeDemo()
{
   var d, s = "当前全球标准时间 (UTC) 是: ";
   var c = ":";
   d = new Date();
   s += d.getUTCHours() + c;
   s += d.getUTCMinutes() + c;
   s += d.getUTCSeconds() + c;
   s += d.getUTCMilliseconds();
   return(s);
}

getUTCMonth 方法
返回 Date 对象中用全球标准时间 (UTC)表示的月份值。

dateObj.getUTCMonth()

必选项 dateObj 参数为 Date 对象。

说明
要获得用本地时间表示的月份,请使用 getMonth 方法。

getUTCMonth 方法返回一个处于 0 到 11 之间的整数,这个整数就表示 Date 对象中的月份值。所返回值并

不等于按惯例来表示月份的数字。而是要比按惯例来表示月份的数字小 1。如果一个 Date 对象中保存的值

是"Jan 5, 1996 08:47:00.0",那么 getUTCMonth 将返回 0。

示例
下面这个例子说明了 getUTCMonth 方法的用法。

function UTCDateDemo(){
   var d, s = "今天 UTC 日期是: ";
   d = new Date();
   s += (d.getUTCMonth() + 1) + "/";
   s += d.getUTCDate() + "/";
   s += d.getUTCFullYear();
   return(s);
}

getUTCSeconds 方法
返回 Date 对象中用全球标准时间 (UTC)表示的秒钟值。

dateObj.getUTCSeconds()

必选项 dateObj 参数为 Date 对象。

说明
要获得用本地时间表示的秒钟数,请使用 getSeconds 方法。

getUTCSeconds 方法返回一个处于 0 到 59 之间的整数,这个整数表示相应的 Date 对象中的秒钟数。在下

面两种情况下返回值为 0:在当前的一分钟中所经过的时间短于 1 秒钟,或者在创建 Date 对象的时候没有

将时间保存到该对象中。而为了确定究竟属于哪种情况,唯一的方法就是同时检查分钟和小时值是否为 0。

如果这两个值也都是 0,那么几乎可以确定是没有将时间保存到 Date 对象中。

示例
下面这个例子说明了 getUTCSeconds 方法的用法。

function UTCTimeDemo(){
   var d, s = "当前 UTC 时间为: ";
   var c = ":";
   d = new Date();
   s += d.getUTCHours() + c;
   s += d.getUTCMinutes() + c;
   s += d.getUTCSeconds() + c;
   s += d.getUTCMilliseconds();
   return(s);
}

getVarDate 方法
返回 Date 对象中的 VT_DATE 值。

dateObj.getVarDate()

必选项 dateObj 参数为 Date 对象。

说明
当与COM 对象、ActiveX(R) 对象或其他以 VT_DATE 格式接受和返回日期值的对象(例如Visual Basic 和

VBScript)进行交互时,使用 getVarDate 方法。实际格式取决于地区设置,不随 JScript 变化。


getYear 方法
返回 Date 对象中的年份值。

dateObj.getYear()

必选项 dateObj 参数为 Date 对象。

说明
这个方法已经过时,之所以提供这个方法,是为了保持向后的兼容性。请改用 getFullYear 方法。

对于1900-1999这段时间而言,返回的年份值是一个两位数字的整数,它代表了所保存的年份与 1900 年之间

的差距。而对于其它的年份,返回值是一个四位的整数。例如,1996 年的返回值是 96,而 1825 和 2025

年的返回值则相应地为 1825 和 2025。

注意 对于 JScript 1.0 版,getYear 返回的值始终为 Date 对象中的年份与 1900 年之间的差距。例

如,1899 年的返回值是 -1, 而 2000 年的返回值是 100。

示例
下面这个例子说明了 getYear 方法的用法。

function DateDemo(){
   var d, s = "今天日期是: ";
   d = new Date();
   s += (d.getMonth() + 1) + "/";
   s += d.getDate() + "/";
   s += d.getYear();
   return(s);
}

setDate 方法
设置 Date 对象中用本地时间表示的数字日期。

dateObj.setDate(numDate)

参数
dateObj

必选项。任意 Date 对象。

numDate

必选项。是一个等于数字日期的数值。

说明
要设置用全球标准时间 (UTC)表示的日期值,请使用 setUTCDate 方法。

如果 numDate 的值大于 Date 对象中所保存的月份的天数或者是负数。那么日期将被设置为由 numDate 减

去所保存月份中天数而得到的日期。例如,如果所保存的日期是 1996 年 1 月 5 日,并且调用了方法

setUTCDate(32),那么日期将被改变为 1996 年 2 月 1 日。负数的处理方法与此相似。

示例
下面这个例子说明了 setDate 方法的用法。

function SetDateDemo(newdate){
   var d, s;                  // 声明变量。
   d = new Date();            // 创建 date 对象。
   d.setDate(newdate);        // 设置 date 为 newdate。
   s = "Current setting is ";
   s += d.toLocaleString();
   return(s);                 // 返回新设的日期。
}

setFullYear 方法
设置 Date 对象中用本地时间表示的年份值。

dateObj.setFullYear(numYear[, numMonth[, numDate]])

参数
dateObj

必选项。任意 Date 对象。

numYear

必选项。一个等于年份的数值。

numMonth

可选项。一个等于月份的数值。如果提供了 numDate,那么此项也必须提供。

numDate

可选项。一个等于日期的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMonth 参数是可选的,但是没有被指定,JScript 将使用从 getMonth 方法返回的

值作为该参数的值。

此外,如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。

要设置用全球标准时间 (UTC)表示的年份,请使用 setUTCFullYear 方法。

Date 对象中所支持的年份的范围大约是 1970 年的前后各 285,616 年。

示例
下面这个例子说明了 setFullYear 方法的用法。

function SetFullYearDemo(newyear){
   var d, s;                 // 声明变量。
   d = new Date();           // 创建 Date 对象。
   d.setFullYear(newyear);   // 设置年份。
   s = "Current setting is ";
   s += d.toLocaleString();
   return(s);                // 返回新的日期设置。
}

setHours 方法
设置 Date 对象中用本地时间表示的小时值。

dateObj.setHours(numHours[, numMin[, numSec[, numMilli]]])

参数
dateObj

必选项。任意 Date 对象。

numHours

必选项。一个等于小时值的数值。

numMin

可选项。一个等于分钟值的数值。如果使用了下面的参数,那么此参数也必须提供。

numSec

可选项。一个等于秒钟值的数值。如果使用了下面的参数,那么此参数也必须提供。

numMilli

可选项。一个等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMinutes 参数是可选的,但是没有被指定,JScript 将使用从 getMinutes 方法返

回的值作为该参数的值。

要设置用全球标准时间 (UTC)表示的小时值,请使用 setUTCHours 方法。

此外,如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。例如,如果所保存的

日期是 "Jan 5, 1996 00:00:00",且调用了 setHours(30) 方法,那么日期将被改变为 "Jan 6, 1996

06:00:00." 负数的处理方法与此相似。

示例
下面这个例子说明了 setHours 方法的用法。

function SetHoursDemo(nhr, nmin, nsec){
   var d, s;                     // 声明变量。
   d = new Date();               // 创建 Date 对象。
   d.setHours(nhr, nmin, nsec);  // 设置小时,分钟,秒。
   s = "Current setting is " + d.toLocaleString()
   return(s);                    // 返回新的日期设置。
}

setMilliseconds 方法
设置 Date 对象中用本地时间表示的毫秒值。

dateObj.setMilliseconds(numMilli)

参数
dateObj

必选项。任意 Date 对象。

numMilli

必选项。是一个等于毫秒值的数值。

说明
要设置用全球标准时间 (UTC)表示的毫秒值,请使用 setUTCMilliseconds 方法。

如果 numMilli 的值大于 999 或者是负数,所保存的秒钟数 (以及分钟,小时,等等,如果需要的话) 将增

加适当的数量。

示例
下面这个例子说明了 setMilliseconds 方法的用法:

function SetMSecDemo(nmsec){
   var d, s;                    // 声明变量。
   var sep = ":";               // 初始化分隔符。
   d = new Date();              // 创建 Date 对象。
   d.setMilliseconds(nmsec);    // 设置毫秒数。
   s = "Current setting is ";
   s += d.toLocaleString() + sep + d.getMilliseconds();
   return(s);                   // 返回新的日期设置。
}

setMinutes 方法
设置 Date 对象中用 本地时间表示的分钟值。

dateObj.setMinutes(numMinutes[, numSeconds[, numMilli]])

参数
dateObj

必选项。任意 Date 对象。

numMinutes

必选项。一个等于分钟值的数值。

numSeconds

可选项。一个等于秒钟值的数值。如果使用了 numMilli 参数,那么必须提供此参数。

numMilli

可选项。一个等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numSeconds 参数是可选的,但是没有被指定,JScript 将使用从 getSeconds 方法返

回的值作为该参数的值。

要设置用全球标准时间 (UTC)表示的分钟值,请使用 setUTCMinutes 方法。

如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。例如,如果所保存的日期是

"Jan 5, 1996 00:00:00",且调用了 setMinutes(90) 方法,那么日期将被改变为 "Jan 5, 1996 01:30:00"

负数的处理方法与此相似。

示例
下面这个例子说明了 setMinutes 方法的用法。

function SetMinutesDemo(nmin, nsec){
   var d, s;                     // 声明变量。
   d = new Date();               // 创建 Date 对象。
   d.setMinutes(nmin, nsec);     // 设置分钟。
   s = "Current setting is " + d.toLocaleString()
   return(s);                    // 返回新的设置。
}

setMonth 方法
设置 Date 对象中用 本地时间表示的月份值。

dateObj.setMonth(numMonth[, dateVal])

参数
dateObj

必选项。任意 Date 对象。

numMonth

必选项。一个等于月份值的数值。

dateVal

可选项。一个代表日期的数值。如果没有提供此参数,那么将使用通过调用 getDate 方法而得到的数值。

说明
要设置用全球标准时间 (UTC)表示的月份值,请使用 setUTCMonth 方法。

如果 numMonth 的值大于 11 (月份 0 表示一月)或者是一个负数,那么所保存的年份将相应地得到改变。例

如,如果所保存的日期是 "Jan 5, 1996" 并且调用了 setMonth(14) 方法,那么该日期就被改变为 "Mar 5,

1997."

示例
下面这个例子说明了 setMonth 方法的用法。

function SetMonthDemo(newmonth){
   var d, s;               // 声明变量。
   d = new Date();         // 创建 Date 对象
   d.setMonth(newmonth);   // 设置月份。
   s = "Current setting is ";
   s += d.toLocaleString();
   return(s);              //返回新的设置。
}

setSeconds 方法
设置 Date 对象中用 本地时间表示的秒钟值。

dateObj.setSeconds(numSeconds[, numMilli])

参数
dateObj

必选项。任意 Date 对象。

numSeconds

必选项。等于秒钟值的数值。

numMilli

可选项。等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMilli 参数是可选的,但是没有被指定,JScript 将使用从 getMilliseconds 方法

返回的值作为该参数的值。

要设置用全球标准时间 (UTC)表示的秒钟值,请使用 setUTCSeconds 方法。

如果一个参数的值超出了其取值范围或者是一个负数,其他保存的值将相应地得到修改。例如如果所保存的

日期是 "Jan 5, 1996 00:00:00" 而且调用了函数 setSeconds(150),日期将被改变为 "Jan 5, 1996

00:02:30."

示例
下面这个例子说明了 setSeconds 方法的用法:

function SetSecondsDemo(nsec, nmsec){
   var d, s;                   // 声明变量。
   var sep = ":";
   d = new Date();             // 创建 Date 对象。
   d.setSeconds(nsec, nmsec);  // 设置秒和毫秒。
   s = "Current setting is ";
   s += d.toLocaleString() + sep + d.getMilliseconds();
   return(s);                  // 返回新的设置。
}

setTime 方法
设置 Date 对象的日期和时间值。

dateObj.setTime(milliseconds)

参数
dateObj

必选项。任意 Date 对象。

milliseconds

必选项。是一个整数值,它代表从格林威治标准时间(GMT)的 1970 年 1 月 1 日午夜开始所经过的毫秒数

说明
如果 milliseconds 是一个负值,那它就表示 1970 年之前的日期。可用的日期范围大约是 1970 年 1 月 1

日午夜的前后各 285,616 年。

使用 setTime 方法来设置日期和时间与时区无关。

示例
下面这个例子说明了 setTime 方法的用法。

function SetTimeTest(newtime){
   var d, s;                  // 声明变量。
   d = new Date();            // 创建 Date 对象。
   d.setTime(newtime);        // 设置时间。
   s = "Current setting is ";
   s += d.toUTCString();
   return(s);                 // 返回新的设置。
}

setUTCDate 方法
设置 Date 对象中用全球标准时间 (UTC)表示的数值日期。

dateObj.setUTCDate(numDate)

参数
dateObj

必选项。任意 Date 对象。

numDate

必选项。是一个与数值日期相等的数值。

说明
要设置用本地时间表示的日期,请使用 setDate 方法。

如果 numDate 的值超出 Date 对象中所保存的月份中的天数或者该值是负数。那么日期将被设置为由

numDate 减去所保存月份中天数而得到的日期。例如,如果所保存的日期是 1996 年 1 月 5 日,并且调用

了方法 setUTCDate(32),那么日期将被改变为 1996 年 2 月 1 日。负数的处理方法与此相似。

示例
下面这个例子说明了 setUTCDate 方法的用法。

function SetUTCDateDemo(newdate){
   var d, s;                   // 声明变量。
   d = new Date();             // 创建 Date 对象。
   d.setUTCDate(newdate);      // 设置 UTC 日期。
   s = "Current setting is ";
   s += d.toUTCString();
   return(s);                  // 返回新的设置。
}

setUTCFullYear 方法
设置 Date 对象中用全球标准时间 (UTC)表示的年份值。

dateObj.setUTCFullYear(numYear[, numMonth[, numDate]])

参数
dateObj

必选项。任意 Date 对象。

numYear

必选项。一个等于年份的数值。

numMonth

可选项。一个等于月份的数值。如果提供了 numDate,那么也必须提供此项。

numDate

可选项。一个等于日期的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMonth 参数是可选的,但是没有被指定,JScript 将使用从 getUTCMonth 方法返回

的值作为该参数的值。

此外,如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。

要设置用本地时间表示的年份,请使用 setFullYear 方法。

Date 对象中所支持的年份范围大约是 1970 年前后各 285,616 年。

示例
下面这个例子说明了 setUTCFullYear 方法的用法。

function SetUTCFullYearDemo(newyear){
   var d, s;                   // 声明变量。
   d = new Date();             // 创建 Date 对象。
   d.setUTCFullYear(newyear);  // 设置 UTC 完整年份。
   s = "Current setting is ";
   s += d.toUTCString();
   return(s);                  //返回新设置。
}

setUTCHours 方法
设置 Date 对象中用全球标准时间 (UTC)表示的小时值。

dateObj.setUTCHours(numHours[, numMin[, numSec[, numMilli]]])

参数
dateObj

必选项。任意 Date 对象。

numHours

必选项。等于小时值的数值。

numMin

可选项。等于分钟值的数值,如果使用了 numSec 或numMilli,那么此参数也必须提供。

numSec

可选项。等于秒钟值的数值。如果使用了 numMilli 参数,那么此参数也必须提供。

numMilli

可选项。等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMin 参数是可选的,但是没有被指定,JScript 将使用从 getUTCMinutes 方法返回

的值作为该参数的值。

要设置用本地时间表示的小时值,请使用 setHours 方法。

如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。例如,如果所保存的日期是

"Jan 5, 1996 00:00:00",且调用了 setHours(30) 方法,那么日期将被改变为 "Jan 6, 1996 06:00:00."

示例
下面这个例子说明了 setUTCHours 方法的用法。

function SetUTCHoursDemo(nhr, nmin, nsec){  
   var d, s;                        // 声明变量。
   d = new Date();                  // 创建 Date 对象。
   d.setUTCHours(nhr, nmin, nsec);  // 设置 UTC 小时,分钟,秒。
   s = "Current setting is " + d.toUTCString()
   return(s);                       // 返回新设置。
}

setUTCMilliseconds 方法
设置 Date 对象中用全球标准时间 (UTC)表示的毫秒值。

dateObj.setUTCMilliseconds(numMilli)

参数
dateObj

必选项。任意 Date 对象。

numMilli

必选项。是一个等于毫秒值的数值。

说明
要设置用 本地时间表示的毫秒值,请使用 setMilliseconds 方法。

如果 numMilli 的值大于 999 或者是负数,那么秒钟数(以及分钟、小时等等,如果需要的话)将增加一个

适当的数量。

示例
下面这个例子说明了 setUTCMilliseconds 方法的用法:

function SetUTCMSecDemo(nmsec){  
   var d, s;                           // 声明变量。
   var sep = ":";                      // 初始化分隔符。
   d = new Date();                     // 创建 Date 对象。
   d.setUTCMilliseconds(nmsec);        // 设置 UTC 毫秒。
   s = "Current setting is ";
   s += d.toUTCString() + sep + d.getUTCMilliseconds();
   return(s);                          // 返回新设置。
}

setUTCMinutes 方法
设置 Date 对象中用全球标准时间 (UTC)表示的分钟值。

dateObj.setUTCMinutes(numMinutes[, numSeconds[, numMilli]])

参数
dateObj

必选项。任意 Date 对象。

numMinutes

必选项。等于分钟值的数值。

numSeconds

可选项。等于秒钟值的数值。如果使用了 numMilli 参数,那么此参数也必须提供。

numMilli

可选项。等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numSeconds 参数是可选的,但是没有被指定,JScript 将使用从 getUTCSeconds 方法

返回的值作为该参数的值。

要将分钟值修改为用本地时间表示的形式,请使用 setMinutes 方法。

如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。例如,如果所保存的日期是

"Jan 5, 1996 00:00:00",且调用了setUTCMinutes(70)方法,那么日期将被改变为 "Jan 5, 1996

01:10:00.00."

示例
下面这个例子说明了 setUTCMinutes 方法的用法。

function SetUTCMinutesDemo(nmin, nsec){
   var d, s;                    // 声明变量。
   d = new Date();              // 创建 Date 对象。
   d.setUTCMinutes(nmin,nsec);  // 设置 UTC 分钟。
   s = "Current setting is " + d.toUTCString()
   return(s);                   // 返回新设置。
}

setUTCMonth 方法
设置 Date 对象中用 全球标准时间 (UTC)表示的月份值。

dateObj.setUTCMonth(numMonth[, dateVal])

参数
dateObj

必选项。任意 Date 对象。

numMonth

必选项。一个等于月份的数值。

dateVal

可选项。代表日期的数值。如果没有提供此参数,那么将使用通过调用 getUTCDate 方法而得到的数值。

说明
要设置用 本地时间表示的月份值,请使用 setMonth 方法。

如果 numMonth 的值大于 11(月份 0 代表一月)或者是负数,那么所保存的年份也将相应地得到增加或减少

。例如,如果所保存的日期是 "Jan 5, 1996 00:00:00.00",而且调用了 setUTCMonth(14) 方法,那么日期

将被改变为 "Mar 5, 1997 00:00:00.00."

示例
下面这个例子说明了 setUTCMonth 方法的用法。

function SetUTCMonthDemo(newmonth){
   var d, s;                       // 声明变量。
   d = new Date();                 // 创建 Date 对象。
   d.setUTCMonth(newmonth);        // 设置 UTC 月份。
   s = "Current setting is ";
   s += d.toUTCString();
   return(s);                      // 返回新设置。
}

setUTCSeconds 方法
设置 Date 对象中用全球标准时间 (UTC)表示的秒值。

dateObj.setUTCSeconds(numSeconds[, numMilli])

参数
dateObj

必选项。任意 Date 对象。

numSeconds

必选项。等于秒值的数值。

numMilli

可选项。等于毫秒值的数值。

说明
如果没有指定可选项,那么所有使用可选项的 set 方法都将使用从相应的 get 方法返回的数值作为可选项

的数值。例如,如果 numMilli 参数是可选的,但是没有被指定,JScript 将使用从 getUTCMilliseconds

方法返回的值作为该参数的值。

要设置用本地时间表示的秒钟值,请使用 setSeconds 方法。

如果参数的的值超出其范围或者是负数,其他被保存的值都将相应地得到修改。例如,如果所保存的日期是

"Jan 5, 1996 00:00:00",且调用了 setSeconds(150) 方法,那么日期将被改变为 "Jan 5, 1996

00:02:30.00."

示例
下面这个例子说明了 setSeconds 方法的用法。

function SetUTCSecondsDemo(nsec, nmsec){
   var d, s;                       // 声明变量。
   d = new Date();                 // 创建 Date 对象。
   d.setUTCSeconds(nsec, nmsec);   // 设置 UTC 秒和毫秒。
   s = "Current UTC milliseconds setting is ";
   s += d.getUTCMilliseconds();    // 获取新设置。
   return(s);                      // 返回新设置。
}

setYear 方法
设置 Date 对象中的年份值。

dateObj.setYear(numYear)

参数
dateObj

必选项。任意 Date 对象。

numYear

必选项。其数值等于年份减去 1900。

说明
这个方法已经过时,之所以仍然保留,只是为了保持向后兼容性。请改用 setFullYear 方法。

要将 Date 对象的年份设置为 1997,请调用 setYear(97)。而要将年份设置为 2010,请调用

setYear(2010)。最后,要将年份设置为 0-99 范围内的一年,请使用 setFullYear 方法。

注意 对于 JScript 1.0 版, setYear 设置的值始终为 numYear 参数的值加上 1900。例如,要将年份设置

为 1899,numYear 参数的值是 -1,而要将年份设置为 2000,numYear 参数的值是 100。


toGMTString 方法
返回一个日期,该日期用格林威治标准时间 (GMT) 表示并已被转换为字符串。

dateObj.toGMTString()

说明
toGMTString 方法已经过时,之所以仍然提供这个方法,只是为了提供向后的兼容性。推荐改用

toUTCString 方法。

toGMTString 方法返回一个 String 对象,此对象中包含了按照 GMT 惯例进行格式化的日期。返回值的格式

如下:"05 Jan 1996 00:00:00 GMT"。


toLocaleString 方法
返回一个日期,该日期使用当前区域设置并已被转换为字符串。

dateObj.toLocaleString()

必选项 dateObj 为任意的 Date 对象。

说明
toLocaleString 方法返回一个 String 对象,这个对象中包含了用当前区域设置的默认格式表示的日期。

对于公元 1601 和 1999 之间的时间,日期格式要按照用户的“控制面板”中“区域设置”来确定。
F对于此区间外的其他时间,使用 toString 方法的默认格式。
例如,同样是 1 月 5 日,在美国,toLocaleString 可能会返回 "01/05/96 00:00:00",而在欧洲,返回值

则可能是 "05/01/96 00:00:00",因为欧洲的惯例是将日期放在月份前面。

注意 toLocaleString 只用来显示结果给用户;不要在脚本中用来做基本计算,因为返回的结果是随机器不

同而不同的。

示例
下面这个例子说明了 toLocaleString 方法的用法。

   var d, s;                      // 声明变量。
   d = new Date();                // 创建 Date 对象。
   s = "Current setting is ";
   s += d.toLocaleString();       // 转换为当前区域。
   return(s);                     // 返回转换的日期。
}

toUTCString 方法
返回一个已被转换为字符串的,用全球标准时间 (UTC)表示的日期。

dateObj.toUTCString()

必选项 dateObj 参数为任意 Date 对象。

说明
toUTCString 方法返回一个 String 对象,此对象中包含了使用 UTC 惯例以一种方便易读的形式进行格式化

的日期。

示例
下面这个例子说明了 toUTCString 方法的用法。

function toUTCStrDemo(){
   var d, s;                   // 声明变量。
   d = new Date();             // 创建 Date 对象。
   s = "Current setting is ";
   s += d.toUTCString();       // 转换为 UTC 字符串。
   return(s);                  // 返回 UTC 字符串。
}

toString 方法
返回对象的字符串表示。

valueOf 方法
返回指定对象的原始值。

parse 方法
解析一个包含日期的字符串,并返回该日期与 1970 年 1 月 1 日午夜之间所间隔的毫秒数。

Date.parse(dateVal)

其中必选项 dateVal 是一个包含以诸如 "Jan 5, 1996 08:47:00" 的格式表示的日期的字符串,或者是一个

从 ActiveX(R) 对象或其他对象中获取的 VT_DATE 值。

说明
parse 方法返回一个整数值,这个整数表示 dateVal 中所包含的日期与 1970 年 1 月 1 日午夜之间相间隔

的毫秒数。

parse 方法是 Date 对象的一个静态方法。正因为它是一个静态方法,它是通过下面例子中所示的方法被调

用的,而不是作为一个已创建 Date 对象的一个方法被调用。

var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)
下面这些规则决定了 parse 方法能够成功地解析那些字符串:

短日期可以使用“/”或“-”作为日期分隔符,但是必须用月/日/年的格式来表示,例如"7/20/96"。
以 "July 10 1995" 形式表示的长日期中的年、月、日可以按任何顺序排列,年份值可以用 2 位数字表示也

可以用 4 位数字表示。如果使用 2 位数字来表示年份,那么该年份必须大于或等于 70。
括号中的任何文本都被视为注释。这些括号可以嵌套使用。
逗号和空格被视为分隔符。允许使用多个分隔符。
月和日的名称必须具有两个或两个以上的字符。如果两个字符所组成的名称不是独一无二的,那么该名称就

被解析成最后一个符合条件的月或日。例如,"Ju" 被解释为七月而不是六月。
在所提供的日期中,如果所指定的星期几的值与按照该日期中剩余部分所确定的星期几的值不符合,那么该

指定值就会被忽略。例如,尽管 1996 年 11 月 9 日实际上是星期五,"Tuesday November 9 1996" 也还是

可以被接受并进行解析的。但是结果 Date 对象中包含的是 "Friday November 9 1996"。
JScript 处理所有的标准时区,以及全球标准时间 (UTC) 和格林威治标准时间 (GMT)。
小时、分钟、和秒钟之间用冒号分隔,尽管不是这三项都需要指明。"10:"、"10:11"、和 "10:11:12" 都是

有效的。
如果使用 24 小时计时的时钟,那么为中午 12 点之后的时间指定 "PM" 是错误的。例如 "23:15 PM" 就是

错误的。
包含无效日期的字符串是错误的。例如,一个包含有两个年份或两个月份的字符串就是错误的。
示例
下面这个例子说明了 parse 方法的用法:

function GetTimeTest(testdate){
   var s, t;                    // 声明变量。
   var MinMilli = 1000 * 60;       // 初始化变量。
   var HrMilli = MinMilli * 60;
   var DyMilli = HrMilli * 24;
   t = Date.parse(testdate);       // 解析 testdate。
   s = "There are "                // 创建返回的字符串。
   s += Math.round(Math.abs(t / DyMilli)) + " days "
   s += "between " + testdate + " and 1/1/70";
   return(s);                      // 返回结果。
}

UTC 方法
返回全球标准时间 (UTC) (或 GMT) 的 1970 年 1 月 1 日到所指定日期之间所间隔的毫秒数。

Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]])

参数
year

必选项。为了获得跨世纪日期处理的精确性,需要使用完整的年份表示法。如果 year 处于 0 到 99 之间,

那么 year 就被假定为 1900 + year。

month

必选项。月份是一个处于 0 到 11 之间的整数 (一月到十二月)。

day

必选项。日期是一个处于 1 到 31 之间的整数。

hours

可选项。如果提供了 minutes,那么此项也必须提供。0 到 23 之间的一个整数 (午夜到 11pm),用来指定

小时。

minutes

可选的,如果提供了 seconds,那么此项也必须提供。 0 到 59 之间的一个整数,用来指定分钟值。

seconds

可选项。如果提供了 milliseconds,那么此项也必须提供。从 0 到 59 之间的一个整数,用来指定秒钟值

ms

可选项。从 0 到 999 之间的一个整数,用来指定毫秒数。

说明
UTC 方法返回从 UTC 的 1970 年 1 月 1 日午夜到所指定日期之间的毫秒数。这个返回值可以用在 setTime

方法中和 Date 对象的构造函数中。如果一个参数的值超出其范围或者是一个负数,那么其他保存过的值将

相应地得到改变。例如,如果使用者指定 150 秒,JScript 会将该数值重新定义为 2 分钟 30 秒。

UTC 方法和 Date 对象的接受日期值的构造函数之间的差别在于: UTC 方法假设 UTC,而 Date 对象的构造

函数假定本地时间。

UTC 方法是一个静态方法。因此,Date 对象不一定要在创建完之后才可以使用。

注意   如果 year 处于 0 到 99 之间,年份为 1900 + year 。

示例
下面这个例子说明了 UTC 方法的用法:

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            // 声明变量。
   var MinMilli = 1000 * 60         // 初始化变量。
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    // 获取从 1/1/1970 开始的毫秒数。
   d = new Date();                  // 创建 Date 对象。
   t2 = d.getTime();                // 获取当前时间。
   if (t2 >= t1)
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       // 返回差。
}

转载于:https://www.cnblogs.com/tishifu/archive/2007/08/05/843768.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值