DateTime2 (knife-util 1.3.3 API)

java.lang.Object
- com.gitee.baa.date.DateTime2

```
public class DateTime2
extends Object
```
版本:

1.0.0

作者:

baa Peng 2020-11-27 16:29

字段概要

字段
限定符和类型	字段和说明
`static DateTimeFormatter`	`DEFAULT_DATE_FORMATTER` yyyy-MM-dd
`static DateTimeFormatter`	`DEFAULT_DATETIME_FORMATTER` yyyy-MM-dd HH:mm:ss
`static String`	`DEFAULT_FORMATTER`
`private static long`	`LARGE_DATE_MILLS`
`private static int`	`MAX_DAY_MONTH`
`private static int`	`MAX_DAY_YEAR`
`static DateTimeFormatter`	`SHORT_DATE_FORMATTER` yyyy-M-d
`static DateTimeFormatter`	`SLASH_DATE_FORMATTER` yyyy/MM/dd
`private static long`	`SMALL_DATE_MILLS`
`(专用程序包) static List<DateTimeFormatter>`	`yearMonthFormatters`

构造器概要

构造器
构造器和说明

DateTime2()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`private static long`	`_parseFastDatetime(String text)` 解析合法的时间，失败返回 -1
`static int`	`calNatureDay(Calendar c1, Calendar c2)` 计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
`static int`	`calNatureDay(LocalDateTime t1, LocalDateTime t2)` 计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
`static int`	`calNatureDay(long t1, long t2)` 计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
`static String`	`dateToString(Date src, String pattern)`
`static String`	`dateToString(Date src, String pattern, String defaultValue)`
`static String`	`getDayAgo(String dateStr, int days, String fmt)` 获得日期 n 天以前
`static Date`	`getDaysStart(int days)` 获取与今天相比之前或者之后的某天的开始时间正数为之后，负数为之前
`static Date`	`getDayStart(Date date)` 获取某一天的开始时间 ex:2017-11-12 03:04:05 return 2017-11-12 00:00:00
`static Date`	`getGoodSendDateTime(Date date, int expectHour)`
`static String`	`longToInterval(long l)`
`static String`	`now()` 现在时间，格式：yyyy-MM-dd HH:mm:ss
`static String`	`now(String pattern)` 现在时间
`static LocalDateTime`	`parse(String source)` 解析日期时间格式
`static Date`	`stringToDate(String src, String pattern)`
`static Date`	`stringToDate(String src, String pattern, Date defaultDate)`
`static String`	`toChineseString(Duration d)` 格式化时长，以下输出：3时， 3时1分2秒， 3时2分
`static String`	`toChineseString(Duration d, boolean keepSecond)` 格式化时长，以下输出：3时， 3时1分2秒， 3时2分
`static Date`	`toDate(LocalDate t)` 转换日期格式
`static Date`	`toDate(LocalDate t, Date defaultIfNull)` 转换日期格式
`static Date`	`toDate(LocalDateTime t)` 转换日期格式
`static Date`	`toDate(LocalDateTime t, Date defaultIfNull)` 转换日期格式
`static int`	`toDayWithMax(LocalDate now)` 特殊用法，获取某天在一年中的位置（固定从1开始，每个月31天），例如1月1日=1，1月31日=31，2月31日=62等等
`static LocalDate`	`toLocalDate(Date date)` convert date to LocalDate
`static LocalDate`	`toLocalDate(LocalDate now, int x)` 将day（1~1231~2431）范围内的day转换成LocalDate LocalDate now = LocalDate.of(2016, 10, 13); assertEquals(LocalDate.of(2016, 1, 1), DateTime2.toLocalDate(now, 1));//1-1 assertEquals(LocalDate.of(2016, 1, 31), DateTime2.toLocalDate(now, 31));//1-31 assertEquals(LocalDate.of(2016, 2, 1), DateTime2.toLocalDate(now, 31+1));//2-1 assertEquals(LocalDate.of(2016, 2, 29), DateTime2.toLocalDate(now, 31+29));//2-29 assertNull(DateTime2.toLocalDate(now, 31+30));//2-30 assertNull(DateTime2.toLocalDate(now, 31+31));//2-31 assertEquals(LocalDate.of(2016, 12, 31), DateTime2.toLocalDate(now, 372)); assertEquals(LocalDate.of(2017, 1, 1), DateTime2.toLocalDate(now, 372+1)); assertEquals(LocalDate.of(2017, 1, 31), DateTime2.toLocalDate(now, 372+31)); assertEquals(LocalDate.of(2017, 2, 28), DateTime2.toLocalDate(now, 372+31+28)); assertNull(DateTime2.toLocalDate(now, 372+31+29));//2017-2-29 无效,非闰年 assertNull(DateTime2.toLocalDate(now, 372+31+31));//2017-2-31 无效
`static LocalDate`	`toLocalDate(long epochMilli)` convert milli seconds to LocalDate
`static LocalDate`	`toLocalDate(String text)` convert string to LocalDate 2016-05-10 2016-5-10 2016/06/10 1462843919831 1462843919
`static LocalDate`	`toLocalDate(String text, LocalDate defaultValue)` convert string to LocalDate
`static LocalDateTime`	`toLocalDateTime(Date date)` convert date to LocalDateTime
`static LocalDateTime`	`toLocalDateTime(long epochMilli)` convert milli seconds to LocalDateTime
`static LocalDateTime`	`toLocalDateTime(String text)` 将字符串转换为日期时间 yyyy-MM-dd HH:mm:ss 和 yyyy-MM-ddTHH:mm:ss yyyy-MM-dd HH:mm:ss yyyy-MM-ddTHH:mm:ss 1462843919831 1462843919
`static long`	`toMillis(LocalDate t)` convert LocalDate to milli seconds
`static long`	`toMillis(LocalDateTime t)` convert LocalDateTime to milli seconds
`static int`	`toMinute(LocalTime time)` 将时间转换成分钟，范围 0-1439之间。
`static String`	`toString(Date t)` 格式化输出 "yyyy-MM-dd HH:mm:ss"
`static String`	`toString(DayOfWeek dow, String prefix)` 格式化星期，输出 "星期五" 或者 "周五"
`static String`	`toString(LocalDate t)` 格式化输出 "yyyy-MM-dd"
`static String`	`toString(LocalDateTime t)` 格式化输出 "yyyy-MM-dd HH:mm:ss"
`static String`	`toString(long t)` 格式化输出 "yyyy-MM-dd HH:mm:ss"
`static List<Tuple<LocalDate,LocalDate>>`	`toTuples(Iterable<LocalDate> dates)` 将多个排好序的dates连接起来例如 2016-10-13,2016-12-30,2016-12-31,2017-01-01,2017-02-01 转换成 [2016-10-13~2016-10-13, 2016-12-30~2017-01-01, 2017-02-01~2017-02-01]
`static YearMonth`	`toYearMonth(String text, YearMonth defaultValue)` 解析 YearMonth('yyyy-MM', 'yyyyMM')，例如 2017-01 或者 201701

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

- 字段详细资料
  - DEFAULT_FORMATTER
```
public static final String DEFAULT_FORMATTER
```
    另请参阅:
    
    常量字段值
  - DEFAULT_DATETIME_FORMATTER
```
public static final DateTimeFormatter DEFAULT_DATETIME_FORMATTER
```
    yyyy-MM-dd HH:mm:ss
  - DEFAULT_DATE_FORMATTER
```
public static final DateTimeFormatter DEFAULT_DATE_FORMATTER
```
    yyyy-MM-dd
  - SHORT_DATE_FORMATTER
```
public static final DateTimeFormatter SHORT_DATE_FORMATTER
```
    yyyy-M-d
  - SLASH_DATE_FORMATTER
```
public static final DateTimeFormatter SLASH_DATE_FORMATTER
```
    yyyy/MM/dd
  - SMALL_DATE_MILLS
```
private static final long SMALL_DATE_MILLS
```
  - LARGE_DATE_MILLS
```
private static final long LARGE_DATE_MILLS
```
  - yearMonthFormatters
```
static List<DateTimeFormatter> yearMonthFormatters
```
  - MAX_DAY_MONTH
```
private static final int MAX_DAY_MONTH
```
    另请参阅:
    
    常量字段值
  - MAX_DAY_YEAR
```
private static final int MAX_DAY_YEAR
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DateTime2
```
public DateTime2()
```
- 方法详细资料
  - now
```
public static String now()
```
    现在时间，格式：yyyy-MM-dd HH:mm:ss
    
    返回:
    
    当前时间
    
    从以下版本开始:
    
    2014年11月27日
  - parse
```
public static LocalDateTime parse(String source)
```
    解析日期时间格式
    
    参数:
    
    source - 字符串日期，支持 yyyy-MM-dd HH:mm:ss 和 yyyy-MM-ddTHH:mm:ss(首选)
    
    返回:
    
    日期时间
    
    抛出:
    
    NullPointerException - 如果source为空
    
    DateTimeParseException - if the text cannot be parsed
    
    从以下版本开始:
    
    2015年4月22日
    
    另请参阅:
    
    toLocalDateTime(String)
  - now
```
public static String now(String pattern)
```
    现在时间
    
    参数:
    
    pattern - 输出格式
    
    返回:
    
    当前时间
    
    从以下版本开始:
    
    2014年11月27日
  - toString
```
public static String toString(Date t)
```
    格式化输出 "yyyy-MM-dd HH:mm:ss"
  - toString
```
public static String toString(LocalDateTime t)
```
    格式化输出 "yyyy-MM-dd HH:mm:ss"
  - toString
```
public static String toString(long t)
```
    格式化输出 "yyyy-MM-dd HH:mm:ss"
  - toString
```
public static String toString(LocalDate t)
```
    格式化输出 "yyyy-MM-dd"
  - toChineseString
```
public static String toChineseString(Duration d)
```
    格式化时长，以下输出：3时， 3时1分2秒， 3时2分
  - toChineseString
```
public static String toChineseString(Duration d,
                                     boolean keepSecond)
```
    格式化时长，以下输出：3时， 3时1分2秒， 3时2分
  - toString
```
public static String toString(DayOfWeek dow,
                              String prefix)
```
    格式化星期，输出 "星期五" 或者 "周五"
  - dateToString
```
public static String dateToString(Date src,
                                  String pattern)
```
  - dateToString
```
public static String dateToString(Date src,
                                  String pattern,
                                  String defaultValue)
```
  - stringToDate
```
public static Date stringToDate(String src,
                                String pattern)
```
  - stringToDate
```
public static Date stringToDate(String src,
                                String pattern,
                                Date defaultDate)
```
  - longToInterval
```
public static String longToInterval(long l)
```
  - getDaysStart
```
public static Date getDaysStart(int days)
```
    获取与今天相比之前或者之后的某天的开始时间正数为之后，负数为之前
    
    参数:
    
    days -
    
    返回:
  - getDayStart
```
public static Date getDayStart(Date date)
```
    获取某一天的开始时间 ex:2017-11-12 03:04:05 return 2017-11-12 00:00:00
    
    参数:
    
    date -
    
    返回:
  - calNatureDay
```
public static int calNatureDay(Calendar c1,
                               Calendar c2)
```
    计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
    
    参数:
    
    c1 - 第一个日期（大）
    
    c2 - 第二个日期（小）
    
    返回:
    
    相差天数，如果第一个日期小则为负数或者0
    
    从以下版本开始:
    
    2014年12月4日
  - calNatureDay
```
public static int calNatureDay(long t1,
                               long t2)
```
    计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
    
    参数:
    
    t1 - 第一个日期（大）,毫秒或者unix秒
    
    t2 - 第二个日期（小），毫秒或者unix秒
    
    返回:
    
    相差天数，如果第一个日期小则为负数或者0
    
    从以下版本开始:
    
    2014年12月4日
  - calNatureDay
```
public static int calNatureDay(LocalDateTime t1,
                               LocalDateTime t2)
```
    计算两个日期相差几个自然天，例如：2014-12-31 20:00 至 2015-01-01 07:00 相差-1天
    
    参数:
    
    t1 - 第一个日期（大）
    
    t2 - 第二个日期（小）
    
    返回:
    
    相差天数，如果第一个日期小则为负数或者0
    
    从以下版本开始:
    
    2015年1月14日
  - toMillis
```
public static long toMillis(LocalDateTime t)
```
    convert LocalDateTime to milli seconds
    
    参数:
    
    t - LocalDateTime
    
    返回:
    
    0 or milli seconds
    
    从以下版本开始:
    
    2016年1月20日
  - toMillis
```
public static long toMillis(LocalDate t)
```
    convert LocalDate to milli seconds
    
    参数:
    
    t - LocalDate
    
    返回:
    
    0 or milli seconds
    
    从以下版本开始:
    
    2016年1月20日
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(long epochMilli)
```
    convert milli seconds to LocalDateTime
    
    参数:
    
    epochMilli - milli seconds
    
    返回:
    
    LocalDateTime
    
    从以下版本开始:
    
    2016年1月20日
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(Date date)
```
    convert date to LocalDateTime
    
    参数:
    
    date - old date format
    
    返回:
    
    LocalDateTime or null
    
    从以下版本开始:
    
    2016年3月9日
  - toLocalDateTime
```
public static LocalDateTime toLocalDateTime(String text)
```
    将字符串转换为日期时间 yyyy-MM-dd HH:mm:ss 和 yyyy-MM-ddTHH:mm:ss
    1. yyyy-MM-dd HH:mm:ss
    2. yyyy-MM-ddTHH:mm:ss
    3. 1462843919831
    4. 1462843919
    参数:
    
    text - 字符串格式
    
    返回:
    
    LocalDateTime
    
    从以下版本开始:
    
    2016年4月29日
  - toLocalDate
```
public static LocalDate toLocalDate(long epochMilli)
```
    convert milli seconds to LocalDate
    
    参数:
    
    epochMilli - milli seconds
    
    返回:
    
    LocalDate
    
    从以下版本开始:
    
    2016年1月20日
  - toLocalDate
```
public static LocalDate toLocalDate(Date date)
```
    convert date to LocalDate
    
    参数:
    
    date - old date format
    
    返回:
    
    LocalDate or null
    
    从以下版本开始:
    
    2016年3月9日
  - toMinute
```
public static int toMinute(LocalTime time)
```
    将时间转换成分钟，范围 0-1439之间。
  - toLocalDate
```
public static LocalDate toLocalDate(String text)
```
    convert string to LocalDate
    1. 2016-05-10
    2. 2016-5-10
    3. 2016/06/10
    4. 1462843919831
    5. 1462843919
    参数:
    
    text - string format, both support yyyy-MM-dd, yyyy-M-d, unix seconds, unix milliseconds
    
    返回:
    
    LocalDate
    
    从以下版本开始:
    
    2016年4月29日
  - toLocalDate
```
public static LocalDate toLocalDate(String text,
                                    LocalDate defaultValue)
```
    convert string to LocalDate
    
    另请参阅:
    
    toLocalDate(String)
  - toYearMonth
```
public static YearMonth toYearMonth(String text,
                                    YearMonth defaultValue)
```
    解析 YearMonth('yyyy-MM', 'yyyyMM')，例如 2017-01 或者 201701
    
    参数:
    
    text - 文本
    
    defaultValue - 解析失败，返回默认值
    
    返回:
    
    年月
    
    从以下版本开始:
    
    2017年1月9日
  - _parseFastDatetime
```
private static long _parseFastDatetime(String text)
```
    解析合法的时间，失败返回 -1
  - toLocalDate
```
public static LocalDate toLocalDate(LocalDate now,
                                    int x)
```
    将day（1~12*31~24*31）范围内的day转换成LocalDate
```
     LocalDate now = LocalDate.of(2016, 10, 13);
     assertEquals(LocalDate.of(2016, 1, 1), DateTime2.toLocalDate(now, 1));//1-1
     assertEquals(LocalDate.of(2016, 1, 31), DateTime2.toLocalDate(now, 31));//1-31
     assertEquals(LocalDate.of(2016, 2, 1), DateTime2.toLocalDate(now, 31+1));//2-1
     assertEquals(LocalDate.of(2016, 2, 29), DateTime2.toLocalDate(now, 31+29));//2-29
     assertNull(DateTime2.toLocalDate(now, 31+30));//2-30
     assertNull(DateTime2.toLocalDate(now, 31+31));//2-31

     assertEquals(LocalDate.of(2016, 12, 31), DateTime2.toLocalDate(now, 372));
     assertEquals(LocalDate.of(2017, 1, 1), DateTime2.toLocalDate(now, 372+1));
     assertEquals(LocalDate.of(2017, 1, 31), DateTime2.toLocalDate(now, 372+31));
     assertEquals(LocalDate.of(2017, 2, 28), DateTime2.toLocalDate(now, 372+31+28));
     assertNull(DateTime2.toLocalDate(now, 372+31+29));//2017-2-29 无效,非闰年
     assertNull(DateTime2.toLocalDate(now, 372+31+31));//2017-2-31 无效
     
```
    参数:
    
    now - 以某个时间段为参考点（若x对应的 month和day 在此之前则认为是来年，year+1。例如今天是2016-10-13，若x对应09-30则返回2017-09-30）
    
    x - 1~743范围内整数
    
    返回:
    
    具体某个日期或者null（例如62，对应着2月31日，不存在，所以返回null）
    
    从以下版本开始:
    
    2016年10月13日
  - toDayWithMax
```
public static int toDayWithMax(LocalDate now)
```
    特殊用法，获取某天在一年中的位置（固定从1开始，每个月31天），例如1月1日=1，1月31日=31，2月31日=62等等
    
    参数:
    
    now - 具体日期
    
    返回:
    
    一年中的位置
    
    从以下版本开始:
    
    2016年10月13日
  - toTuples
```
public static List<Tuple<LocalDate,LocalDate>> toTuples(Iterable<LocalDate> dates)
```
    将多个排好序的dates连接起来
```
例如
     2016-10-13,2016-12-30,2016-12-31,2017-01-01,2017-02-01
     转换成
     [2016-10-13~2016-10-13, 2016-12-30~2017-01-01, 2017-02-01~2017-02-01]
     
```
    参数:
    
    dates - 排好序的间断日期
    
    返回:
    
    排好序的日期段，含起始日期
    
    从以下版本开始:
    
    2016年10月13日
  - getGoodSendDateTime
```
public static Date getGoodSendDateTime(Date date,
                                       int expectHour)
```
  - getDayAgo
```
public static String getDayAgo(String dateStr,
                               int days,
                               String fmt)
```
    获得日期 n 天以前
    
    参数:
    
    dateStr -
    
    days -
    
    fmt -
    
    返回:
  - toDate
```
public static Date toDate(LocalDateTime t,
                          Date defaultIfNull)
```
    转换日期格式
    
    参数:
    
    t - 日期时间
    
    defaultIfNull - 如果t为null时的默认值
    
    返回:
    
    老版本日期时间
    
    从以下版本开始:
    
    2017年12月5日
    
    另请参阅:
    
    toLocalDateTime(Date)
  - toDate
```
public static Date toDate(LocalDate t,
                          Date defaultIfNull)
```
    转换日期格式
    
    参数:
    
    t - 日期
    
    defaultIfNull - 如果t为null时的默认值
    
    返回:
    
    老版本日期时间
    
    从以下版本开始:
    
    2017年12月5日
    
    另请参阅:
    
    toLocalDate(Date)
  - toDate
```
public static Date toDate(LocalDate t)
```
    转换日期格式
    
    参数:
    
    t - 日期
    
    返回:
    
    老版本日期时间
    
    从以下版本开始:
    
    2017年12月5日
    
    另请参阅:
    
    toDate(LocalDate, Date)
  - toDate
```
public static Date toDate(LocalDateTime t)
```
    转换日期格式
    
    参数:
    
    t - 日期时间
    
    返回:
    
    老版本日期时间
    
    从以下版本开始:
    
    2017年12月5日
    
    另请参阅:
    
    toDate(LocalDateTime, Date)

类 DateTime2

字段概要

构造器概要

方法概要

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

字段详细资料

DEFAULT_FORMATTER

DEFAULT_DATETIME_FORMATTER

DEFAULT_DATE_FORMATTER

SHORT_DATE_FORMATTER

SLASH_DATE_FORMATTER

SMALL_DATE_MILLS

LARGE_DATE_MILLS

yearMonthFormatters

MAX_DAY_MONTH

MAX_DAY_YEAR

构造器详细资料

DateTime2

方法详细资料

now

parse

now

toString

toString

toString

toString

toChineseString

toChineseString

toString

dateToString

dateToString

stringToDate

stringToDate

longToInterval

getDaysStart

getDayStart

calNatureDay

calNatureDay

calNatureDay

toMillis

toMillis

toLocalDateTime

toLocalDateTime

toLocalDateTime

toLocalDate

toLocalDate

toMinute

toLocalDate

toLocalDate

toYearMonth

_parseFastDatetime

toLocalDate

toDayWithMax

toTuples

getGoodSendDateTime

getDayAgo

toDate

toDate

toDate

toDate