DateUtils (noark-core 3.4.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 float`	`formatNanoTime(long nanoTime)` 把纳秒转化为毫秒显示（保留小数点后面两位）
`static java.lang.String`	`formatTime(long seconds)` 将一个秒数格式化为一个时间格式 HH:mm:ss 游戏中规则显示，用于格式参数等格式秒数
`static java.util.Date`	`from(java.time.LocalDateTime localDateTime)` LocalDateTime对象转回Date对象.
`static java.time.DayOfWeek`	`getDayOfWeek(java.util.Date date)` 获取指定日期的星期几属性，返回枚举结果`DayOfWeek`
`static java.util.Date`	`getStartOfDay(java.util.Date date)` 获取指定时间那天的开始时间
`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`	`isSameDay(java.util.Date date1, java.util.Date date2, int offset)` 判断两个日期时间是否是同一天，带秒钟偏移值例如：需要在次日的5点刷新，offset传值为 5*3600 = 18000
`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.Date date1, java.util.Date date2)` 判断两个日期时间是否是同周。
`static boolean`	`isSameWeek(java.util.Date date1, java.util.Date date2, java.time.temporal.WeekFields weekFields)` 判断两个日期时间是否是同周 WeekFields.ISO代表每周从周一开始算。
`static boolean`	`isSameWeek(java.time.LocalDate date1, java.time.LocalDate date2)` 判断两个日期时间是否是同周.
`static boolean`	`isSameWeek(java.time.LocalDate date1, java.time.LocalDate date2, java.time.temporal.WeekFields weekFields)` 判断两个日期时间是否是同周.
`static long`	`toDays(java.util.Date date)` 将Date对象转化为天数.
`static long`	`toDays(long milliseconds)` 将毫秒数转化为天数.
`static java.time.LocalDate`	`toLocalDate(java.util.Date date)` Date对象转化为LocalDate对象。
`static java.time.LocalDateTime`	`toLocalDateTime(java.util.Date date)` Date对象转化为LocalDateTime对象
`static java.time.LocalTime`	`toLocalTime(java.util.Date date)` Date对象转化为LocalTime对象
`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.Date date1,
                                java.util.Date date2,
                                int offset)
```
    判断两个日期时间是否是同一天，带秒钟偏移值
    例如：需要在次日的5点刷新，offset传值为 5*3600 = 18000
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    offset - 秒钟偏移值
    
    返回:
    
    如果是同一天返回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.time.LocalDate date1,
                                 java.time.LocalDate date2)
```
    判断两个日期时间是否是同周.
    WeekFields.ISO代表每周从周一开始算。(默认)
    WeekFields.SUNDAY_START代表每周从周日开始算。
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    返回:
    
    如果是同周返回true, 否则返回false
  - isSameWeek
```
public static boolean isSameWeek(java.time.LocalDate date1,
                                 java.time.LocalDate date2,
                                 java.time.temporal.WeekFields weekFields)
```
    判断两个日期时间是否是同周.
    WeekFields.ISO代表每周从周一开始算。(建议)
    WeekFields.SUNDAY_START代表每周从周日开始算。
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    weekFields - 星期配置（建议使用ISO规范）
    
    返回:
    
    如果是同周返回true, 否则返回false
  - isSameWeek
```
public static boolean isSameWeek(java.util.Date date1,
                                 java.util.Date date2)
```
    判断两个日期时间是否是同周。
    WeekFields.ISO代表每周从周一开始算。(默认)
    WeekFields.SUNDAY_START代表每周从周日开始算。
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    返回:
    
    如果是同周返回true, 否则返回false
  - isSameWeek
```
public static boolean isSameWeek(java.util.Date date1,
                                 java.util.Date date2,
                                 java.time.temporal.WeekFields weekFields)
```
    判断两个日期时间是否是同周
    WeekFields.ISO代表每周从周一开始算。(建议)
    WeekFields.SUNDAY_START代表每周从周日开始算。
    
    参数:
    
    date1 - 第一个日期
    
    date2 - 第二个日期
    
    weekFields - 星期配置（建议使用ISO规范）
    
    返回:
    
    如果是同周返回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 - 毫秒数
    
    返回:
    
    返回这个毫秒数所对应的天数
  - toLocalDateTime
```
public static java.time.LocalDateTime toLocalDateTime(java.util.Date date)
```
    Date对象转化为LocalDateTime对象
    
    参数:
    
    date - Date对象
    
    返回:
    
    LocalDateTime对象
  - toLocalDate
```
public static java.time.LocalDate toLocalDate(java.util.Date date)
```
    Date对象转化为LocalDate对象。
    时间会丢掉了哈，要注意，转过去就回不来了
    
    参数:
    
    date - Date对象
    
    返回:
    
    LocalDate对象
  - toLocalTime
```
public static java.time.LocalTime toLocalTime(java.util.Date date)
```
    Date对象转化为LocalTime对象
    
    参数:
    
    date - Date对象
    
    返回:
    
    LocalTime对象
  - from
```
public static java.util.Date from(java.time.LocalDateTime localDateTime)
```
    LocalDateTime对象转回Date对象.
    
    参数:
    
    localDateTime - LocalDateTime对象
    
    返回:
    
    Date对象
  - 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
  - formatNanoTime
```
public static float formatNanoTime(long nanoTime)
```
    把纳秒转化为毫秒显示（保留小数点后面两位）
    
    参数:
    
    nanoTime - 纳秒
    
    返回:
    
    毫秒
  - getDayOfWeek
```
public static java.time.DayOfWeek getDayOfWeek(java.util.Date date)
```
    获取指定日期的星期几属性，返回枚举结果DayOfWeek
    
    参数:
    
    date - 指定日期
    
    返回:
    
    每周中的第几天，不为空
  - getStartOfDay
```
public static java.util.Date getStartOfDay(java.util.Date date)
```
    获取指定时间那天的开始时间
    
    参数:
    
    date - 指定时间
    
    返回:
    
    那天的开始时间

类 DateUtils

字段概要

构造器概要

方法概要

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

字段详细资料

MILLISECOND_PER_SECOND

SECOND_PER_MINUTE

MINUTE_PER_HOUR

HOUR_PER_DAY

构造器详细资料

DateUtils

方法详细资料

isSameDay

isSameDay

isSameDay

isSameWeek

isSameWeek

isSameWeek

isSameWeek

isSameMonth

isSameMonth

addYears

addMonths

addWeeks

addDays

addHours

addMinutes

addSeconds

addMilliseconds

toSeconds

toSeconds

toSecondsByStartOfDay

toDays

toDays

toLocalDateTime

toLocalDate

toLocalTime

from

diffSeconds

diffDays

formatTime

formatNanoTime

getDayOfWeek

getStartOfDay