| Defined In: | Date.js |
| Class: | Date |
| Extends: | Object |
样本数据: 'Wed Jan 10 2007 15:05:01 GMT-0600 (中区标准时间)' 格式符 输出 说明 ------ ---------- -------------------------------------------------------------- d 10 月份中的天数,两位数字,不足位补“0” D Wed 当前星期的缩写,三个字母 j 10 月份中的天数,不补“0” l Wednesday 当前星期的完整拼写 S th 英语中月份天数的序数词的后缀,2个字符(与格式符“j”连用) w 3 一周之中的天数(1~7) z 9 一年之中的天数(0~365) W 01 一年之中的周数,两位数字(00~52) F January 当前月份的完整拼写 m 01 当前的月份,两位数字,不足位补“0” M Jan 当前月份的完整拼写,三个字母 n 1 当前的月份,不补“0” t 31 当前月份的总天数 L 0 是否闰年(“1”为闰年,“0”为平年) Y 2007 4位数字表示的当前年数 y 07 2位数字表示的当前年数 a pm 小写的“am”和“pm” A PM 大写的“am”和“pm” g 3 12小时制表示的当前小时数,不补“0” G 15 24小时制表示的当前小时数,不补“0” h 03 12小时制表示的当前小时数,不足位补“0” H 15 24小时制表示的当前小时数,不足位补“0” i 05 不足位补“0”的分钟数 s 01 不足位补“0”的秒数 O -0600 用小时数表示的与 GMT 差异数 T CST 当前系统设定的时区 Z -21600 用秒数表示的时区偏移量(西方为负数,东方为正数)用法举例:(注意你必须在字母前使用转意字符“\\”才能将其作为字母本身而不是格式符输出):
var dt = new Date('1/10/2007 03:05:01 PM GMT-0600');
document.write(dt.format('Y-m-d')); //2007-01-10
document.write(dt.format('F j, Y, g:i a')); //January 10, 2007, 3:05 pm
document.write(dt.format('l, \\t\\he dS of F Y h:i:s A')); //Wednesday, the 10th of January 2007 03:05:01 PM
下面有一些标准的日期/时间模板可能会对你有用。它们不是 Date.js 的一部分,但是你可以将下列代码拷出,并放在 Date.js 之后所引用的任何脚本内,都将成为一个全局变量,并对所有的 Date 对象起作用。你可以按照你的需要随意增加、删除此段代码。
Date.patterns = {
ISO8601Long:"Y-m-d H:i:s",
ISO8601Short:"Y-m-d",
ShortDate: "n/j/Y",
LongDate: "l, F d, Y",
FullDateTime: "l, F d, Y g:i:s A",
MonthDay: "F d",
ShortTime: "g:i A",
LongTime: "g:i:s A",
SortableDateTime: "Y-m-d\\TH:i:s",
UniversalSortableDateTime: "Y-m-d H:i:sO",
YearMonth: "F, Y"
};
用法举例:
var dt = new Date();
document.write(dt.format(Date.patterns.ShortDate));
| 方法 | 定义者 | |
|---|---|---|
|
format
(
)
: String
根据指定的格式将对象格式化。 @param {String} 格式符...
根据指定的格式将对象格式化。 @param {String} 格式符 @return {String} 格式化后的日期对象 @method
参数项:
|
Date | |
parseDate
(
String input,
String format
)
: Date
将输入的字串按照指定的格式转换为日期对象。 请注意此函数接受的是普通...
将输入的字串按照指定的格式转换为日期对象。 请注意此函数接受的是普通的日历格式,这意味着月份由1开始(1 = 1月)而不是像 JS 的日期对象那样由0开始。 任何没有指定的日期部分将默认为当前日期中对应的部分。 时间部分也是可以指定的,默认值为 0. 一定要注意输入的日期字串必须与指定的格式化字串相符,否则处理操作将会失败。 用法举例:
@param {String} input 输入的日期字串 @param {String} format 转换格式符 @return {Date} 转换后的日期对象
参数项:
|
Date | |
|
getTimezone
(
)
: String
返回当前所在时区的缩写(等同于指定输出格式“T”)。 @return...
返回当前所在时区的缩写(等同于指定输出格式“T”)。 @return {String} 时区缩写(例如:“CST”)
参数项:
|
Date | |
|
getGMTOffset
(
)
: String
返回 GMT 到当前日期的偏移量(等同于指定输出格式“O”)。 @r...
返回 GMT 到当前日期的偏移量(等同于指定输出格式“O”)。 @return {String} 以“+”或“-”加上4位字符表示的偏移量(例如:“-0600”)
参数项:
|
Date | |
|
getDayOfYear
(
)
: Number
返回当前年份中天数的数值,已经根据闰年调整过。 @return {N...
返回当前年份中天数的数值,已经根据闰年调整过。 @return {Number} 0 到 365(闰年时为 366)
参数项:
|
Date | |
|
getWeekOfYear
(
)
: String
返回当前的星期数(等同于指定输出格式“W”)。 @return {S...
返回当前的星期数(等同于指定输出格式“W”)。 @return {String} “00”~“52”
参数项:
|
Date | |
|
isLeapYear
(
)
: Boolean
返回当前日期是否闰年。 @return {Boolean} 闰年为“...
返回当前日期是否闰年。 @return {Boolean} 闰年为“true”,平年为“false”
参数项:
|
Date | |
|
getFirstDayOfMonth
(
)
: Number
返回当前月份第一天的数值,已经根据闰年调整过。 返回值为以数字表示的...
返回当前月份第一天的数值,已经根据闰年调整过。 返回值为以数字表示的一周中的第几天(0~6) 可以与数组 dayNames (译者注:此处原文为“#monthNames”。)一起使用来表示当天的星期。 例子:
@return {Number} 一周中的天数(0~6)
参数项:
|
Date | |
|
getLastDayOfMonth
(
)
: Number
返回当前月份最后一天的数值,已经根据闰年调整过。 返回值为以数字表示...
返回当前月份最后一天的数值,已经根据闰年调整过。 返回值为以数字表示的一周中的第几天(0~6) 可以与数组 dayNames (译者注:此处原文为“{@link #monthNames}”。)一起使用来表示当天的星期。 例子:
@return {Number} 一周中的天数(0~6)
参数项:
|
Date | |
|
getFirstDateOfMonth
(
)
: Date
返回当前月份第一天的日期对象。 @return {Date}
返回当前月份第一天的日期对象。 @return {Date}
参数项:
|
Date | |
|
getLastDateOfMonth
(
)
: Date
返回当前月份中最后一天的日期对象。 @return {Date}
返回当前月份中最后一天的日期对象。 @return {Date}
参数项:
|
Date | |
|
getDaysInMonth
(
)
: Number
返回当前月份中天数的数值,已经根据闰年调整过。 @return {N...
返回当前月份中天数的数值,已经根据闰年调整过。 @return {Number} 月份中的天数
参数项:
|
Date | |
|
getSuffix
(
)
: String
返回当天的英文单词的后缀(等同于指定输出格式“S”)。 @retur...
返回当天的英文单词的后缀(等同于指定输出格式“S”)。 @return {String} 'st, 'nd', 'rd' or 'th'
参数项:
|
Date | |
|
clone
(
)
: Date
创建并返回一个新的与原来一模一样的日期实例。 新的实例通过地址复制,...
创建并返回一个新的与原来一模一样的日期实例。 新的实例通过地址复制,因此新的实例的变量发生改变后,原来的实例的变量也会随之改变。 当你想要创建一个新的变量而又不希望对原始实例产生影响时,你应该复制一个原始的实例。 正确复制一个日期实例的例子:
@return {Date} 新的日期实例
参数项:
|
Date | |
|
clearTime
(
)
: Date
清除日期对象中的所有时间信息。
@param {Boolean} ...
清除日期对象中的所有时间信息。
@param {Boolean} 值为“true”时复制一个当前日期实例,清除时间信息后返回。
@return {Date} 实例本身或复制的实例
参数项:
|
Date | |
add
(
String interval,
Number value
)
: Date
一个便利的日期运算的方法。 这个方法不会改变日期实例本身,而是返回一...
一个便利的日期运算的方法。 这个方法不会改变日期实例本身,而是返回一个以运算结果创建的日期对象新实例。 例如:
@param {String} interval 一个合法的日期间隔常数 @param {Number} value 修改的数值 @return {Date} 新的日期对象实例
参数项:
|
Date | |
getElapsed
(
[Date date]
)
: Number
返回date对象创建时间与现在时间的时间差,单位为毫秒 (译注:)例...
返回date对象创建时间与现在时间的时间差,单位为毫秒 (译注:)例:var date = new Date(); var x=0; while(x<2){ alert('x'); x++; } var theTime = date.getElapsed(); alert(theTime); //将显示间隔的时间,单位是毫秒 @param {Date} date (该参数可选) 默认时间是now @return {Number} 间隔毫秒数 @member Date getElapsed
参数项:
|
Date | |