DateCalcUtils (mzlion-core 1.1.0 API)

java.lang.Object
- com.mzlion.core.date.DateCalcUtils

```
public class DateCalcUtils
extends Object
```
日期计算工具类，该类主要值对Date增改查【添加、修改、获取年月日时分秒】。还提供了两个日期之间相差月、天数计算。如果需要使用日期格式化、解析请查看DateUtils.

作者:

mzlion on 2016-04-16

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Date`	`addDate(Date date, int day)` 给指定日期加（减）天数比如时间2014-05-12 12:00:00 DateCalcUtils.addDate(date,1); 2014-05-11 12:00:00 比如时间2014-05-12 12:00:00 DateCalcUtils.addDate(date,-1); 2014-05-13 12:00:00
`static Date`	`addHour(Date date, int hours)` 给指定日期加（减）小时数比如时间2014-05-12 12:00:00 DateCalcUtils.addHour(date,1); 2014-05-12 13:00:00 比如时间2014-05-12 12:00:00 DateCalcUtils.addHour(date,-1); 2014-05-12 11:00:00
`static Date`	`addMilliSecond(Date date, int milliSecond)` 给指定时间加/减毫秒数
`static Date`	`addMinute(Date date, int minutes)` 给指定日期加（减）分钟数比如时间2014-05-12 12:00:00 DateCalcUtils.addMinute(date,2); 2014-05-12 12:02:00 比如时间2014-05-12 12:00:00 DateCalcUtils.addMinute(date,-2); 2014-05-12 11:58:00
`static Date`	`addMonth(Date date, int months)` 给指定日期加（减）月数比如时间2014-05-12 12:10:00 DateCalcUtils.addMonth(date,1); 2014-06-12 12:10:00 比如时间2014-05-12 12:10:00 DateCalcUtils.addMonth(date,-1); 2014-04-12 12:10:00
`static Date`	`addMonth(Date date, int months, boolean escapeDays)` 给指定日期加（减）月数比如时间2014-05-12 12:10:00 DateCalcUtils.addMonth(date,1,false); 2014-06-12 12:10:00 比如时间2014-05-12 12:10:00 DateCalcUtils.addMonth(date,1,true); 2014-06-01 00:00:00
`static Date`	`addSecond(Date date, int seconds)` 给指定日期加（减）秒数比如时间2014-05-12 12:00:00 DateCalcUtils.addSecond(date,2); 2014-05-12 12:00:02 比如时间2014-05-12 12:00:00 DateCalcUtils.addSecond(date,-2); 2014-05-12 11:59:58
`static Date`	`addYear(Date date, int years)` 给指定日期加（减）年份数比如时间2014-05-12 12:10:00 DateCalcUtils.addYear(date,1); 2015-06-12 12:10:00 比如时间2014-05-12 12:10:00 DateCalcUtils.addYear(date,-1); 2013-04-12 12:10:00
`static int`	`dateDiff(int datePart, Date startDate, Date endDate)`
`static int`	`get12Hour(Date date)` 从日期中获取小时（12制）比如时间2014-05-12 22:10:00 DateCalcUtils.get12Hour(date); 10
`static int`	`get24Hour(Date date)` 从日期中获取小时（24制）比如时间2014-05-12 22:10:00 DateCalcUtils.get24Hour(date); 22
`static Date`	`getBeginDayInMonth(Date date)` 从日期中获取月份第一天比如时间2014-05-12 DateCalcUtils.getBeginDayInMonth("2014-05-12","yyyy-MM-dd"); 204-05-01
`static int`	`getDay(Date date)` 从日期中获取天比如时间2014-05-12 12:10:00 DateCalcUtils.getDay(date); 12
`static int`	`getDaysBetween(Date start, Date end)` 计算两个日期之间相差的天数,测试发现还是有问题(没问题) 比如Date start = 2012-2-12 Date end = 2012-3-1 DateCalcUtils.getDaysBetween(start,end) 18
`static Date`	`getEndDayInMonth(Date date)` 从日期中获取月份最后一天比如时间2014-05-12 DateCalcUtils.getEndDayInMonth(date); 204-05-31
`static int`	`getMillisecond(Date date)` 从日期中获取毫秒比如时间2014-05-12 22:10:00 DateCalcUtils.getMillisecond(date); 151
`static int`	`getMinute(Date date)` 从日期中获取分钟比如时间2014-05-12 22:10:00 DateCalcUtils.getMinute(date); 10
`static int`	`getMonth(Date date)` 从日期中获取月份比如时间2014-05-12 12:10:00 DateCalcUtils.getMonth(date); 5
`static int`	`getMonthsBetween(Date start, Date end)` 计算两个日期之间相差的月份比如Date start = 2012-2-12 Date end = 2012-3-1 DateCalcUtils.getMonthsBetween(start,end) 1
`static int`	`getSecond(Date date)` 从日期中获取秒数比如时间2014-05-12 22:10:00 DateCalcUtils.getSecond(date); 0
`static long`	`getTimeMillis(Date date)` 获取时间的毫秒数，该毫秒是时间转换为毫秒，而不是日期时间中的转动的毫秒。
`static int`	`getYear(Date date)` 从日期中获取年份比如时间2014-05-12 12:10:00 DateCalcUtils.getYear(date); 2014
`static boolean`	`isLeapYear(Date date)` 判断是否是闰年，闰年规则：闰年查看比如时间2014-05-12 22:10:00 DateCalcUtils.isLeapYear(date); false

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

方法详细资料

addMilliSecond

public static Date addMilliSecond(Date date,
                                  int milliSecond)

给指定时间加/减毫秒数

参数:: date - 日期; milliSecond - 毫秒数
返回:: Date

addSecond

public static Date addSecond(Date date,
                             int seconds)

给指定日期加（减）秒数

     比如时间2014-05-12 12:00:00  DateCalcUtils.addSecond(date,2); 2014-05-12 12:00:02
     比如时间2014-05-12 12:00:00  DateCalcUtils.addSecond(date,-2); 2014-05-12 11:59:58

参数:: date - 日期; seconds - 秒，如果为正整数则添加，否则相减
返回:: Date

addMinute

public static Date addMinute(Date date,
                             int minutes)

给指定日期加（减）分钟数

     比如时间2014-05-12 12:00:00  DateCalcUtils.addMinute(date,2); 2014-05-12 12:02:00
     比如时间2014-05-12 12:00:00  DateCalcUtils.addMinute(date,-2); 2014-05-12 11:58:00

参数:: date - 日期; minutes - 分钟，如果为正整数则添加，否则相减
返回:: Date

addHour

public static Date addHour(Date date,
                           int hours)

给指定日期加（减）小时数

     比如时间2014-05-12 12:00:00  DateCalcUtils.addHour(date,1); 2014-05-12 13:00:00
     比如时间2014-05-12 12:00:00  DateCalcUtils.addHour(date,-1); 2014-05-12 11:00:00

参数:: date - 日期; hours - 小时，如果为正整数则添加，否则相减
返回:: Date

addDate

public static Date addDate(Date date,
                           int day)

给指定日期加（减）天数

     比如时间2014-05-12 12:00:00  DateCalcUtils.addDate(date,1); 2014-05-11 12:00:00
     比如时间2014-05-12 12:00:00  DateCalcUtils.addDate(date,-1); 2014-05-13 12:00:00

参数:: date - 日期; day - 天，如果为正整数则添加，否则相减
返回:: Date

addMonth

public static Date addMonth(Date date,
                            int months)

给指定日期加（减）月数

     比如时间2014-05-12 12:10:00  DateCalcUtils.addMonth(date,1); 2014-06-12 12:10:00
     比如时间2014-05-12 12:10:00  DateCalcUtils.addMonth(date,-1); 2014-04-12 12:10:00

参数:: date - 日期; months - 月，如果为正整数则添加，否则相减
返回:: Date

addMonth

public static Date addMonth(Date date,
                            int months,
                            boolean escapeDays)

给指定日期加（减）月数

     比如时间2014-05-12 12:10:00  DateCalcUtils.addMonth(date,1,false); 2014-06-12 12:10:00
     比如时间2014-05-12 12:10:00  DateCalcUtils.addMonth(date,1,true);  2014-06-01 00:00:00

参数:: date - 日期; months - 月，如果为正整数则添加，否则相减; escapeDays - 如果值为true则表示会清空时分秒毫秒，并且日期跳到当月的第一天；如果是false则不会
返回:: Date

addYear

public static Date addYear(Date date,
                           int years)

给指定日期加（减）年份数

     比如时间2014-05-12 12:10:00  DateCalcUtils.addYear(date,1); 2015-06-12 12:10:00
     比如时间2014-05-12 12:10:00  DateCalcUtils.addYear(date,-1); 2013-04-12 12:10:00

参数:: date - 日期; years - 年，如果为正整数则添加，否则相减
返回:: Date

getYear

public static int getYear(Date date)

从日期中获取年份

     比如时间2014-05-12 12:10:00  DateCalcUtils.getYear(date); 2014

参数:: date - 日期对象
返回:: 年份

getMonth

public static int getMonth(Date date)

从日期中获取月份

     比如时间2014-05-12 12:10:00  DateCalcUtils.getMonth(date); 5

参数:: date - 日期对象
返回:: 月份

getDay

public static int getDay(Date date)

从日期中获取天

     比如时间2014-05-12 12:10:00  DateCalcUtils.getDay(date); 12

参数:: date - 日期对象
返回:: 天

get24Hour

public static int get24Hour(Date date)

从日期中获取小时（24制）

     比如时间2014-05-12 22:10:00  DateCalcUtils.get24Hour(date); 22

参数:: date - 日期对象
返回:: 小时（24制）

get12Hour

public static int get12Hour(Date date)

从日期中获取小时（12制）

     比如时间2014-05-12 22:10:00  DateCalcUtils.get12Hour(date); 10

参数:: date - 日期对象
返回:: 小时（12制）

getMinute

public static int getMinute(Date date)

从日期中获取分钟

     比如时间2014-05-12 22:10:00  DateCalcUtils.getMinute(date); 10

参数:: date - 日期对象
返回:: 分钟

getSecond

public static int getSecond(Date date)

从日期中获取秒数

     比如时间2014-05-12 22:10:00  DateCalcUtils.getSecond(date); 0

参数:: date - 日期对象
返回:: 秒数

getMillisecond

public static int getMillisecond(Date date)

从日期中获取毫秒

     比如时间2014-05-12 22:10:00  DateCalcUtils.getMillisecond(date); 151

参数:: date - 日期对象
返回:: 毫秒

getTimeMillis
```
public static long getTimeMillis(Date date)
```
获取时间的毫秒数，该毫秒是时间转换为毫秒，而不是日期时间中的转动的毫秒。
```
     比如时间2014-05-12 22:10:00  DateCalcUtils.getTimeMillis(date); 1402582200732L
 
```
参数:

date - 日期对象

返回:

毫秒数

isLeapYear

public static boolean isLeapYear(Date date)

判断是否是闰年，闰年规则：闰年查看

     比如时间2014-05-12 22:10:00  DateCalcUtils.isLeapYear(date); false

参数:: date - 日期对象
返回:: 是否为闰年

getBeginDayInMonth

public static Date getBeginDayInMonth(Date date)

从日期中获取月份第一天

     比如时间2014-05-12  DateCalcUtils.getBeginDayInMonth("2014-05-12","yyyy-MM-dd"); 204-05-01

参数:: date - 日期
返回:: 每月第一天

getEndDayInMonth

public static Date getEndDayInMonth(Date date)

从日期中获取月份最后一天

     比如时间2014-05-12  DateCalcUtils.getEndDayInMonth(date); 204-05-31

参数:: date - 日期对象
返回:: 每月最后一天

getDaysBetween

public static int getDaysBetween(Date start,
                                 Date end)

计算两个日期之间相差的天数,测试发现还是有问题(没问题)

     比如Date start = 2012-2-12
     Date end = 2012-3-1
     DateCalcUtils.getDaysBetween(start,end)  18

参数:: start - 日期对象; end - 日期对象
返回:: 天数

getMonthsBetween

public static int getMonthsBetween(Date start,
                                   Date end)

计算两个日期之间相差的月份

     比如Date start = 2012-2-12
     Date end = 2012-3-1
     DateCalcUtils.getMonthsBetween(start,end)  1

参数:: start - 日期对象; end - 日期对象
返回:: 月份

dateDiff

public static int dateDiff(int datePart,
                           Date startDate,
                           Date endDate)

类 DateCalcUtils

方法概要

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

方法详细资料

addMilliSecond

addSecond

addMinute

addHour

addDate

addMonth

addMonth

addYear

getYear

getMonth

getDay

get24Hour

get12Hour

getMinute

getSecond

getMillisecond

getTimeMillis

isLeapYear

getBeginDayInMonth

getEndDayInMonth

getDaysBetween

getMonthsBetween

dateDiff