Package: | Global |
Class: | Date |
Extends: | Object |
Defined In: | Date.js |
Sample date: 'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)' 格式符 输出 说明 ------ ---------- -------------------------------------------------------------- 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));
属性 | 定义对象 | |
---|---|---|
Date.DAY : String | Date | |
<static> 日期间隔常数 | ||
Date.HOUR : String | Date | |
<static> 日期间隔常数 | ||
Date.MILLI : String | Date | |
<static> 日期间隔常数 | ||
Date.MINUTE : String | Date | |
<static> 日期间隔常数 | ||
Date.MONTH : String | Date | |
<static> 日期间隔常数 | ||
Date.SECOND : String | Date | |
<static> 日期间隔常数 | ||
Date.YEAR : String | Date | |
<static> 日期间隔常数 | ||
Date.dayNames : Array | Date | |
<static> 天数名称的数组。 | ||
Date.monthNames : Array | Date | |
<static> 月份名称的数组。 |
方法 | 定义对象 | |
---|---|---|
Date.parseDate (String input , String format ) : Date |
Date | |
<static> 将输入的字串按照指定的格式转换为日期对象。 | ||
add (String interval , Number value ) : Date |
Date | |
一个便利的日期运算的方法。 | ||
clearTime (Boolean clone ) : Date |
Date | |
清除日期对象中的所有时间信息。 | ||
clone () : Date | Date | |
创建并返回一个新的与原来一模一样的日期实例。 | ||
format (String format ) : String |
Date | |
根据指定的格式将对象格式化。 | ||
getDayOfYear () : Number | Date | |
返回当前年份中天数的数值,已经根据闰年调整过。 | ||
getDaysInMonth () : Number | Date | |
返回当前月份中天数的数值,已经根据闰年调整过。 | ||
getElapsed ([Date date ]) : Number |
Date | |
返回以毫秒表示的与目标日期对象之间的差。 | ||
getFirstDateOfMonth () : Date | Date | |
返回当前月份第一天的日期对象。 | ||
getFirstDayOfMonth () : Number | Date | |
返回当前月份第一天的数值,已经根据闰年调整过。 | ||
getGMTOffset () : String | Date | |
返回 GMT 到当前日期的偏移量(等同于指定输出格式“O”)。 | ||
getLastDateOfMonth () : Date | Date | |
返回当前月份中最后一天的日期对象。 | ||
getLastDayOfMonth () : Number | Date | |
返回当前月份中最后一天的数值,已经根据闰年调整过。 | ||
getSuffix () : String | Date | |
返回当天的英文单词的后缀(等同于指定输出格式“S”)。 | ||
getTimezone () : String | Date | |
返回当前所在时区的缩写(等同于指定输出格式“T”)。 | ||
getWeekOfYear () : String | Date | |
返回当前的星期数(等同于指定输出格式“W”)。 | ||
isLeapYear () : Boolean | Date | |
返回当前日期是否闰年。 |
public String Date.DAY
public String Date.HOUR
public String Date.MILLI
public String Date.MINUTE
public String Date.MONTH
public String Date.SECOND
public String Date.YEAR
public Array Date.dayNames
public Array Date.monthNames
public function Date.parseDate(String input
, String format
)
var date = Date.parseDate('2006-12-25', 'Y-m-d');
input
: String
format
: String
Date
public function add(String interval
, Number value
)
//基本用法:
var dt = new Date('10/29/2006').add(Date.DAY, 5);
document.write(dt); //返回 'Fri Oct 06 2006 00:00:00'
//负数的值将会减去数值:
var dt2 = new Date('10/1/2006').add(Date.DAY, -5);
document.write(dt2); //返回 'Tue Sep 26 2006 00:00:00'
//你甚至可以连续多次调用此方法!
var dt3 = new Date('10/1/2006').add(Date.DAY, 5).add(Date.HOUR, 8).add(Date.MINUTE, -30);
document.write(dt3); //返回 'Fri Oct 06 2006 07:30:00'
interval
: String
value
: Number
Date
public function clearTime(Boolean clone
)
clone
: Boolean
Date
public function clone()
//错误的方式:
var orig = new Date('10/1/2006');
var copy = orig;
copy.setDate(5);
document.write(orig); //返回 'Thu Oct 05 2006'
//正确的方式:
var orig = new Date('10/1/2006');
var copy = orig.clone();
copy.setDate(5);
document.write(orig); //返回 'Thu Oct 01 2006'
Date
public function format(String format
)
format
: String
String
public function getDayOfYear()
Number
public function getDaysInMonth()
Number
public function getElapsed([Date date
])
date
: Date
Number
public function getFirstDateOfMonth()
Date
public function getFirstDayOfMonth()
var dt = new Date('1/10/2007');
document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //输出: 'Monday'
Number
public function getGMTOffset()
String
public function getLastDateOfMonth()
Date
public function getLastDayOfMonth()
var dt = new Date('1/10/2007');
document.write(Date.dayNames[dt.getLastDayOfMonth()]); //输出: 'Wednesday'
Number
public function getSuffix()
String
public function getTimezone()
String
public function getWeekOfYear()
String
public function isLeapYear()
Boolean