DateUtil

功能描述

提供JS Date对象的一些工具函数

快速使用

 *    @description fmt格式
 *    y(年)
 *    M(月)
 *    d(日)
 *    q(季度)
 *    w(星期)
 *    H(24小时制的小时)
 *    h(12小时制的小时)
 *    m(分钟)
 *    s(秒)
 *    S(毫秒)

formatDate(date, fmt)
 * @description 将日期格式化成指定格式的字符串
 * @param date 要格式化的日期,不传时默认当前时间,也可以是一个时间戳
 * @param fmt 目标字符串格式,支持的字符有:y,M,d,q,w,H,h,m,S,默认:yyyy-MM-dd HH:mm:ss
 * @return 返回格式化后的日期字符串
 * @example formatDate(); formatDate(new Date(), 'yyyy-MM-dd');
 * @example formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS');
 * @example formatDate(1472793615764); // 2016-09-02 13:20:15


parseDate(str, fmt) 
 * 将字符串解析成日期
 * @param str 输入的日期字符串,如'2014-09-13'
 * @param fmt 字符串格式,默认'yyyy-MM-dd',支持如下:y、M、d、H、m、s、S,不支持w和q
 * @returns 解析后的Date类型日期
 * @example parseDate('2016-08-11');
 * @example parseDate('2016-08-11 13:28:43', 'yyyy-MM-dd HH:mm:ss')


formatDateToFriendly(date)
 * @description 将一个日期格式化成友好格式,比如,1分钟以内的返回“刚刚”,
 * @description 当天的返回时分,当年的返回月日,否则,返回年月日


formatDurationToFriendly(second) 
 * 将一段时长转换成友好格式,如:
 * 147->“2分27秒”
 * 1581->“26分21秒”
 * 15818->“4小时24分”


formatTimeToFriendly(second)
 * 将一段时长转换成MM:SS形式


isLeapYear(year)
 * 判断某一年是否是闰年
 * @param year 可以是一个date类型,也可以是一个int类型的年份,不传默认当前时间


getMonthDays(date, month) 
 * 获取某一年某一月的总天数,没有任何参数时获取当前月份的
 * 方式一:$.getMonthDays();
 * 方式二:$.getMonthDays(new Date());
 * 方式三:$.getMonthDays(2013, 12);


countDays(date1, date2)
 * 计算2日期之间的天数,用的是比较毫秒数的方法
 * 传进来的日期要么是Date类型,要么是yyyy-MM-dd格式的字符串日期
 * @param date1 日期一
 * @param date2 日期二


countSeconds(date1, date2)
 * 计算2日期之间的秒数,用的是比较毫秒数的方法
 * 传进来的日期要么是Date类型,要么是yyyy-MM-dd格式的字符串日期
 * @param date1 日期一
 * @param date2 日期二


addDay(date, days, fmt)
 * 日期,在原有日期基础上,增加days天数,默认增加1天
 * @param date1 日期一
 * @param days 增加天数 默认加1天
 * @param fmt 字符串格式 默认不格式化

特别说明