API
Class

Date ($UI/system/lib/base/date)

使用范围:UI2

Contents

class Date ($UI/system/lib/base/date)

常用的日期操作

Constructor Top

  Date ()

Static Properties & Enumerations Top

String DEFAULT_FORMAT

[filed]时间格式常量 = "yyyy/MM/dd hh:mm:ss"

String DEFAULT_FORMAT1

[filed]时间格式常量 = "yyyy-MM-dd hh:mm:ss"

String DEFAULT_FORMAT_SHOT

[filed]时间格式常量 = "yyyy/MM/dd"

String STANDART_FORMAT

[filed]时间格式常量 = "yyyy-MM-ddThh:mm:ss.fffZ"

String STANDART_FORMAT_SHOT

[filed]时间格式常量 = "yyyy-MM-dd"

String UNIT_DAY

[filed]时间单位常量天 = "d"

String UNIT_HOUR

[filed]时间单位常量小时 = "h"

String UNIT_MINUTE

[filed]时间单位常量分钟 = "n"

String UNIT_MONTH

[filed]时间单位常量月 = "m"

String UNIT_QUARTER

[filed]时间单位常量度 = "q"

String UNIT_SECOND

[filed]时间单位常量秒 = "s"

String UNIT_WEEK

[filed]时间单位常量周 = "w"

String UNIT_YEAR

[filed]时间单位常量 年 = "y"

Static Methods Top

Number between (Date start, Date end)
Integer daysBetween (DateTime start, DateTime end)
Date decrease (Date datetime, Number num, String interval)
Number diff (Date start, Date end, String interval)
Integer fromNowDays (DateTime date)
Integer fromNowHours (DateTime date)
Integer fromNowMinutes (DateTime date)
Integer fromNowMonths (DateTime date)
Integer fromNowSeconds (DateTime date)
Integer fromNowYears (DateTime date)
Date fromString (String str, String format)
Integer getDate (DateTime date)
Integer getDay (DateTime date)
Date getFirstDay (Date date)
Integer getFullYear (DateTime date)
Integer getHour (DateTime date)
Date getLastDay (Date date)
Integer getMinutes (DateTime date)
Integer getMonth (DateTime date)
Integer getSeconds (DateTime date)
Long getTime (DateTime date)
Integer hoursBetween (DateTime start, DateTime end)
Date increase (Date datetime, Number num, String interval)
Boolean isLeapYear (Date date)
Integer minutesBetween (DateTime start, DateTime end)
Integer monthsBetween (DateTime start, DateTime end)
Date now ()
DateTime parse (Long millis)
DateTime plus (DateTime date, Long duration)
DateTime plusDates (DateTime date, Integer dates)
DateTime plusHours (DateTime date, Integer hours)
DateTime plusMinutes (DateTime date, Integer minutes)
DateTime plusMonths (DateTime date, Integer month)
DateTime plusSeconds (DateTime date, Integer seconds)
DateTime plusYears (DateTime date, Integer years)
DateTime setDate (DateTime date, Integer day)
DateTime setFullYear (DateTime date, Integer years)
DateTime setHours (DateTime date, Integer hoursValue)
DateTime setMinutes (DateTime date, Integer minutes)
DateTime setMonth (DateTime date, Integer month)
DateTime setSeconds (DateTime date, Integer seconds)
String toString (Date dateTime, String formatStr)
Integer yearsBetween (DateTime start, DateTime end)

Constructor details Top

public Date ()

常用的日期操作

Static Properties & Enumerations Detail Top

static public String DEFAULT_FORMAT

[filed]时间格式常量 = "yyyy/MM/dd hh:mm:ss"

static public String DEFAULT_FORMAT1

[filed]时间格式常量 = "yyyy-MM-dd hh:mm:ss"

static public String DEFAULT_FORMAT_SHOT

[filed]时间格式常量 = "yyyy/MM/dd"

static public String STANDART_FORMAT

[filed]时间格式常量 = "yyyy-MM-ddThh:mm:ss.fffZ"

static public String STANDART_FORMAT_SHOT

[filed]时间格式常量 = "yyyy-MM-dd"

static public String UNIT_DAY

[filed]时间单位常量天 = "d"

static public String UNIT_HOUR

[filed]时间单位常量小时 = "h"

static public String UNIT_MINUTE

[filed]时间单位常量分钟 = "n"

static public String UNIT_MONTH

[filed]时间单位常量月 = "m"

static public String UNIT_QUARTER

[filed]时间单位常量度 = "q"

static public String UNIT_SECOND

[filed]时间单位常量秒 = "s"

static public String UNIT_WEEK

[filed]时间单位常量周 = "w"

static public String UNIT_YEAR

[filed]时间单位常量 年 = "y"

Static Methods Detail Top

static public Number between (Date start, Date end)

计算两个日期相差几天,和diff很相似,返回永远是正整数

Parameters

Date start

起始日期

Date end

结束日期

Return Value

Number

返回相差几天

static public Integer daysBetween (DateTime start, DateTime end)

从指定时间到指定时间的天数

Parameters

DateTime start

开始日期

DateTime end

结束日期

Return Value

Integer

static public Date decrease (Date datetime, Number num, String interval)

根据日期的规则,为给定的日期减去指定的时间量

Parameters

Date datetime

要处理的日期对象

Number num

减去的时间量

String interval

减去的时间单位,'s'代表秒,'n'代表分钟,'h'代表小时 ,'d'代表天, 'w'代表 周 ,'m'代表月,'q'代表季度,'y'代表年

Return Value

Date

返回日期

static public Number diff (Date start, Date end, String interval)

计算两个日期的差

Parameters

Date start

起始日期

Date end

结束日期

String interval

时间单位,默认是以天为单位,'s'代表秒,'n'代表分钟,'h'代表小时 ,'d'代表天, 'w'代表 周 ,'m'代表月,'q'代表季度,'y'代表年

Return Value

Number

返回结果,如果起始日期小于结束日期返回正整数,否则返回负整数

static public Integer fromNowDays (DateTime date)

到现在的天数

Parameters

DateTime date

日期

Return Value

Integer

static public Integer fromNowHours (DateTime date)

到现在的小时数

Parameters

DateTime date

日期

Return Value

Integer

static public Integer fromNowMinutes (DateTime date)

到现在的分钟数

Parameters

DateTime date

日期

Return Value

Integer

static public Integer fromNowMonths (DateTime date)

到现在的月份

Parameters

DateTime date

日期

Return Value

Integer

static public Integer fromNowSeconds (DateTime date)

到现在的分秒数

Parameters

DateTime date

日期

Return Value

Integer

static public Integer fromNowYears (DateTime date)

到现在的年份

Parameters

DateTime date

日期

Return Value

Integer

static public Date fromString (String str, String format)

按照给定的日期格式,把字符串转换成日期对象

Parameters

String str

字符串

String format

日期格式

Return Value

Date

返回日期

static public Integer getDate (DateTime date)

根据本地时间返回指定日期对象的月份中的第几天(1-31)

Parameters

DateTime date

根据本地时间返回指定日期对象的月份中的第几天(1-31)

Return Value

Integer

static public Integer getDay (DateTime date)

根据本地时间返回指定日期对象的星期中的第几天(0-6)

Parameters

DateTime date

根据本地时间返回指定日期对象的星期中的第几天(0-6)

Return Value

Integer

static public Date getFirstDay (Date date)

返回月第一天

Parameters

Date date

日期

Return Value

Date

返回月第一天

static public Integer getFullYear (DateTime date)

获取当前日期中的年份

Parameters

DateTime date

日期

Return Value

Integer

static public Integer getHour (DateTime date)

获取当前日期中的小时数

Parameters

DateTime date

日期

Return Value

Integer

static public Date getLastDay (Date date)

返回月最后天

Parameters

Date date

日期

Return Value

Date

返回月最后天

static public Integer getMinutes (DateTime date)

获取当前日期中的分钟数

Parameters

DateTime date

日期

Return Value

Integer

static public Integer getMonth (DateTime date)

获取当前日期中的月份(1-12)

Parameters

DateTime date

日期

Return Value

Integer

static public Integer getSeconds (DateTime date)

获取当前日期中的秒数

Parameters

DateTime date

日期

Return Value

Integer

static public Long getTime (DateTime date)

获取当前日期的总毫秒数

Parameters

DateTime date

日期

Return Value

Long

static public Integer hoursBetween (DateTime start, DateTime end)

从指定时间到指定时间的小时数

Parameters

DateTime start

开始日期

DateTime end

结束日期

Return Value

Integer

static public Date increase (Date datetime, Number num, String interval)

根据日期的规则,为给定的日期添加指定的时间量

Parameters

Date datetime

要处理的日期对象

Number num

添加的时间量

String interval

添加的时间单位,'s'代表秒,'n'代表分钟,'h'代表小时 ,'d'代表天, 'w'代表 周 ,'m'代表月,'q'代表季度,'y'代表年

Return Value

Date

返回日期

static public Boolean isLeapYear (Date date)

判断日期是否是闰年

Parameters

Date date

日期

Return Value

Boolean

如果是闰年返回true,否则返回false

static public Integer minutesBetween (DateTime start, DateTime end)

从指定时间到指定时间的分钟数

Parameters

DateTime start

开始日期

DateTime end

结束日期

Return Value

Integer

static public Integer monthsBetween (DateTime start, DateTime end)

从指定时间到指定时间的月份

Parameters

DateTime start

开始日期

DateTime end

结束日期

Return Value

Integer

static public Date now ()

返回当前时间

Return Value

Date

返回当前时间

static public DateTime parse (Long millis)

将毫秒数转换为时间

Parameters

Long millis

毫秒数

Return Value

DateTime

static public DateTime plus (DateTime date, Long duration)

增加/减少指定毫秒数

Parameters

DateTime date

日期

Long duration

毫秒

Return Value

DateTime

static public DateTime plusDates (DateTime date, Integer dates)

增加/减少指定天数

Parameters

DateTime date

日期

Integer dates

天数

Return Value

DateTime

static public DateTime plusHours (DateTime date, Integer hours)

增加/减少指定小时数

Parameters

DateTime date

日期

Integer hours

Return Value

DateTime

static public DateTime plusMinutes (DateTime date, Integer minutes)

增加/减少指定分钟数

Parameters

DateTime date

日期

Integer minutes

分钟数

Return Value

DateTime

static public DateTime plusMonths (DateTime date, Integer month)

增加/减少指定月份

Parameters

DateTime date

日期

Integer month

Return Value

DateTime

static public DateTime plusSeconds (DateTime date, Integer seconds)

增加/减少指定秒数

Parameters

DateTime date

日期

Integer seconds

Return Value

DateTime

static public DateTime plusYears (DateTime date, Integer years)

增加/减少指定年份

Parameters

DateTime date

日期

Integer years

Return Value

DateTime

static public DateTime setDate (DateTime date, Integer day)

根据本地时间来指定一个日期对象的天数

Parameters

DateTime date

日期

Integer day

一个整数,表示该月的第几天

Return Value

DateTime

static public DateTime setFullYear (DateTime date, Integer years)

设置当前日期的年份

Parameters

DateTime date

日期

Integer years

年份

Return Value

DateTime

static public DateTime setHours (DateTime date, Integer hoursValue)

设置当前日期的小时数

Parameters

DateTime date

日期

Integer hoursValue

小时数

Return Value

DateTime

static public DateTime setMinutes (DateTime date, Integer minutes)

设置当前日期的分钟数

Parameters

DateTime date

日期

Integer minutes

分钟数

Return Value

DateTime

static public DateTime setMonth (DateTime date, Integer month)

设置当前日期的月份

Parameters

DateTime date

日期

Integer month

月份

Return Value

DateTime

static public DateTime setSeconds (DateTime date, Integer seconds)

设置当前日期的秒数

Parameters

DateTime date

日期

Integer seconds

秒数

Return Value

DateTime

static public String toString (Date dateTime, String formatStr)

按照给定的日期格式,把日期对象转换成字符串

Parameters

Date dateTime

要处理的日期对象

String formatStr

日期格式

Return Value

String

返回字符串

static public Integer yearsBetween (DateTime start, DateTime end)

从指定时间到指定时间的年份

Parameters

DateTime start

开始日期

DateTime end

结束日期

Return Value

Integer