Merge pull request #96 from xkzhangsan/dev

Dev

CHANGELOG.md

@@ -33,3 +33,18 @@
 ## 2 修复bug
   无
 ---
+
+#3.2.2
+
+## 1 新功能
+（1）DateTimeFormatterUtil中增加文日期格式化和解析方法，如：2021年09月11日 和 二〇二一年九月十一日  
+
+（2）DateTimeConverterUtil中betweenTotalDays等方法，增加对LocalDate的支持  
+
+
+## 2 修复bug
+（1）修复TimeNLPUtil识别昨天、上月、去年等解析问题  
+
+（2）DateTimeConverterUtil中between方法中和Period相关的方法名称调整，比如betweenPeriodDays仅返回相差年月日中天数；计算相差总天数需使用betweenTotalDays方法   
+
+---

README.md

@@ -32,19 +32,19 @@ xk-time is a tool for time conversion, time calculation, time formatting, time p
     <dependency>  
       <groupId>com.github.xkzhangsan</groupId>    
       <artifactId>xk-time</artifactId>       
-      <version>3.2.1</version>    
+      <version>3.2.2</version>    
     </dependency>    
       
       Mini版本不包含 time nlp 功能，更简洁。  
     <dependency>  
       <groupId>com.github.xkzhangsan</groupId>    
       <artifactId>xk-time</artifactId>       
-      <version>3.2.1.Mini</version>    
+      <version>3.2.2.Mini</version>    
     </dependency>    
             
         
 ### 1.2 Gradle        
-    compile group: 'com.github.xkzhangsan', name: 'xk-time', version: '3.2.1'  
+    compile group: 'com.github.xkzhangsan', name: 'xk-time', version: '3.2.2'  
       
 ### 注意：Android谨慎使用，Android端因为需要兼容低版本而不支持Java8，建议继续使用其他工具，如果有需要本项目相关的功能，可以参考源码实现，或留言给我。感谢支持！  
 
@@ -60,6 +60,15 @@ xk-time工具包，将上面功能按照时间转换，时间计算，时间格
 
 ### 2.3 为了将与时间紧密相关的节假日、农历、二十四节气、十二星座、十二生肖、十二时辰和日历等功能集中起来开发成工具，方便使用。  
 
+### 2.4 xk-time、joda-time和Java8 time包的关系  
+
+2.4.1 joda-time和Java8 time包实现基本相同，都是Stephen Colebourne主导的，从Java8开始，推荐使用java8 time包替换joda-time。   
+
+2.4.2 xk-time是基于Java8日期api的，是一个补充工具，和以前的dateutil类似。  
+（1）Java8的类库是层级实现纵向的，xk-time则是按照通用功能横向的，比如转换，计算，格式化解析分为3个类等。  
+（2）Java8 Date转换成新类，需要查看api文档，xk-time则在内部转换好，使Date可以直接使用Java8的新功能。  
+（3）xk-time把dateutil的常用功能重新按照Java8的Api实现，同时做了一些扩展，使用更方便。  
+
 
 
 
@@ -87,7 +96,7 @@ xk-time工具包，将上面功能按照时间转换，时间计算，时间格
 
 （4）获取时间修改属性方法，with* 比如withYear(Date date, long newValue) 修改当前时间年值为newValue。  
 
-（5）获取比较2个时间方法，between* 比如betweenYears(Date startInclusive, Date endExclusive) 比较2个时间，获取年部分。  
+（5）获取比较2个时间方法，between* 比如betweenTotalDays(Date startInclusive, Date endExclusive) 比较2个时间，返回总天数。  
 
 （6）其他常用方法，比如isLeapYear(Date date) 判断是否闰年，isWeekend(Date date) 判断是否周末，isExpiry(String yearMonthStr) 是否过期等  
 

pom.xml

@@ -3,7 +3,7 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>com.github.xkzhangsan</groupId>
 	<artifactId>xk-time</artifactId>
-	<version>3.2.1</version>
+	<version>3.2.2</version>
 	<packaging>jar</packaging>
 	<name>xk-time</name>
 	<url>https://github.com/xkzhangsan/xk-time</url>