DateTimeKit (toolset 1.4.RELEASE API)

java.lang.Object
- net.lulihu.dateTime.DateTimeKit

```
public class DateTimeKit
extends Object
```
时间工具类

字段概要

字段
限定符和类型	字段和说明
`static long`	`DAY_MS` 每天的毫秒数
`static long`	`HOUR_MS` 每小时的毫秒数
`static ThreadLocal<SimpleDateFormat>`	`HTTP_DATETIME_FORMAT` HTTP日期时间格式化器
`static String`	`HTTP_DATETIME_PATTERN` HTTP头中日期时间格式
`static long`	`MINUTE_MS` 每分钟的毫秒数
`static long`	`MS` 毫秒
`static ThreadLocal<SimpleDateFormat>`	`NORM_DATE_FORMAT` 标准日期（不含时间）格式化器
`static String`	`NORM_DATE_PATTERN` 标准日期格式
`static ThreadLocal<SimpleDateFormat>`	`NORM_DATETIME_FORMAT` 标准日期时间格式化器
`static ThreadLocal<SimpleDateFormat>`	`NORM_DATETIME_HOUR_FORMAT` 标准日期时间格式，精确到小时
`static String`	`NORM_DATETIME_HOUR_PATTERN` 标准日期时间格式，精确到小时
`static String`	`NORM_DATETIME_MINUTE_PATTERN` 标准日期时间格式，精确到分
`static String`	`NORM_DATETIME_MONTH_PATTERN` 标准日期时间格式，精确到月
`static String`	`NORM_DATETIME_MS_PATTERN` 标准日期时间格式，精确到毫秒
`static String`	`NORM_DATETIME_PATTERN` 标准日期时间格式，精确到秒
`static ThreadLocal<SimpleDateFormat>`	`NORM_TIME_FORMAT` 标准时间格式化器
`static String`	`NORM_TIME_PATTERN` 标准时间格式
`static long`	`SECOND_MS` 每秒钟的毫秒数

构造器概要

构造器
构造器和说明

DateTimeKit()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static int`	`age(Date birthDay, Date dateToCompare)` 计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
`static int`	`ageOfNow(Date birthDay)` 生日转为年龄，计算法定年龄
`static int`	`ageOfNow(String birthDay)` 生日转为年龄，计算法定年龄
`static long`	`current(boolean isNano)` 当前时间long
`static DateTime`	`date()`
`static DateTime`	`date(long date)` Long类型时间转为Date
`static long`	`diff(Date subtrahend, Date minuend, long diffField)` 判断两个日期相差的时长返回 minuend - subtrahend 的差
`static long`	`diffDay(Date subtrahend, Date minuend)` 判断两个日期相差的天数返回 minuend - subtrahend 的差
`static long`	`diffHour(Date subtrahend, Date minuend)` 判断两个日期相差的小时数返回 minuend - subtrahend 的差
`static long`	`diffMinute(Date subtrahend, Date minuend)` 判断两个日期相差的分钟数返回 minuend - subtrahend 的差
`static long`	`diffSecond(Date subtrahend, Date minuend)` 判断两个日期相差的秒数返回 minuend - subtrahend 的差
`static String`	`format(Date date, String format)` 根据特定格式格式化日期
`static String`	`formatDate(Date date)` 格式 yyyy-MM-dd
`static String`	`formatDateHour(Date date)` 格式 yyyy-MM-dd HH
`static String`	`formatDateTime(Date date)` 格式 yyyy-MM-dd HH:mm:ss
`static String`	`formatHttpDate(Date date)` 格式化为Http的标准日期格式
`static DateTime`	`getBeginTimeOfDay(Date date)` 获取某天的开始时间
`static DateTime`	`getBeginTimeOfMonth(Date date)` 获取某月的开始时间
`static DateTime`	`getEndTimeOfDay(Date date)` 获取某天的结束时间
`static Long`	`getSecondTime(Date date)` 获取精确到秒的时间戳
`static DateTime`	`lastMouth()` 上个月
`static DateTime`	`lastWeek()` 上周
`static int`	`month(Date date)` 获得月份，从1月开始计数
`static String`	`now()` 当前时间，格式 yyyy-MM-dd HH:mm:ss
`static DateTime`	`offsetDate(Date date, int calendarField, int offset)` 获取指定日期偏移指定时间后的时间
`static DateTime`	`offsetDay(Date date, int offset)` 偏移天
`static Date`	`offsetHour(Date date, int amount)` 指定日期增加（小时）
`static Date`	`offsetMinute(Date date, int amount)` 指定日期增加（分钟）
`static DateTime`	`offsetMonth(Date date, int offset)` 偏移月
`static DateTime`	`offsetSecond(Date date, int offset)` 偏移秒
`static DateTime`	`offsetWeek(Date date, int offset)` 偏移周
`static DateTime`	`offsetYear(Date date, int offset)` 偏移年
`static DateTime`	`parse(String dateStr)` 格式： 1、yyyy-MM-dd HH:mm:ss 2、yyyy-MM-dd 3、HH:mm:ss 4、yyyy-MM-dd HH:mm 5、yyyy-MM-dd HH:mm:ss.SSS
`static DateTime`	`parse(String dateStr, SimpleDateFormat simpleDateFormat)` 构建DateTime对象
`static DateTime`	`parse(String dateString, String format)` 将特定格式的日期转换为Date对象
`static DateTime`	`parseDate(String dateString)` 格式yyyy-MM-dd
`static DateTime`	`parseDateTime(String dateString)` 格式yyyy-MM-dd HH:mm:ss
`static DateTime`	`parseTime(String timeString)` 格式HH:mm:ss
`static DateTime`	`parseTimeMinutes(String dateString)` 格式yyyy-MM-dd HH:mm
`static int`	`season(Date date)` 获得季节
`static DateTime`	`secondTimeToDate(Long secondTime)` 精确到秒的时间戳转为 DateTime对象
`static long`	`spendMs(long preTime)` 计时，常用于记录某段代码的执行时间，单位：毫秒
`static long`	`spendNt(long preTime)` 计时，常用于记录某段代码的执行时间，单位：纳秒
`static int`	`thisMonth()`
`static int`	`thisYear()`
`static Timer`	`timer()` 计时器计算某个过程花费的时间，精确到毫秒
`static Calendar`	`toCalendar(Date date)` 转换为Calendar对象
`static String`	`today()` 当前日期，格式 yyyy-MM-dd
`static int`	`toIntSecond(Date date)` 格式化成yyMMddHHmm后转换为int型
`static int`	`weekCount(Date start, Date end)` 计算指定指定时间区间内的周数不能跨年
`static int`	`year(Date date)` 获得年
`static String`	`yearAndSeason(Date date)` 获得指定日期年份和季节格式：[20131]表示2013年第一季度
`static LinkedHashSet<String>`	`yearAndSeasons(Date startDate, Date endDate)` 获得指定日期区间内的年份和季节
`static DateTime`	`yesterday()` 昨天

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

- 字段详细资料
  - MS
```
public static final long MS
```
    毫秒
    
    另请参阅:
    
    常量字段值
  - SECOND_MS
```
public static final long SECOND_MS
```
    每秒钟的毫秒数
    
    另请参阅:
    
    常量字段值
  - MINUTE_MS
```
public static final long MINUTE_MS
```
    每分钟的毫秒数
    
    另请参阅:
    
    常量字段值
  - HOUR_MS
```
public static final long HOUR_MS
```
    每小时的毫秒数
    
    另请参阅:
    
    常量字段值
  - DAY_MS
```
public static final long DAY_MS
```
    每天的毫秒数
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_MONTH_PATTERN
```
public static final String NORM_DATETIME_MONTH_PATTERN
```
    标准日期时间格式，精确到月
    
    另请参阅:
    
    常量字段值
  - NORM_DATE_PATTERN
```
public static final String NORM_DATE_PATTERN
```
    标准日期格式
    
    另请参阅:
    
    常量字段值
  - NORM_TIME_PATTERN
```
public static final String NORM_TIME_PATTERN
```
    标准时间格式
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_HOUR_PATTERN
```
public static final String NORM_DATETIME_HOUR_PATTERN
```
    标准日期时间格式，精确到小时
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_MINUTE_PATTERN
```
public static final String NORM_DATETIME_MINUTE_PATTERN
```
    标准日期时间格式，精确到分
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_PATTERN
```
public static final String NORM_DATETIME_PATTERN
```
    标准日期时间格式，精确到秒
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_MS_PATTERN
```
public static final String NORM_DATETIME_MS_PATTERN
```
    标准日期时间格式，精确到毫秒
    
    另请参阅:
    
    常量字段值
  - HTTP_DATETIME_PATTERN
```
public static final String HTTP_DATETIME_PATTERN
```
    HTTP头中日期时间格式
    
    另请参阅:
    
    常量字段值
  - NORM_DATETIME_HOUR_FORMAT
```
public static final ThreadLocal<SimpleDateFormat> NORM_DATETIME_HOUR_FORMAT
```
    标准日期时间格式，精确到小时
  - NORM_DATE_FORMAT
```
public static final ThreadLocal<SimpleDateFormat> NORM_DATE_FORMAT
```
    标准日期（不含时间）格式化器
  - NORM_TIME_FORMAT
```
public static final ThreadLocal<SimpleDateFormat> NORM_TIME_FORMAT
```
    标准时间格式化器
  - NORM_DATETIME_FORMAT
```
public static final ThreadLocal<SimpleDateFormat> NORM_DATETIME_FORMAT
```
    标准日期时间格式化器
  - HTTP_DATETIME_FORMAT
```
public static final ThreadLocal<SimpleDateFormat> HTTP_DATETIME_FORMAT
```
    HTTP日期时间格式化器
- 构造器详细资料
  - DateTimeKit
```
public DateTimeKit()
```
- 方法详细资料
  - now
```
public static String now()
```
    当前时间，格式 yyyy-MM-dd HH:mm:ss
    
    返回:
    
    当前时间的标准形式字符串
  - current
```
public static long current(boolean isNano)
```
    当前时间long
    
    参数:
    
    isNano - 是否为高精度时间
    
    返回:
    
    时间
  - today
```
public static String today()
```
    当前日期，格式 yyyy-MM-dd
    
    返回:
    
    当前日期的标准形式字符串
  - thisMonth
```
public static int thisMonth()
```
    返回:
    
    当前月份
  - thisYear
```
public static int thisYear()
```
    返回:
    
    今年
  - date
```
public static DateTime date()
```
    返回:
    
    当前时间
  - date
```
public static DateTime date(long date)
```
    Long类型时间转为Date
    
    参数:
    
    date - Long类型Date（Unix时间戳）
    
    返回:
    
    时间对象
  - getSecondTime
```
public static Long getSecondTime(Date date)
```
    获取精确到秒的时间戳
  - secondTimeToDate
```
public static DateTime secondTimeToDate(Long secondTime)
```
    精确到秒的时间戳转为 DateTime对象
    
    参数:
    
    secondTime - 时间戳
    
    返回:
    
    DateTime
  - toCalendar
```
public static Calendar toCalendar(Date date)
```
    转换为Calendar对象
    
    参数:
    
    date - 日期对象
    
    返回:
    
    Calendar对象
  - month
```
public static int month(Date date)
```
    获得月份，从1月开始计数
    
    参数:
    
    date - 日期
    
    返回:
    
    月份
  - year
```
public static int year(Date date)
```
    获得年
    
    参数:
    
    date - 日期
    
    返回:
    
    年
  - season
```
public static int season(Date date)
```
    获得季节
    
    参数:
    
    date - 日期
    
    返回:
    
    第几个季节
  - yearAndSeason
```
public static String yearAndSeason(Date date)
```
    获得指定日期年份和季节
    格式：[20131]表示2013年第一季度
    
    参数:
    
    date - 日期
    
    返回:
    
    Season ，类似于 20132
  - yearAndSeasons
```
public static LinkedHashSet<String> yearAndSeasons(Date startDate,
                                                   Date endDate)
```
    获得指定日期区间内的年份和季节
    
    参数:
    
    startDate - 其实日期（包含）
    
    endDate - 结束日期（包含）
    
    返回:
    
    Season列表，元素类似于 20132
  - format
```
public static String format(Date date,
                            String format)
```
    根据特定格式格式化日期
    
    参数:
    
    date - 被格式化的日期
    
    format - 格式
    
    返回:
    
    格式化后的字符串
  - formatDateTime
```
public static String formatDateTime(Date date)
```
    格式 yyyy-MM-dd HH:mm:ss
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    格式化后的日期
  - formatDateHour
```
public static String formatDateHour(Date date)
```
    格式 yyyy-MM-dd HH
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    格式化后的字符串
  - formatDate
```
public static String formatDate(Date date)
```
    格式 yyyy-MM-dd
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    格式化后的字符串
  - formatHttpDate
```
public static String formatHttpDate(Date date)
```
    格式化为Http的标准日期格式
    
    参数:
    
    date - 被格式化的日期
    
    返回:
    
    HTTP标准形式日期字符串
  - parse
```
public static DateTime parse(String dateStr,
                             SimpleDateFormat simpleDateFormat)
```
    构建DateTime对象
    
    参数:
    
    dateStr - Date字符串
    
    simpleDateFormat - 格式化器
    
    返回:
    
    DateTime对象
  - parse
```
public static DateTime parse(String dateString,
                             String format)
```
    将特定格式的日期转换为Date对象
    
    参数:
    
    dateString - 特定格式的日期
    
    format - 格式，例如yyyy-MM-dd
    
    返回:
    
    日期对象
  - parseTimeMinutes
```
public static DateTime parseTimeMinutes(String dateString)
```
    格式yyyy-MM-dd HH:mm
    
    参数:
    
    dateString - 标准形式的时间字符串
    
    返回:
    
    日期对象
  - parseDateTime
```
public static DateTime parseDateTime(String dateString)
```
    格式yyyy-MM-dd HH:mm:ss
    
    参数:
    
    dateString - 标准形式的时间字符串
    
    返回:
    
    日期对象
  - parseDate
```
public static DateTime parseDate(String dateString)
```
    格式yyyy-MM-dd
    
    参数:
    
    dateString - 标准形式的日期字符串
    
    返回:
    
    日期对象
  - parseTime
```
public static DateTime parseTime(String timeString)
```
    格式HH:mm:ss
    
    参数:
    
    timeString - 标准形式的日期字符串
    
    返回:
    
    日期对象
  - parse
```
public static DateTime parse(String dateStr)
```
    格式：
    1、yyyy-MM-dd HH:mm:ss
    2、yyyy-MM-dd
    3、HH:mm:ss
    4、yyyy-MM-dd HH:mm 5、yyyy-MM-dd HH:mm:ss.SSS
    
    参数:
    
    dateStr - 日期字符串
    
    返回:
    
    日期
  - getBeginTimeOfMonth
```
public static DateTime getBeginTimeOfMonth(Date date)
```
    获取某月的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    某月的开始时间
  - getBeginTimeOfDay
```
public static DateTime getBeginTimeOfDay(Date date)
```
    获取某天的开始时间
    
    参数:
    
    date - 日期
    
    返回:
    
    某天的开始时间
  - getEndTimeOfDay
```
public static DateTime getEndTimeOfDay(Date date)
```
    获取某天的结束时间
    
    参数:
    
    date - 日期
    
    返回:
    
    某天的结束时间
  - yesterday
```
public static DateTime yesterday()
```
    昨天
    
    返回:
    
    昨天
  - lastWeek
```
public static DateTime lastWeek()
```
    上周
    
    返回:
    
    上周
  - lastMouth
```
public static DateTime lastMouth()
```
    上个月
    
    返回:
    
    上个月
  - offsetSecond
```
public static DateTime offsetSecond(Date date,
                                    int offset)
```
    偏移秒
    
    参数:
    
    date - 日期
    
    offset - 偏移秒数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetDay
```
public static DateTime offsetDay(Date date,
                                 int offset)
```
    偏移天
    
    参数:
    
    date - 日期
    
    offset - 偏移天数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetWeek
```
public static DateTime offsetWeek(Date date,
                                  int offset)
```
    偏移周
    
    参数:
    
    date - 日期
    
    offset - 偏移周数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetMonth
```
public static DateTime offsetMonth(Date date,
                                   int offset)
```
    偏移月
    
    参数:
    
    date - 日期
    
    offset - 偏移月数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetYear
```
public static DateTime offsetYear(Date date,
                                  int offset)
```
    偏移年
    
    参数:
    
    date - 日期
    
    offset - 偏移年数，正数向未来偏移，负数向历史偏移
    
    返回:
    
    偏移后的日期
  - offsetHour
```
public static Date offsetHour(Date date,
                              int amount)
```
    指定日期增加（小时）
    
    参数:
    
    date - 指定的一个原始日期
    
    amount - 数值增量
    
    返回:
    
    新日期
  - offsetMinute
```
public static Date offsetMinute(Date date,
                                int amount)
```
    指定日期增加（分钟）
    
    参数:
    
    date - 指定的一个原始日期
    
    amount - 数值增量
    
    返回:
    
    新日期
  - offsetDate
```
public static DateTime offsetDate(Date date,
                                  int calendarField,
                                  int offset)
```
    获取指定日期偏移指定时间后的时间
    
    参数:
    
    date - 基准日期
    
    calendarField - 偏移的粒度大小（小时、天、月等）使用Calendar中的常数
    
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    
    偏移后的日期
  - weekCount
```
public static int weekCount(Date start,
                            Date end)
```
    计算指定指定时间区间内的周数
    不能跨年
    
    参数:
    
    start - 开始时间
    
    end - 结束时间
    
    返回:
    
    周数
  - diffDay
```
public static long diffDay(Date subtrahend,
                           Date minuend)
```
    判断两个日期相差的天数
    返回 minuend - subtrahend 的差
    
    参数:
    
    subtrahend - 减数日期
    
    minuend - 被减数日期
    
    返回:
    
    日期差
  - diffMinute
```
public static long diffMinute(Date subtrahend,
                              Date minuend)
```
    判断两个日期相差的分钟数
    返回 minuend - subtrahend 的差
    
    参数:
    
    subtrahend - 减数日期
    
    minuend - 被减数日期
    
    返回:
    
    日期差
  - diffHour
```
public static long diffHour(Date subtrahend,
                            Date minuend)
```
    判断两个日期相差的小时数
    返回 minuend - subtrahend 的差
    
    参数:
    
    subtrahend - 减数日期
    
    minuend - 被减数日期
    
    返回:
    
    日期差
  - diffSecond
```
public static long diffSecond(Date subtrahend,
                              Date minuend)
```
    判断两个日期相差的秒数
    返回 minuend - subtrahend 的差
    
    参数:
    
    subtrahend - 减数日期
    
    minuend - 被减数日期
    
    返回:
    
    日期差
  - diff
```
public static long diff(Date subtrahend,
                        Date minuend,
                        long diffField)
```
    判断两个日期相差的时长
    返回 minuend - subtrahend 的差
    
    参数:
    
    subtrahend - 减数日期
    
    minuend - 被减数日期
    
    diffField - 相差的选项：相差的天、小时
    
    返回:
    
    日期差
  - spendNt
```
public static long spendNt(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：纳秒
    
    参数:
    
    preTime - 之前记录的时间
    
    返回:
    
    时间差，纳秒
  - spendMs
```
public static long spendMs(long preTime)
```
    计时，常用于记录某段代码的执行时间，单位：毫秒
    
    参数:
    
    preTime - 之前记录的时间
    
    返回:
    
    时间差，毫秒
  - toIntSecond
```
public static int toIntSecond(Date date)
```
    格式化成yyMMddHHmm后转换为int型
    
    参数:
    
    date - 日期
    
    返回:
    
    int
  - timer
```
public static Timer timer()
```
    计时器
    计算某个过程花费的时间，精确到毫秒
    
    返回:
    
    Timer
  - ageOfNow
```
public static int ageOfNow(String birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日，标准日期字符串
    
    返回:
    
    年龄
  - ageOfNow
```
public static int ageOfNow(Date birthDay)
```
    生日转为年龄，计算法定年龄
    
    参数:
    
    birthDay - 生日
    
    返回:
    
    年龄
  - age
```
public static int age(Date birthDay,
                      Date dateToCompare)
```
    计算相对于dateToCompare的年龄，长用于计算指定生日在某年的年龄
    
    参数:
    
    birthDay - 生日
    
    dateToCompare - 需要对比的日期
    
    返回:
    
    年龄

类 DateTimeKit

字段概要

构造器概要

方法概要

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

字段详细资料

MS

SECOND_MS

MINUTE_MS

HOUR_MS

DAY_MS

NORM_DATETIME_MONTH_PATTERN

NORM_DATE_PATTERN

NORM_TIME_PATTERN

NORM_DATETIME_HOUR_PATTERN

NORM_DATETIME_MINUTE_PATTERN

NORM_DATETIME_PATTERN

NORM_DATETIME_MS_PATTERN

HTTP_DATETIME_PATTERN

NORM_DATETIME_HOUR_FORMAT

NORM_DATE_FORMAT

NORM_TIME_FORMAT

NORM_DATETIME_FORMAT

HTTP_DATETIME_FORMAT

构造器详细资料

DateTimeKit

方法详细资料

now

current

today

thisMonth

thisYear

date

date

getSecondTime

secondTimeToDate

toCalendar

month

year

season

yearAndSeason

yearAndSeasons

format

formatDateTime

formatDateHour

formatDate

formatHttpDate

parse

parse

parseTimeMinutes

parseDateTime

parseDate

parseTime

parse

getBeginTimeOfMonth

getBeginTimeOfDay

getEndTimeOfDay

yesterday

lastWeek

lastMouth

offsetSecond

offsetDay

offsetWeek

offsetMonth

offsetYear

offsetHour

offsetMinute

offsetDate

weekCount

diffDay

diffMinute

diffHour

diffSecond

diff

spendNt

spendMs

toIntSecond

timer

ageOfNow

ageOfNow