DateUtils (MustardTools 0.2.4 API)

java.lang.Object
- cn.buli_home.utils.date.DateUtils

```
public class DateUtils
extends Object
```

嵌套类概要

嵌套类
限定符和类型类和说明

static class DateUtils.DateNode

嵌套类
限定符和类型	类和说明
`static class`	`DateUtils.DateNode`

字段概要

字段
限定符和类型字段和说明

private static Map<String,SimpleDateFormat> simpleDateFormatMap
时间格式化器集合

字段
限定符和类型	字段和说明
`private static Map<String,SimpleDateFormat>`	`simpleDateFormatMap` 时间格式化器集合

构造器概要

构造器
构造器和说明

DateUtils()

构造器
构造器和说明
`DateUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Date`	`add(Date date, int field, int amount)` 日期变更
`static Date`	`addDay(Date date, int day)` 指定日期加减天数
`static Date`	`addHour(Date date, int hour)` 指定日期加减小时
`static Date`	`addMillisecond(Date date, int millisecond)` 指定日期加减秒
`static Date`	`addMinute(Date date, int minute)` 指定日期加减分钟
`static Date`	`addMonth(Date date, int month)` 指定日期加减月份
`static Date`	`addSecond(Date date, int second)` 指定日期加减秒
`static Date`	`addWeek(Date date, int week)` 指定日期加减星期
`static Date`	`addYear(Date date, int year)` 指定日期加减年份
`static int`	`age(Date birthday, Date dateToCompare)` 计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄
`protected static int`	`age(long birthday, long dateToCompare)` 计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄按照《最高人民法院关于审理未成年人刑事案件具体应用法律若干问题的解释》第二条规定刑法第十七条规定的“周岁”，按照公历的年、月、日计算，从周岁生日的第二天起算。
`static int`	`ageOfNow(Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(String birthDay, String formatStyle)` 生日转为年龄，计算法定年龄
`static Integer`	`compareDays(Date date1, Date date2)` 比较两个日期的大小 (毫秒级)
`static String`	`convertMillisecond2TimeStr(long millisecond)`
`static String`	`convertMinute2TimeStr(long minute)`
`static String`	`convertSecond2TimeStr(long second)`
`static int`	`countBetweenDays(Date date1, Date date2)` 获取两个日期相差的天数（以日期为单位计算，不以24小时制计算，详见下面说明）【说明】比如 2022-06-17 23:00:00 和 2022-06-17 01:00:00，两者虽然只相差 2 个小时，但也算相差 1 天
`static String`	`format(Date date, String formatStyle)` 将 Date 格式时间转化为指定格式时间
`static String`	`formatDate(Date date)` 将 Date 格式时间转化为 yyyy-MM-dd 格式时间
`static String`	`formatDateTimeMillisecond(Date date)` 将 Date 格式时间转化为 yyyy-MM-dd HH:mm:ss:SSS 格式时间
`static String`	`formatDateTimeSecond(Date date)` 将 Date 格式时间转化为 yyyy-MM-dd HH:mm:ss 格式时间
`static List<Date>`	`getBetweenDateList(Date date1, Date date2)` 获取两个日期之间的所有日期
`static List<Date>`	`getBetweenDateList(Date date1, Date date2, boolean isContainParams)` 获取两个日期之间的所有日期
`static List<String>`	`getBetweenDateList(String dateString1, String dateString2)` 获取两个日期之间的所有日期
`static List<String>`	`getBetweenDateList(String dateString1, String dateString2, boolean isContainParams)` 获取两个日期之间的所有日期
`static Date`	`getDateEnd(Date date)` 获取一天的截止时间（即：23 点 59 分 59 秒 999 毫秒）
`static int`	`getDateNo(Date date)` 获取日期数字
`static DateUtils.DateNode`	`getDateNode(Date date)` 获取时间节点对象
`static Date`	`getDateStart(Date date)` 获取一天的开始时间（即：0 点 0 分 0 秒 0 毫秒）
`static List<String>`	`getDateStrList(List<Date> dates)` List 转 List
`static long`	`getDateTimeMillisecond(Date date)` 获取日期时间数字（到毫秒）
`static long`	`getDateTimeSecond(Date date)` 获取日期时间数字（到秒）
`static Date`	`getMonthDateEnd(Date date)` 获取本日期所在月最后一天
`static List<Date>`	`getMonthDateList(Date date)` 获取该日期所在月的所有日期
`static List<String>`	`getMonthDateList(String dateString)` 获取该日期所在月的所有日期
`static Date`	`getMonthDateStart(Date date)` 获取本日期所在月第一天
`static long`	`getTimestampMillisecond(Date date)` 获取时间戳
`static long`	`getTimestampSecond(Date date)` 获取时间戳
`static Date`	`getWeekDate(Date date, WeekDay weekDay)` 获取该日期所在周指定星期的日期
`static Date`	`getWeekDateEnd(Date date)` 获取该日期所在周开始日期
`static List<Date>`	`getWeekDateList(Date date)` 获取该日期所在周的所有日期（周一到周日）
`static List<String>`	`getWeekDateList(String dateString)` 获取该日期所在周的所有日期（周一到周日）
`static Date`	`getWeekDateStart(Date date)` 获取该日期所在周开始日期
`static int`	`getWeekOfYear(Date date)` 获取该日期是今年的第几周（以本年的周一为第1周，详见下面说明）【说明】比如 2022-01-01（周六）和 2022-01-02（周日）虽然在 2022 年里，但他们两天则属于 2021 年最后一周，那么这两天不会算在 2022 年第 1 周里，此时会返回 0 ；而 2022 年第 1 周将从 2022-01-03（周一）开始计算。
`static int`	`getWeekOfYearIgnoreLastYear(Date date)` 获取今年的第几周（以本年的1月1日为第1周第1天）
`private static SimpleDateFormat`	`p_getSimpleDateFormat(String formatStyle)` 获取指定时间格式化器
`private static String`	`p_getString(String s)` 获取字符串有效内容
`private static int`	`p_getWeek(Calendar calendar)` 获取星期几
`private static int`	`p_getWeek(Date date)` 获取星期几
`static Date`	`parse(String dateString, String formatStyle)` 将字符串格式时间转化为 Date 格式时间
`static Date`	`parseDate(String dateString)` 将 yyyy-MM-dd 格式时间转化为 Date 格式时间
`static Date`	`parseDateTimeMillisecond(String dateTimeStr)` 将 yyyy-MM-dd HH:mm:ss:SSS 格式时间转化为 Date 格式时间
`static Date`	`parseDateTimeSecond(String dateTimeStr)` 将 yyyy-MM-dd HH:mm:ss 格式时间转化为 Date 格式时间

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - simpleDateFormatMap
```
private static final Map<String,SimpleDateFormat> simpleDateFormatMap
```
    时间格式化器集合
- 构造器详细资料
  - DateUtils
```
public DateUtils()
```
- 方法详细资料
  - p_getSimpleDateFormat
```
private static SimpleDateFormat p_getSimpleDateFormat(String formatStyle)
```
    获取指定时间格式化器
    
    参数:
    
    formatStyle - 时间格式
    
    返回:
    
    时间格式化器
  - format
```
public static String format(Date date,
                            String formatStyle)
```
    将 Date 格式时间转化为指定格式时间
    
    参数:
    
    date - Date 格式时间
    
    formatStyle - 转化指定格式（如: yyyy-MM-dd HH:mm:ss）
    
    返回:
    
    转化格式时间
  - formatDate
```
public static String formatDate(Date date)
```
    将 Date 格式时间转化为 yyyy-MM-dd 格式时间
    
    参数:
    
    date - Date 格式时间
    
    返回:
    
    yyyy-MM-dd 格式时间（如：2022-06-17）
  - formatDateTimeSecond
```
public static String formatDateTimeSecond(Date date)
```
    将 Date 格式时间转化为 yyyy-MM-dd HH:mm:ss 格式时间
    
    参数:
    
    date - Date 格式时间
    
    返回:
    
    yyyy-MM-dd HH:mm:ss 格式时间（如：2022-06-17 16:06:17）
  - formatDateTimeMillisecond
```
public static String formatDateTimeMillisecond(Date date)
```
    将 Date 格式时间转化为 yyyy-MM-dd HH:mm:ss:SSS 格式时间
    
    参数:
    
    date - Date 格式时间
    
    返回:
    
    yyyy-MM-dd HH:mm:ss:SSS 格式时间（如：2022-06-17 16:06:17:325）
  - parseDate
```
public static Date parseDate(String dateString)
```
    将 yyyy-MM-dd 格式时间转化为 Date 格式时间
    
    参数:
    
    dateString - yyyy-MM-dd 格式时间（如：2022-06-17）
    
    返回:
    
    Date 格式时间
  - parseDateTimeSecond
```
public static Date parseDateTimeSecond(String dateTimeStr)
```
    将 yyyy-MM-dd HH:mm:ss 格式时间转化为 Date 格式时间
    
    参数:
    
    dateTimeStr - yyyy-MM-dd HH:mm:ss 格式时间（如：2022-06-17 16:06:17）
    
    返回:
    
    Date 格式时间
  - parseDateTimeMillisecond
```
public static Date parseDateTimeMillisecond(String dateTimeStr)
```
    将 yyyy-MM-dd HH:mm:ss:SSS 格式时间转化为 Date 格式时间
    
    参数:
    
    dateTimeStr - yyyy-MM-dd HH:mm:ss:SSS 格式时间（如：2022-06-17 16:06:17）
    
    返回:
    
    Date 格式时间
  - parse
```
public static Date parse(String dateString,
                         String formatStyle)
```
    将字符串格式时间转化为 Date 格式时间
    
    参数:
    
    dateString - 字符串时间（如：2022-06-17 16:06:17）
    
    返回:
    
    formatStyle 格式内容
  - p_getString
```
private static String p_getString(String s)
```
    获取字符串有效内容
    
    参数:
    
    s - 字符串
    
    返回:
    
    有效内容
  - getDateStart
```
public static Date getDateStart(Date date)
```
    获取一天的开始时间（即：0 点 0 分 0 秒 0 毫秒）
    
    参数:
    
    date - 指定时间
    
    返回:
    
    当天的开始时间
  - getDateEnd
```
public static Date getDateEnd(Date date)
```
    获取一天的截止时间（即：23 点 59 分 59 秒 999 毫秒）
    
    参数:
    
    date - 指定时间
    
    返回:
    
    当天的开始时间
  - getDateNo
```
public static int getDateNo(Date date)
```
    获取日期数字
    
    参数:
    
    date - 日期
    
    返回:
    
    日期数字
  - getDateTimeSecond
```
public static long getDateTimeSecond(Date date)
```
    获取日期时间数字（到秒）
    
    参数:
    
    date - 日期
    
    返回:
    
    日期数字
  - getDateTimeMillisecond
```
public static long getDateTimeMillisecond(Date date)
```
    获取日期时间数字（到毫秒）
    
    参数:
    
    date - 日期
    
    返回:
    
    日期数字
  - getTimestampSecond
```
public static long getTimestampSecond(Date date)
```
    获取时间戳
    
    参数:
    
    date - 日期
    
    返回:
    
    时间戳(秒级)
  - getTimestampMillisecond
```
public static long getTimestampMillisecond(Date date)
```
    获取时间戳
    
    参数:
    
    date - 日期
    
    返回:
    
    时间戳(毫秒级)
  - p_getWeek
```
private static int p_getWeek(Date date)
```
    获取星期几
    
    参数:
    
    date - 时间
    
    返回:
    
    0（时间为空）， 1（周一）， 2（周二），3（周三），4（周四），5（周五），6（周六），7（周日）
  - p_getWeek
```
private static int p_getWeek(Calendar calendar)
```
    获取星期几
    
    返回:
    
    0（时间为空）， 1（周一）， 2（周二），3（周三），4（周四），5（周五），6（周六），7（周日）
  - getWeekOfYear
```
public static int getWeekOfYear(Date date)
```
    获取该日期是今年的第几周（以本年的周一为第1周，详见下面说明）
    
    【说明】
    比如 2022-01-01（周六）和 2022-01-02（周日）虽然在 2022 年里，但他们两天则属于 2021 年最后一周，
    那么这两天不会算在 2022 年第 1 周里，此时会返回 0 ；而 2022 年第 1 周将从 2022-01-03（周一）开始计算。
    
    参数:
    
    date - 时间
    
    返回:
    
    -1（时间为空）， 0（为上个年的最后一周），其他数字（今年的第几周）
  - getWeekOfYearIgnoreLastYear
```
public static int getWeekOfYearIgnoreLastYear(Date date)
```
    获取今年的第几周（以本年的1月1日为第1周第1天）
    
    参数:
    
    date - 时间
    
    返回:
    
    -1（时间为空），其他数字（今年的第几周）
  - getDateNode
```
public static DateUtils.DateNode getDateNode(Date date)
```
    获取时间节点对象
    
    参数:
    
    date - 时间对象
    
    返回:
    
    DateNode
  - add
```
public static Date add(Date date,
                       int field,
                       int amount)
```
    日期变更
    
    参数:
    
    date - 指定日期
    
    field - 变更属性（如变更年份，则该值为 Calendar.DAY_OF_YEAR）
    
    amount - 变更大小（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更后的日期时间
  - addYear
```
public static Date addYear(Date date,
                           int year)
```
    指定日期加减年份
    
    参数:
    
    date - 指定日期
    
    year - 变更年份（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更年份后的日期
  - addMonth
```
public static Date addMonth(Date date,
                            int month)
```
    指定日期加减月份
    
    参数:
    
    date - 指定日期
    
    month - 变更月份（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更月份后的日期
  - addDay
```
public static Date addDay(Date date,
                          int day)
```
    指定日期加减天数
    
    参数:
    
    date - 指定日期
    
    day - 变更天数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更天数后的日期
  - addWeek
```
public static Date addWeek(Date date,
                           int week)
```
    指定日期加减星期
    
    参数:
    
    date - 指定日期
    
    week - 变更星期数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更星期数后的日期
  - addHour
```
public static Date addHour(Date date,
                           int hour)
```
    指定日期加减小时
    
    参数:
    
    date - 指定日期时间
    
    hour - 变更小时数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更小时数后的日期时间
  - addMinute
```
public static Date addMinute(Date date,
                             int minute)
```
    指定日期加减分钟
    
    参数:
    
    date - 指定日期时间
    
    minute - 变更分钟数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更分钟数后的日期时间
  - addSecond
```
public static Date addSecond(Date date,
                             int second)
```
    指定日期加减秒
    
    参数:
    
    date - 指定日期时间
    
    second - 变更秒数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更秒数后的日期时间
  - addMillisecond
```
public static Date addMillisecond(Date date,
                                  int millisecond)
```
    指定日期加减秒
    
    参数:
    
    date - 指定日期时间
    
    millisecond - 变更毫秒数（大于 0 时增加，小于 0 时减少）
    
    返回:
    
    变更毫秒数后的日期时间
  - getWeekDate
```
public static Date getWeekDate(Date date,
                               WeekDay weekDay)
```
    获取该日期所在周指定星期的日期
    
    参数:
    
    date - 日期所在时间
    
    返回:
    
    index 指定星期（1 - 7 分别对应星期一到星期天）
  - getWeekDateStart
```
public static Date getWeekDateStart(Date date)
```
    获取该日期所在周开始日期
    
    参数:
    
    date - 日期所在时间
    
    返回:
    
    所在周开始日期
  - getWeekDateEnd
```
public static Date getWeekDateEnd(Date date)
```
    获取该日期所在周开始日期
    
    参数:
    
    date - 日期所在时间
    
    返回:
    
    所在周开始日期
  - getWeekDateList
```
public static List<Date> getWeekDateList(Date date)
```
    获取该日期所在周的所有日期（周一到周日）
    
    参数:
    
    date - 日期
    
    返回:
    
    该日照所在周的所有日期
  - getWeekDateList
```
public static List<String> getWeekDateList(String dateString)
```
    获取该日期所在周的所有日期（周一到周日）
    
    参数:
    
    dateString -
    
    返回:
    
    该日照所在周的所有日期
  - getMonthDateList
```
public static List<Date> getMonthDateList(Date date)
```
    获取该日期所在月的所有日期
    
    参数:
    
    date -
    
    返回:
    
    该日照所月的所有日期
  - getMonthDateList
```
public static List<String> getMonthDateList(String dateString)
```
    获取该日期所在月的所有日期
    
    参数:
    
    dateString -
    
    返回:
    
    该日照所月的所有日期
  - getMonthDateStart
```
public static Date getMonthDateStart(Date date)
```
    获取本日期所在月第一天
    
    参数:
    
    date - 日期
    
    返回:
    
    本日期所在月第一天
  - getMonthDateEnd
```
public static Date getMonthDateEnd(Date date)
```
    获取本日期所在月最后一天
    
    参数:
    
    date - 日期
    
    返回:
    
    本日期所在月最后一天
  - compareDays
```
public static Integer compareDays(Date date1,
                                  Date date2)
```
    比较两个日期的大小 (毫秒级)
    
    参数:
    
    date1 - 日期1
    
    date2 - 日期2
    
    返回:
    
    返回值: 1, 前者大于后者; 0, 两者相同; -1, 前者小于后者; null, 日期中有空
  - countBetweenDays
```
public static int countBetweenDays(Date date1,
                                   Date date2)
```
    获取两个日期相差的天数（以日期为单位计算，不以24小时制计算，详见下面说明）
    
    【说明】比如 2022-06-17 23:00:00 和 2022-06-17 01:00:00，两者虽然只相差 2 个小时，但也算相差 1 天
    
    参数:
    
    date1 - 日期1
    
    date2 - 日期2
    
    返回:
    
    相差天数（若返回 -1，则至少有一个日期存在为空，此时不能进行比较）
  - getBetweenDateList
```
public static List<Date> getBetweenDateList(Date date1,
                                            Date date2)
```
    获取两个日期之间的所有日期
    
    参数:
    
    date1 - 日期1
    
    date2 - 日期2
    
    返回:
    
    两个日期之间的所有日期的开始时间
  - getBetweenDateList
```
public static List<Date> getBetweenDateList(Date date1,
                                            Date date2,
                                            boolean isContainParams)
```
    获取两个日期之间的所有日期
    
    参数:
    
    date1 - 日期1
    
    date2 - 日期2
    
    返回:
    
    两个日期之间的所有日期的开始时间
  - getBetweenDateList
```
public static List<String> getBetweenDateList(String dateString1,
                                              String dateString2)
```
    获取两个日期之间的所有日期
    
    参数:
    
    dateString1 - 日期1（如：2022-06-20）
    
    dateString2 - 日期2（如：2022-07-15）
    
    返回:
    
    两个日期之间的所有日期（不包含参数日期）
  - getBetweenDateList
```
public static List<String> getBetweenDateList(String dateString1,
                                              String dateString2,
                                              boolean isContainParams)
```
    获取两个日期之间的所有日期
    
    参数:
    
    dateString1 - 日期1（如：2022-06-20）
    
    dateString2 - 日期2（如：2022-07-15）
    
    isContainParams - 是否包含参数的两个日期
    
    返回:
    
    两个日期之间的所有日期的开始时间
  - ageOfNow
```
public static int ageOfNow(String birthDay,
                           String formatStyle)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日，标准日期字符串
    
    返回:
    
    年龄
  - ageOfNow
```
public static int ageOfNow(Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日
    
    返回:
    
    年龄
  - age
```
public static int age(Date birthday,
                      Date dateToCompare)
```
    计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄
    
    参数:
    
    birthday - 生日
    
    dateToCompare - 需要对比的日期
    
    返回:
    
    年龄
  - age
```
protected static int age(long birthday,
                         long dateToCompare)
```
    计算相对于dateToCompare的年龄，常用于计算指定生日在某年的年龄
    按照《最高人民法院关于审理未成年人刑事案件具体应用法律若干问题的解释》第二条规定刑法第十七条规定的“周岁”，按照公历的年、月、日计算，从周岁生日的第二天起算。
    - 2022-03-01出生，则相对2023-03-01，周岁为0，相对于2023-03-02才是1岁。
    - 1999-02-28出生，则相对2000-02-29，周岁为1
    参数:
    
    birthday - 生日
    
    dateToCompare - 需要对比的日期
    
    返回:
    
    年龄
  - getDateStrList
```
public static List<String> getDateStrList(List<Date> dates)
```
    List 转 List
    
    参数:
    
    dates - 日期集合
    
    返回:
    
    日期字符串集合
  - convertMillisecond2TimeStr
```
public static String convertMillisecond2TimeStr(long millisecond)
```
  - convertSecond2TimeStr
```
public static String convertSecond2TimeStr(long second)
```
  - convertMinute2TimeStr
```
public static String convertMinute2TimeStr(long minute)
```

类 DateUtils

嵌套类概要

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

simpleDateFormatMap

构造器详细资料

DateUtils

方法详细资料

p_getSimpleDateFormat

format

formatDate

formatDateTimeSecond

formatDateTimeMillisecond

parseDate

parseDateTimeSecond

parseDateTimeMillisecond

parse

p_getString

getDateStart

getDateEnd

getDateNo

getDateTimeSecond

getDateTimeMillisecond

getTimestampSecond

getTimestampMillisecond

p_getWeek

p_getWeek

getWeekOfYear

getWeekOfYearIgnoreLastYear

getDateNode

add

addYear

addMonth

addDay

addWeek

addHour

addMinute

addSecond

addMillisecond

getWeekDate

getWeekDateStart

getWeekDateEnd

getWeekDateList

getWeekDateList

getMonthDateList

getMonthDateList

getMonthDateStart

getMonthDateEnd

compareDays

countBetweenDays

getBetweenDateList

getBetweenDateList

getBetweenDateList

getBetweenDateList

ageOfNow

ageOfNow

age

age

getDateStrList

convertMillisecond2TimeStr

convertSecond2TimeStr

convertMinute2TimeStr