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 字符串格式 默认不格式化

特别说明

无
是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18