转载

xk-time 1.1.3 发布，增加时间格式验证功能

xk-time 1.1.3 发布了，更新如下:

1.增加验证时间格式是否正确功能，支持验证yyyy-MM-dd和 yyyy-MM-dd HH:mm:ss 格式。

软件介绍：

xk-time is a datetime converter calculator formatter calendar and cron expression tool set, based on java8 date and time API, thread safe, easy to use.

时间转换，计算，格式化，解析，日历和cron表达式等的工具，使用java8，线程安全，简单易用，多达70几种常用日期格式化模板。

0.为什么要开发这个工具？

（1）java8以前的Date API设计不太好，使用不方便，往往会有线程安全问题。

xk-time工具包，使用java8 api，其中Instant、LocalDate、LocalDateTime、LocalTime、ZonedDateTime等都是线程安全的类，而且增加了更丰富的方法，在此基础上开发相关工具类，线程安全，让使用更方便。

（2）常见的DateUtil，往往将时间转换，计算，格式化，解析等功能都放在同一个类中，导致类功能复杂，方法太多，查找不方便。

xk-time工具包，将上面功能按照时间转换，时间计算，时间格式化解析分成3个工具类：DateTimeConverterUtil，DateTimeCalculatorUtil，DateTimeFormatterUtil，每个类只做一个种功能，方便使用。

（3）为了将与时间紧密相关的节假日、农历、二十四节气、十二星座和日历等功能集中起来开发成工具，方便使用。

1.Maven 坐标

<dependency>  
  <groupId>com.github.xkzhangsan</groupId>    
  <artifactId>xk-time</artifactId>       
  <version>1.1.3</version>    
</dependency>

2.日期转换工具类 DateTimeConverterUtil

包含Date、LocalDate、LocalDateTime、LocalTime、Instant、ZonedDateTime、YearMonth、Timestamp和long等互相转换

注意，ZonedDateTime相关的转换，尤其是其他时间转ZonedDateTime，要注意时间和对应时区一致。

详细使用可以查看相关测试代码。

3.日期计算工具类 DateTimeCalculatorUtil

包括：

（1）获取时间属性方法，get* 比如getYear(Date date) 获取年部分，getMonthCnLong(Date date)获取月份中文，getDayOfWeekCn(Date date)，获取星期中文。

（2）获取时间加操作方法，plus* 比如plusYears(Date date, long amountToAdd) 当前时间年增加amountToAdd值。

（3）获取时间减操作方法，minus* 比如minusYears(Date date, long amountToSubtract) 当前时间年减少amountToSubtract值。

（4）获取时间修改属性方法，with* 比如withYear(Date date, long newValue) 修改当前时间年值为newValue。

（5）获取比较2个时间方法，between* 比如betweenYears(Date startInclusive, Date endExclusive) 比较2个时间，获取年部分。

（6）其他常用方法，比如isLeapYear(Date date) 判断是否闰年，isWeekend(Date date) 判断是否周末，isExpiry(String yearMonthStr) 是否过期等

（7）时区转换计算方法，transform*，比如transform(ZonedDateTime zonedDateTime, String zoneId)

（8）比较2个时间大小和相等方法，compare*，比如compare(Date date1, Date date2)

（9）获取准确的起始时间方法，start*,end*，比如startTimeOfMonth() 当月起始时间当月第一天日期+00:00:00，endTimeOfMonth() 当月最后一天日期+23:59:59。

（10）相同月日比较判断方法，isSameMonthDay*，betweenNextSameMonthDay*，nextSameMonthDay*，比如用于生日，节日等周期性的日期比较判断。

（11）星座计算方法，getConstellation*，比如getConstellationNameCn(String monthDayStr)，根据日期计算星座。

（12）计算指定年月或起始时间区间的时间列表，get*List，比如getDateList(int year, int month)，计算指定年月的时间列表。

（13）减少时间精度方法，reduceAccuracyTo*，比如reduceAccuracyToDay(Date date)，减少时间精度到天，其他补0，返回如，2020-04-23 00:00:00。

（14）获取时间戳方法，getEpoch*，比如getEpochMilli()获取时间戳，getEpochMilliFormat()获取时间戳格式化字符串（yyyy-MM-dd HH:mm:ss）

（15）计算年龄方法，getAge*，比如getAge(Date birthDay)，通过生日计算年龄。

（16）判断是否到生日方法，isBirthDay*，比如isBirthDay(Date birthDay)，根据生日判断当前日期是否到生日。

详细使用可以查看相关测试代码。

4.日期格式化和解析工具类 DateTimeFormatterUtil

包含常用日期格式如：

yyyy-MM-dd

HH:mm:ss

yyyy-MM-dd HH:mm:ss

yyyy-MM-dd HH:mm:ss.SSS

yyyy-MM-dd HH:mm:ss.SSSSSS

yyyy-MM-dd HH:mm:ss.SSSSSSSSS

yyyy-MM-dd'T'HH:mm:ssZ等等，支持毫秒、微秒和纳秒等精确时间。

（1）格式化方法， format*，比如formatToDateStr(Date date) 格式化，返回日期部分，如：yyyy-MM-dd；

format(Date date, DateTimeFormatter formatter) formatter 可以选择已定义好的formatter比如YYYY_MM_DD_HH_MM_SS_FMT（yyyy-MM-dd HH:mm:ss）格式化日期。

（2）解析方法， parse*，比如parseDateStrToDate(String text) 解析日期yyyy-MM-dd，返回Date；

parseToDate(String text, DateTimeFormatter formatter) 根据 formatter解析为 Date。

（3）自动解析方法，根据字符串特点自动识别解析，smartParse*，比如smartParseToDate(String text) 自动解析Date。

（4）ISO格式（包含T）自动解析方法，根据字符串特点自动识别解析，parseIso*，比如parseIsoToDate(String text) 自动解析Date。

（5）解析时间戳方法, parseEpochMilli*，比如parseEpochMilliToDate(String text)，解析时间戳为Date，如 1590224790000。

（6）解析Date默认格式，parseDateDefaultStr*，比如parseDateDefaultStrToDate(String text)

解析 EEE MMM dd HH:mm:ss zzz yyyy 比如： Sat May 23 17:06:30 CST 2020 为Date。

（7）自定义时区格式化方法，比如 format(Date date, DateTimeFormatter formatter, String zoneId)，根据zoneId格式化Date。

（8）自定义模板格式化方法，比如 format(Date date, String dateFormatPattern)，根据dateFormatPattern格式化Date。

（9）自定义模板解析方法，比如 parseToDate(String text, String dateFormatPattern)，根据dateFormatPattern格式化Date。

（10）Timestamp默认格式（ yyyy-mm-dd hh:mm:ss.fffffffff 其中 fffffffff 纳秒，省略后面的0）格式化方法。

比如 formatTimestampStyle(Date date)。

（11）Timestamp默认格式（ yyyy-mm-dd hh:mm:ss.fffffffff 其中 fffffffff 纳秒，省略后面的0）解析方法。

比如 parseTimestampStyleToDate(String text)。

（12）验证日期格式是否正确方法，isValidDate*，比如isValidDate(String text)，验证yyyy-MM-dd 格式字符串是否正确。

注意：格式化和解析与系统时区不同的时间时，使用自定义时区格式化方法，或可以使用withZone方法重新设置时区，比如：

YYYY_MM_DD_HH_MM_SS_SSS_FMT.withZone(ZoneId.of("Europe/Paris") 。

详细使用可以查看相关测试代码。

5.日历工具类 CalendarUtil

包括：

（1）生成指定时间的日历（包含年、月和日层级关系的日历）方法，generateCalendar* 比如generateCalendar(int year, int month) 生成指定年月的日历。

（2）生成指定时间的日历（包含年、月和日层级关系的日历），包含农历和所有节假日信息方法，generateCalendarWithHoliday*，比generateCalendarWithHoliday(int year, int month, Map<String, String> localHolidayMap,Map<String, String> chineseHolidayMap, Map<String, Integer> dateTypeMap)生成指定年月的日历，包含农历和所有节假日信息，可以自定义节假日和工作日等。

详细使用可以查看相关测试代码。

6.农历日期类 LunarDate

包含：

（1）农历日期年月日计算。

（2）农历岁次，生肖属相计算。

（3）二十四节气计算等

注意：仅支持公历1901-2050年的农历转换。

农历和二十四节气计算的准确依赖于lunarInfo和solarTermInfo基础数据的准确性和精确度。

根据测试结果，发现本程序和常用万年历基本一致，常用万年历软件中也有很少量计算误差，欢迎提出问题，会不断进行改进和修正。

详细使用可以查看相关测试代码。

7.节假日计算类 Holiday

包含：

（1）公历节假日计算， getLocalHoliday* 比如getLocalHoliday(Date date) 计算date的公历节日，getLocalHoliday(Date date, Map<String, String> localHolidayMap) 可以传入自定义公历节日数据。

（2）农历节假日计算， getChineseHoliday* 比如getChineseHoliday(Date date) 计算date的农历节日，getChineseHoliday(Date date, Map<String, String> chineseHolidayMap) 可以传入自定义农历节日数据。

（3）二十四节气计算， getSolarTerm* 比如getSolarTerm(Date date) 计算date的二十四节气。

注意：农历和二十四节气使用农历日期类 LunarDate，仅支持公历1901-2050年的计算。

详细使用可以查看相关测试代码。