DateUtil

功能描述

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

快速使用

  1. * @description fmt格式
  2. * y(年)
  3. * M(月)
  4. * d(日)
  5. * q(季度)
  6. * w(星期)
  7. * H24小时制的小时)
  8. * h12小时制的小时)
  9. * m(分钟)
  10. * s(秒)
  11. * S(毫秒)
  12. formatDate(date, fmt)
  13. * @description 将日期格式化成指定格式的字符串
  14. * @param date 要格式化的日期,不传时默认当前时间,也可以是一个时间戳
  15. * @param fmt 目标字符串格式,支持的字符有:y,M,d,q,w,H,h,m,S,默认:yyyy-MM-dd HH:mm:ss
  16. * @return 返回格式化后的日期字符串
  17. * @example formatDate(); formatDate(new Date(), 'yyyy-MM-dd');
  18. * @example formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS');
  19. * @example formatDate(1472793615764); // 2016-09-02 13:20:15
  20. parseDate(str, fmt)
  21. * 将字符串解析成日期
  22. * @param str 输入的日期字符串,如'2014-09-13'
  23. * @param fmt 字符串格式,默认'yyyy-MM-dd',支持如下:yMdHmsS,不支持wq
  24. * @returns 解析后的Date类型日期
  25. * @example parseDate('2016-08-11');
  26. * @example parseDate('2016-08-11 13:28:43', 'yyyy-MM-dd HH:mm:ss')
  27. formatDateToFriendly(date)
  28. * @description 将一个日期格式化成友好格式,比如,1分钟以内的返回“刚刚”,
  29. * @description 当天的返回时分,当年的返回月日,否则,返回年月日
  30. formatDurationToFriendly(second)
  31. * 将一段时长转换成友好格式,如:
  32. * 147->“227秒”
  33. * 1581->“2621秒”
  34. * 15818->“4小时24分”
  35. formatTimeToFriendly(second)
  36. * 将一段时长转换成MM:SS形式
  37. isLeapYear(year)
  38. * 判断某一年是否是闰年
  39. * @param year 可以是一个date类型,也可以是一个int类型的年份,不传默认当前时间
  40. getMonthDays(date, month)
  41. * 获取某一年某一月的总天数,没有任何参数时获取当前月份的
  42. * 方式一:$.getMonthDays();
  43. * 方式二:$.getMonthDays(new Date());
  44. * 方式三:$.getMonthDays(2013, 12);
  45. countDays(date1, date2)
  46. * 计算2日期之间的天数,用的是比较毫秒数的方法
  47. * 传进来的日期要么是Date类型,要么是yyyy-MM-dd格式的字符串日期
  48. * @param date1 日期一
  49. * @param date2 日期二
  50. countSeconds(date1, date2)
  51. * 计算2日期之间的秒数,用的是比较毫秒数的方法
  52. * 传进来的日期要么是Date类型,要么是yyyy-MM-dd格式的字符串日期
  53. * @param date1 日期一
  54. * @param date2 日期二
  55. addDay(date, days, fmt)
  56. * 日期,在原有日期基础上,增加days天数,默认增加1
  57. * @param date1 日期一
  58. * @param days 增加天数 默认加1
  59. * @param fmt 字符串格式 默认不格式化

特别说明