打印版式

Class Date

Package: Global
Class: Date
Extends: Object
Defined In: Date.js
日期的处理和格式化是PHP's date() function的一个子集,提供的格式和转换后的结果将和 PHP 版本的一模一样。下面列出的就是目前所有支持的格式:
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
返回当前日期是否闰年。

公共事件

此类没有公共事件。

属性详情

Date.DAY

public String Date.DAY
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.HOUR

public String Date.HOUR
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.MILLI

public String Date.MILLI
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.MINUTE

public String Date.MINUTE
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.MONTH

public String Date.MONTH
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.SECOND

public String Date.SECOND
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.YEAR

public String Date.YEAR
<static> 日期间隔常数
这个属性由 Date 对象定义。

Date.dayNames

public Array Date.dayNames
<static> 天数名称的数组。 覆盖此属性即可实现日期对象的本地化,例如:Date.dayNames = ['日', '一', '二' ...];
这个属性由 Date 对象定义。

Date.monthNames

public Array Date.monthNames
<static> 月份名称的数组。 覆盖此属性即可实现日期对象的本地化,例如:Date.monthNames = ['一月', '二月', '三月' ...];
这个属性由 Date 对象定义。

方法详情

Date.parseDate

public function Date.parseDate(String input, String format)
<static> 将输入的字串按照指定的格式转换为日期对象。例如:
var date = Date.parseDate('2006-12-25', 'Y-m-d');
参数:
  • input : String
    输入的日期字串
  • format : String
    转换格式符
返回:
  • Date
    转换后的日期对象
这个方法由 Date 对象定义

add

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
    新的日期对象实例
这个方法由 Date 对象定义

clearTime

public function clearTime(Boolean clone)
清除日期对象中的所有时间信息。
参数:
  • clone : Boolean
    值为“true”时复制一个当前日期实例,清除时间信息后返回。
返回:
  • Date
    实例本身或复制的实例
这个方法由 Date 对象定义

clone

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
    新的日期实例
这个方法由 Date 对象定义

format

public function format(String format)
根据指定的格式将对象格式化。
参数:
  • format : String
    格式符
返回:
  • String
    格式化后的日期对象
这个方法由 Date 对象定义

getDayOfYear

public function getDayOfYear()
返回当前年份中天数的数值,已经根据闰年调整过。
参数:
  • 没有。
返回:
  • Number
    0 到 365(闰年时为 366)
这个方法由 Date 对象定义

getDaysInMonth

public function getDaysInMonth()
返回当前月份中天数的数值,已经根据闰年调整过。
参数:
  • 没有。
返回:
  • Number
    月份中的天数
这个方法由 Date 对象定义

getElapsed

public function getElapsed([Date date])
返回以毫秒表示的与目标日期对象之间的差。
参数:
  • date : Date
    (可选)默认为当前系统时间
返回:
  • Number
    以毫秒表示的值
这个方法由 Date 对象定义

getFirstDateOfMonth

public function getFirstDateOfMonth()
返回当前月份第一天的日期对象。
参数:
  • 没有。
返回:
  • Date
这个方法由 Date 对象定义

getFirstDayOfMonth

public function getFirstDayOfMonth()
返回当前月份第一天的数值,已经根据闰年调整过。返回值为以数字表示的一周中的第几天(0~6),可以与数组 dayNames (译者注:此处原文为“monthNames”。)一起使用来表示当天的星期。例子:
var dt = new Date('1/10/2007');
document.write(Date.dayNames[dt.getFirstDayOfMonth()]); //输出: 'Monday'
参数:
  • 没有。
返回:
  • Number
    一周中的天数(0~6)
这个方法由 Date 对象定义

getGMTOffset

public function getGMTOffset()
返回 GMT 到当前日期的偏移量(等同于指定输出格式“O”)。
参数:
  • 没有。
返回:
  • String
    以“+”或“-”加上4位字符表示的偏移量(例如:“-0600”)
这个方法由 Date 对象定义

getLastDateOfMonth

public function getLastDateOfMonth()
返回当前月份中最后一天的日期对象。
参数:
  • 没有。
返回:
  • Date
这个方法由 Date 对象定义

getLastDayOfMonth

public function getLastDayOfMonth()
返回当前月份中最后一天的数值,已经根据闰年调整过。返回值为以数字表示的一周中的第几天(0~6),可以与数组 dayNames (译者注:此处原文为“monthNames”。)一起使用来表示当天的星期。例子:
var dt = new Date('1/10/2007');
document.write(Date.dayNames[dt.getLastDayOfMonth()]); //输出: 'Wednesday'
参数:
  • 没有。
返回:
  • Number
    一周中的天数(0~6)
这个方法由 Date 对象定义

getSuffix

public function getSuffix()
返回当天的英文单词的后缀(等同于指定输出格式“S”)。
参数:
  • 没有。
返回:
  • String
    “st”、“nd”、“rd”或“th”
这个方法由 Date 对象定义

getTimezone

public function getTimezone()
返回当前所在时区的缩写(等同于指定输出格式“T”)。
参数:
  • 没有。
返回:
  • String
    时区缩写(例如:“CST”)
这个方法由 Date 对象定义

getWeekOfYear

public function getWeekOfYear()
返回当前的星期数(等同于指定输出格式“W”)。
参数:
  • 没有。
返回:
  • String
    “00”~“52”
这个方法由 Date 对象定义

isLeapYear

public function isLeapYear()
返回当前日期是否闰年。
参数:
  • 没有。
返回:
  • Boolean
    闰年为“true”,平年为“false”
这个方法由 Date 对象定义

Ext - Copyright © 2006-2007 Ext JS, LLC
All rights reserved.