DateUtils (noark-core 3.3.2.Final API)

java.lang.Object
- xyz.noark.core.util.DateUtils

```
public class DateUtils
extends java.lang.Object
```
时间相关操作工具类.

从以下版本开始:

3.0

作者:

小流氓(176543888@qq.com)

字段概要

字段
限定符和类型	字段和说明
`static int`	`HOUR_PER_DAY` 每天有24小时
`static int`	`MILLISECOND_PER_SECOND` 每秒有1000毫秒
`static int`	`MINUTE_PER_HOUR` 每小时有60分钟
`static int`	`SECOND_PER_MINUTE` 每分钟有60秒

构造器概要

构造器
构造器和说明

DateUtils()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static java.util.Date`	`addDays(java.util.Date date, int amount)` Adds a number of days to a date returning a new object.
`static java.util.Date`	`addHours(java.util.Date date, int amount)` Adds a number of hours to a date returning a new object.
`static java.util.Date`	`addMilliseconds(java.util.Date date, int amount)` Adds a number of milliseconds to a date returning a new object.
`static java.util.Date`	`addMinutes(java.util.Date date, int amount)` Adds a number of minutes to a date returning a new object.
`static java.util.Date`	`addMonths(java.util.Date date, int amount)` Adds a number of months to a date returning a new object.
`static java.util.Date`	`addSeconds(java.util.Date date, int amount)` Adds a number of seconds to a date returning a new object.
`static java.util.Date`	`addWeeks(java.util.Date date, int amount)` Adds a number of weeks to a date returning a new object.
`static java.util.Date`	`addYears(java.util.Date date, int amount)` Adds a number of years to a date returning a new object.
`static long`	`diffDays(java.util.Date date1, java.util.Date date2)` 计算两个Date对象之间相差多少天.
`static long`	`diffSeconds(java.util.Date date1, java.util.Date date2)` 计算两个Date对象之间相差多少秒.
`static java.lang.String`	`formatTime(long seconds)` 将一个秒数格式化为一个时间格式 HH:mm:ss 游戏中规则显示，用于格式参数等格式秒数
`static boolean`	`isSameDay(java.util.Calendar cal1, java.util.Calendar cal2)` Checks if two calendar objects are on the same day ignoring time.
`static boolean`	`isSameDay(java.util.Date date1, java.util.Date date2)` 判断两个日期时间是否是同一天。
`static boolean`	`isSameMonth(java.util.Calendar cal1, java.util.Calendar cal2)` 判定两个日期是否为同年同月份
`static boolean`	`isSameMonth(java.util.Date date1, java.util.Date date2)` 判断两个日期时间是否是同年同月份
`static boolean`	`isSameWeek(java.util.Calendar cal1, java.util.Calendar cal2)` 判定两个日期是否为同周
`static boolean`	`isSameWeek(java.util.Date date1, java.util.Date date2)` 判断两个日期时间是否是同周
`static long`	`toDays(java.util.Date date)` 将Date对象转化为天数.
`static long`	`toDays(long milliseconds)` 将毫秒数转化为天数.
`static long`	`toSeconds(java.util.Date date)` 将Date对象转化为秒数.
`static long`	`toSeconds(long milliseconds)` 将毫秒数转化为秒数.
`static long`	`toSecondsByStartOfDay(java.time.LocalDate localDate)` 获取指定日期那天的开始时间并转化为秒数

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

- 字段详细资料
  - MILLISECOND_PER_SECOND
```
public static final int MILLISECOND_PER_SECOND
```
    每秒有1000毫秒
    
    另请参阅:
    
    常量字段值
  - SECOND_PER_MINUTE
```
public static final int SECOND_PER_MINUTE
```
    每分钟有60秒
    
    另请参阅:
    
    常量字段值
  - MINUTE_PER_HOUR
```
public static final int MINUTE_PER_HOUR
```
    每小时有60分钟
    
    另请参阅:
    
    常量字段值
  - HOUR_PER_DAY
```
public static final int HOUR_PER_DAY
```
    每天有24小时
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DateUtils
```
public DateUtils()
```
- 方法详细资料
  - isSameDay
```
public static boolean isSameDay(java.util.Date date1,
                                java.util.Date date2)
```
    判断两个日期时间是否是同一天。
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    返回:
    
    如果是同一天返回true,否则返回false
  - isSameDay
```
public static boolean isSameDay(java.util.Calendar cal1,
                                java.util.Calendar cal2)
```
    Checks if two calendar objects are on the same day ignoring time.
    
    28 Mar 2002 13:45 and 28 Mar 2002 06:01 would return true. 28 Mar 2002 13:45 and 12 Mar 2002 13:45 would return false.
    
    参数:
    
    cal1 - the first calendar, not altered, not null
    
    cal2 - the second calendar, not altered, not null
    
    返回:
    
    true if they represent the same day
    
    抛出:
    
    java.lang.IllegalArgumentException - if either calendar is null
  - isSameWeek
```
public static boolean isSameWeek(java.util.Date date1,
                                 java.util.Date date2)
```
    判断两个日期时间是否是同周
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    返回:
    
    如果是同周返回true,否则返回false
  - isSameWeek
```
public static boolean isSameWeek(java.util.Calendar cal1,
                                 java.util.Calendar cal2)
```
    判定两个日期是否为同周
    
    参数:
    
    cal1 - 第一个日期
    
    cal2 - 第二个日期
    
    返回:
    
    如果是同周返回true,否则返回false
  - isSameMonth
```
public static boolean isSameMonth(java.util.Date date1,
                                  java.util.Date date2)
```
    判断两个日期时间是否是同年同月份
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    返回:
    
    如果是同一个月份返回true,否则返回false
  - isSameMonth
```
public static boolean isSameMonth(java.util.Calendar cal1,
                                  java.util.Calendar cal2)
```
    判定两个日期是否为同年同月份
    
    参数:
    
    cal1 - 第一个日期
    
    cal2 - 第二个日期
    
    返回:
    
    如果是同一个月份返回true,否则返回false
  - addYears
```
public static java.util.Date addYears(java.util.Date date,
                                      int amount)
```
    Adds a number of years to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMonths
```
public static java.util.Date addMonths(java.util.Date date,
                                       int amount)
```
    Adds a number of months to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addWeeks
```
public static java.util.Date addWeeks(java.util.Date date,
                                      int amount)
```
    Adds a number of weeks to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addDays
```
public static java.util.Date addDays(java.util.Date date,
                                     int amount)
```
    Adds a number of days to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addHours
```
public static java.util.Date addHours(java.util.Date date,
                                      int amount)
```
    Adds a number of hours to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMinutes
```
public static java.util.Date addMinutes(java.util.Date date,
                                        int amount)
```
    Adds a number of minutes to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addSeconds
```
public static java.util.Date addSeconds(java.util.Date date,
                                        int amount)
```
    Adds a number of seconds to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - addMilliseconds
```
public static java.util.Date addMilliseconds(java.util.Date date,
                                             int amount)
```
    Adds a number of milliseconds to a date returning a new object. The original Date is unchanged.
    
    参数:
    
    date - the date, not null
    
    amount - the amount to add, may be negative
    
    返回:
    
    the new Date with the amount added
    
    抛出:
    
    java.lang.IllegalArgumentException - if the date is null
  - toSeconds
```
public static long toSeconds(java.util.Date date)
```
    将Date对象转化为秒数.
    为了代码里不要到处出现Date.getTime() / 1000的情况
    
    参数:
    
    date - Date日期
    
    返回:
    
    返回这个日期所对应的秒数
  - toSeconds
```
public static long toSeconds(long milliseconds)
```
    将毫秒数转化为秒数.
    为了代码里不要到处出现Date.getTime() / 1000的情况
    
    参数:
    
    milliseconds - 毫秒数
    
    返回:
    
    返回这个毫秒数所对应的秒数
  - toSecondsByStartOfDay
```
public static long toSecondsByStartOfDay(java.time.LocalDate localDate)
```
    获取指定日期那天的开始时间并转化为秒数
    
    参数:
    
    localDate - 指定日期
    
    返回:
    
    返回指定日期那天的开始时间并转化为秒数
  - toDays
```
public static long toDays(java.util.Date date)
```
    将Date对象转化为天数.
    
    参数:
    
    date - Date日期
    
    返回:
    
    返回这个日期所对应的天数
  - toDays
```
public static long toDays(long milliseconds)
```
    将毫秒数转化为天数.
    
    参数:
    
    milliseconds - 毫秒数
    
    返回:
    
    返回这个毫秒数所对应的天数
  - diffSeconds
```
public static long diffSeconds(java.util.Date date1,
                               java.util.Date date2)
```
    计算两个Date对象之间相差多少秒.
    
    参数:
    
    date1 - 时间一
    
    date2 - 时间二
    
    返回:
    
    秒数差，如果时间2大于时间1，有可能会是负值噢.
  - diffDays
```
public static long diffDays(java.util.Date date1,
                            java.util.Date date2)
```
    计算两个Date对象之间相差多少天.
    由于使用毫秒计算的方式，所以计算天数需要处理时区问题...
    
    参数:
    
    date1 - 时间一
    
    date2 - 时间二
    
    返回:
    
    天数差，如果时间2大于时间1，有可能会是负值噢.
  - formatTime
```
public static java.lang.String formatTime(long seconds)
```
    将一个秒数格式化为一个时间格式 HH:mm:ss
    游戏中规则显示，用于格式参数等格式秒数
    
    参数:
    
    seconds - 一个毫秒数
    
    返回:
    
    时间格式 HH:mm:ss

类 DateUtils

字段概要

构造器概要

方法概要

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

字段详细资料

MILLISECOND_PER_SECOND

SECOND_PER_MINUTE

MINUTE_PER_HOUR

HOUR_PER_DAY

构造器详细资料

DateUtils

方法详细资料

isSameDay

isSameDay

isSameWeek

isSameWeek

isSameMonth

isSameMonth

addYears

addMonths

addWeeks

addDays

addHours

addMinutes

addSeconds

addMilliseconds

toSeconds

toSeconds

toSecondsByStartOfDay

toDays

toDays

diffSeconds

diffDays

formatTime