DateTimeUtils (JavaLib 2.1.2 API)

java.lang.Object
- com.fengwenyi.javalib.convert.DateTimeUtils

```
public class DateTimeUtils
extends java.lang.Object
```
日期和时间工具类
目前功能如下：
- Date 格式化成字符串
- LocalDateTime 格式化成字符串
- Instant 格式化成字符串
- Long 时间戳（毫秒）格式化成字符串
- 时间字符串解析为 Date
- 时间字符串解析为 Instant
- 时间字符串解析为 LocalDateTime
- 将 Date 转换成时间戳（毫秒数）
- 将 LocalDateTime 转换成时间戳（毫秒数）
- 将 LocalDateTime 转换成时间戳（秒数）
- 自然语言描述过去的时间（中/英文）
关于为什么没有推出预定义时间格式呢? 因为每个人的需求不一样，不是很好定义，推荐名称为：DateTimePattern yyyyMMddHHmmss → 2019-12-17 10:37:21 yyyyMMdd → 2019-12-17 yyMMddHHmm → 19-12-17 10:37 HHmmss → 10:37:21 → 19.12.17 10:37 → 12.17 10:37 → 2019/12/17 10:37:21 → 2019/12/17 10:37 → 2019/12/17

关于时间，我们一般会用来做什么呢？
- 格式化
- 类型转换
- 计算
- 比较大小
- 时间范围
从以下版本开始:

2019-12-11

作者:

Erwin Feng[xfsy_2015@163.com]

另请参阅:

时间 java 8 time start, Instant, LocalDate, LocalTime, LocalDateTime, java 8 time end

构造器概要

构造器
构造器和说明

DateTimeUtils()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static java.lang.String`	`format(java.util.Date date, java.lang.String pattern)` 将时间格式化成字符串
`static java.lang.String`	`format(java.time.Instant instant, java.lang.String pattern)` 将时间格式化成字符串
`static java.lang.String`	`format(java.time.LocalDate date, java.lang.String pattern)` 将时间格式化成字符串
`static java.lang.String`	`format(java.time.LocalDateTime dateTime, java.lang.String pattern)` 将时间格式化成字符串
`static java.lang.String`	`format(java.lang.Long timestamp, java.lang.String pattern)` 将时间格式化成字符串提示：不能转换秒
`static java.lang.Boolean`	`isBefore(java.time.LocalDateTime before, java.time.LocalDateTime after)` 比较两个时间大小，简言之，`before < after` 是否成立假定有两个时间，before和after，如果before小于after，返回 `true` ，反之，返回 `false`
`static java.util.Date`	`parseDate(java.lang.String source, java.lang.String pattern)` 将时间字符串解析成时间类型(`Date`)
`static java.time.Instant`	`parseInstant(java.lang.String source)` 将日期字符串(形如 `2019-07-09` )转为 Instant，结果：`2019-07-08T16:00:00Z`
`static java.time.Instant`	`parseInstant(java.lang.String source, java.lang.String pattern)` 将时间字符串转为 Instant
`static java.time.LocalDateTime`	`parseLocalDateTime(java.lang.String dateTimeStr, java.lang.String pattern)` 字符串格式的日期时间解析成日期时间格式
`static java.time.Instant`	`toInstant(java.util.Date date)` 将 Date 转换成 Instant
`static java.time.LocalDateTime`	`toLocalDateTime(java.util.Date date)` 将 Date 转换成 LocalDateTime
`static java.time.LocalDateTime`	`toLocalDateTime(java.time.Instant instant)` 将 Instant 转换成 LocalDateTime
`static java.time.LocalDateTime`	`toLocalDateTime(java.lang.Long timestamp)` 时间戳（毫秒）转为 LocalDateTime
`static java.lang.Long`	`toMillisecond(java.util.Date date)` 获取毫秒数
`static java.lang.Long`	`toMillisecond(java.time.LocalDateTime localDateTime)` 获取 LocalDateTime的毫秒数
`static java.lang.Long`	`toSecond(java.time.LocalDateTime localDateTime)` 获取 LocalDateTime的秒数

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

- 构造器详细资料
  - DateTimeUtils
```
public DateTimeUtils()
```
- 方法详细资料
  - format
```
public static java.lang.String format(java.time.LocalDateTime dateTime,
                                      java.lang.String pattern)
```
    将时间格式化成字符串
    
    参数:
    
    dateTime - LocalDateTime
    
    pattern - 描述日期和时间格式的模式
    
    返回:
    
    满足指定格式的时间字符串
  - format
```
public static java.lang.String format(java.time.LocalDate date,
                                      java.lang.String pattern)
```
    将时间格式化成字符串
    
    参数:
    
    date - LocalDate
    
    pattern - 描述日期格式的模式
    
    返回:
    
    满足指定格式的日期字符串
  - format
```
public static java.lang.String format(java.util.Date date,
                                      java.lang.String pattern)
```
    将时间格式化成字符串
    
    参数:
    
    date - 时间 Date
    
    pattern - 描述日期和时间格式的模式
    
    返回:
    
    满足指定格式的时间字符串
  - format
```
public static java.lang.String format(java.lang.Long timestamp,
                                      java.lang.String pattern)
```
    将时间格式化成字符串
    提示：不能转换秒
    
    参数:
    
    timestamp - 时间戳（毫秒）
    
    pattern - 描述日期和时间格式的模式
    
    返回:
    
    满足指定格式的时间字符串
  - format
```
public static java.lang.String format(java.time.Instant instant,
                                      java.lang.String pattern)
```
    将时间格式化成字符串
    
    参数:
    
    instant - 时间点（Instant）
    
    pattern - 描述日期和时间格式的模式
    
    返回:
    
    满足指定格式的时间字符串
  - parseLocalDateTime
```
public static java.time.LocalDateTime parseLocalDateTime(java.lang.String dateTimeStr,
                                                         java.lang.String pattern)
```
    字符串格式的日期时间解析成日期时间格式
    
    参数:
    
    dateTimeStr - 字符串格式的日期时间
    
    pattern - 描述日期和时间格式的模式
    
    返回:
    
    日期时间格式 LocalDateTime
  - parseInstant
```
public static java.time.Instant parseInstant(java.lang.String source)
```
    将日期字符串(形如 2019-07-09 )转为 Instant，结果：2019-07-08T16:00:00Z
    
    参数:
    
    source - 日期字符串，如 2019-07-09
    
    返回:
    
    Instant 2019-07-08T16:00:00Z
  - parseInstant
```
public static java.time.Instant parseInstant(java.lang.String source,
                                             java.lang.String pattern)
```
    将时间字符串转为 Instant
    
    参数:
    
    source - 时间字符串
    
    pattern - 格式
    
    返回:
    
    Instant
  - parseDate
```
public static java.util.Date parseDate(java.lang.String source,
                                       java.lang.String pattern)
```
    将时间字符串解析成时间类型(Date)
    
    参数:
    
    source - 时间字符串（需要满足指定格式）
    
    pattern - 指定格式
    
    返回:
    
    时间类型(Date)
  - toMillisecond
```
public static java.lang.Long toMillisecond(java.util.Date date)
```
    获取毫秒数
    
    参数:
    
    date - 时间类型(Date)
    
    返回:
    
    毫秒数(Long)
  - toMillisecond
```
public static java.lang.Long toMillisecond(java.time.LocalDateTime localDateTime)
```
    获取 LocalDateTime的毫秒数
    
    参数:
    
    localDateTime - 时间 LocalDateTime
    
    返回:
    
    毫秒数
  - toSecond
```
public static java.lang.Long toSecond(java.time.LocalDateTime localDateTime)
```
    获取 LocalDateTime的秒数
    
    参数:
    
    localDateTime - 时间 LocalDateTime
    
    返回:
    
    时间戳（秒数）
  - toLocalDateTime
```
public static java.time.LocalDateTime toLocalDateTime(java.time.Instant instant)
```
    将 Instant 转换成 LocalDateTime
    
    参数:
    
    instant - Instant
    
    返回:
    
    LocalDateTime
  - toInstant
```
public static java.time.Instant toInstant(java.util.Date date)
```
    将 Date 转换成 Instant
    
    参数:
    
    date - Date
    
    返回:
    
    Instant
  - toLocalDateTime
```
public static java.time.LocalDateTime toLocalDateTime(java.util.Date date)
```
    将 Date 转换成 LocalDateTime
    
    参数:
    
    date - Date
    
    返回:
    
    LocalDateTime
  - isBefore
```
public static java.lang.Boolean isBefore(java.time.LocalDateTime before,
                                         java.time.LocalDateTime after)
```
    比较两个时间大小，简言之，before < after 是否成立
    假定有两个时间，before和after，如果before小于after，返回 true ，反之，返回 false
    
    参数:
    
    before - 小的是
    
    after - 大的时间
    
    返回:
    
    before < after 是否成立
  - toLocalDateTime
```
public static java.time.LocalDateTime toLocalDateTime(java.lang.Long timestamp)
```
    时间戳（毫秒）转为 LocalDateTime
    
    参数:
    
    timestamp - 时间戳（毫秒）
    
    返回:
    
    LocalDateTime

类 DateTimeUtils

构造器概要

方法概要

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

构造器详细资料

DateTimeUtils

方法详细资料

format

format

format

format

format

parseLocalDateTime

parseInstant

parseInstant

parseDate

toMillisecond

toMillisecond

toSecond

toLocalDateTime

toInstant

toLocalDateTime

isBefore

toLocalDateTime