Module: date

提供一些处理日期对象的方法
Source:

Methods


cloneDate(_date)

克隆日期对象
Parameters:
Name Type Description
_date Date 需要克隆的日期
Source:
Returns:
Type
Date
Example
date.clone( new Date() )

dateDetect(_dateStr)

日期占位符识别功能
Parameters:
Name Type Description
_dateStr String 如果起始字符为 NOW, 那么将视为当前日期 , 如果起始字符为 NOWFirst, 那么将视为当前月的1号
Source:
Returns:
Type
date | null
Example
dateDetect( 'now' ); //2014-10-02
     dateDetect( 'now,3d' ); //2013-10-05
     dateDetect( 'now,-3d' ); //2013-09-29
     dateDetect( 'now,2w' ); //2013-10-16
     dateDetect( 'now,-2m' ); //2013-08-02
     dateDetect( 'now,4y' ); //2017-10-02

     dateDetect( 'now,1d,1w,1m,1y' ); //2014-11-10

dateFormat(_date, _format)

日期格式化 (具体格式请查看 PHP Date Formats)
Parameters:
Name Type Description
_date date default = now
_format string default = "YY-MM-DD"
Source:
Returns:
string
Example
date.dateFormat( new Date(), 'YYYY-MM-DD' )

dayOfSeason(_date)

取某一天所在季度的开始结束日期,以及第几个Q
Parameters:
Name Type Description
_date Date
Source:
Returns:
Object
Example
date.dayOfSeason( new Date() )

dayOfWeek(_date, _dayOffset)

取某一天所在星期的开始结束日期,以及第几个星期
Parameters:
Name Type Description
_date Date
_dayOffset int
Source:
Returns:
Object
Example
date.dayOfWeek( new Date() )

formatISODate(_date, _split)

格式化日期为 YYYY-mm-dd 格式
require: pad\_char\_f
Parameters:
Name Type Description
_date date 要格式化日期的日期对象
_split string | undefined 定义年月日的分隔符, 默认为 '-'
Source:
Returns:
Type
String
Example
date.formatISODate( new Date() )

isDate(_dateStr, _format)

判断 _dateStr 是否为一个合法的日期字符串
Parameters:
Name Type Description
_dateStr string
_format string
Source:
Returns:
Type
Boolean
Example
date.isDate( '20151211', 'YYYYMMDD' )

isSameDay(_d1, _d2)

判断两个日期是否为同一天
Parameters:
Name Type Description
_d1 Date 需要判断的日期1
_d2 Date 需要判断的日期2
Source:
Returns:
Type
bool
Example
date.isSameDay( new Date(), new Date() )

isSameMonth(_d1, _d2)

判断两个日期是否为同一月份
Parameters:
Name Type Description
_d1 Date 需要判断的日期1
_d2 Date 需要判断的日期2
Source:
Returns:
Type
bool
Example
date.isSameMonth( new Date(), new Date() )

isSameSeason(_d1, _d2)

判断两个日期是否为同一季度
Parameters:
Name Type Description
_d1 Date 需要判断的日期1
_d2 Date 需要判断的日期2
Source:
Returns:
Type
bool
Example
date.isSameSeason( new Date(), new Date() )

isSameWeek(_d1, _d2)

判断两个日期是否为同一季度
Parameters:
Name Type Description
_d1 Date 需要判断的日期1
_d2 Date 需要判断的日期2
Source:
Returns:
Type
bool
Example
date.isSameWeek( new Date(), new Date() )

isSameYear(_d1, _d2)

判断两个日期是否为同一年
Parameters:
Name Type Description
_d1 Date 需要判断的日期1
_d2 Date 需要判断的日期2
Source:
Returns:
Type
bool
Example
date.isSameYear( new Date(), new Date() )

maxDayOfMonth(_date)

取得一个月份中最大的一天
Parameters:
Name Type Description
_date Date
Source:
Returns:
月份中最大的一天
Type
int
Example
date.maxDayOfMonth( new Date() )

parseDate(_dateStr)

从日期字符串解析日期对象
Parameters:
Name Type Description
_dateStr string
Source:
Returns:
Type
date | null
Example
date.parseDate( '20151211' )

parseISODate(_dateStr)

从 ISODate 字符串解析日期对象
Parameters:
Name Type Description
_dateStr string
Source:
Returns:
date
Example
date.parseISODate( '20151211' )

pureDate(_d)

获取不带 时分秒的 日期对象
Parameters:
Name Type Description
_d Date 可选参数, 如果为空 = new Date
Source:
Returns:
Date
Example
date.pureDate( new Date() )

pureDateTime()

获取UTC初始化时间
1970 08:00:00
Source:
Returns:
Date
Example
date.pureDateTime()

seasonOfYear(_year)

取一年中所有的季度, 及其开始结束日期
Parameters:
Name Type Description
_year int
Source:
Returns:
Array
Example
date.seasonOfYear( 2015 )

weekOfYear(_year, _dayOffset)

取一年中所有的星期, 及其开始结束日期
Parameters:
Name Type Description
_year int
_dayOffset int 每周的默认开始为周几, 默认0(周一)
Source:
Returns:
Array
Example
date.weekOfYear( 2015 )