com.fengwenyi.javalib.convert

类 DateTimeUtils

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()

方法概要

限定符和类型	方法和说明
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.time.LocalDateTime	getStartOfMonth(java.time.LocalDate localDate) 获取当前月的开始时间
static java.time.LocalDateTime	getStartOfNaturalWeek(java.time.LocalDate localDate) 获取自然周的开始时间
static int	getYear() 获取年-现在
static int	getYear(java.time.LocalDate date) 获取年
static java.lang.Boolean	isBefore(java.time.LocalDateTime before, java.time.LocalDateTime after) 比较两个时间大小，简言之，before < after 是否成立 假定有两个时间，before和after，如果before小于after，返回 true ， 反之，返回 false
static boolean	isValid(java.lang.String source, java.lang.String pattern) 校验时间合法性
static boolean	judgeInTimeDuration(java.time.LocalTime time, java.time.LocalTime startTime, java.time.LocalTime endTime) 判断是否在指定时间区间内
static boolean	judgeInTimeDurationWithBoundary(java.time.LocalTime time, java.time.LocalTime startTime, java.time.LocalTime endTime) 判断是否在指定时间区间内，含边界
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.LocalDate	parseLocalDate(java.lang.String dateStr, java.lang.String pattern) 字符串格式的日期解析成日期格式
static java.time.LocalDateTime	parseLocalDateTime(java.lang.String dateTimeStr, java.lang.String pattern) 字符串格式的日期时间解析成日期时间格式
static java.util.Date	toDate(java.time.LocalDate localDate) LocalDate 转为 Date
static java.util.Date	toDate(java.time.LocalDateTime localDateTime) LocalDateTime 转为 Date
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.LocalDate localDate) 获取 LocalDate 的毫秒数
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

parseLocalDate

public static java.time.LocalDate parseLocalDate(java.lang.String dateStr,
                                                 java.lang.String pattern)

字符串格式的日期解析成日期格式

参数:

dateStr - 字符串格式的日期时间

pattern - 描述日期和时间格式的模式

返回:

日期时间格式 LocalDate

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

返回:

毫秒数

toMillisecond

public static java.lang.Long toMillisecond(java.time.LocalDate localDate)

获取 LocalDate 的毫秒数

参数:

localDate - 时间 LocalDate

返回:

毫秒数

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

toDate

public static java.util.Date toDate(java.time.LocalDateTime localDateTime)

LocalDateTime 转为 Date

参数:

localDateTime - LocalDateTime

返回:

Date

toDate

public static java.util.Date toDate(java.time.LocalDate localDate)

LocalDate 转为 Date

参数:

localDate - LocalDate

返回:

Date

isValid

public static boolean isValid(java.lang.String source,
                              java.lang.String pattern)

校验时间合法性

参数:

source - 待检查的时间字符串

pattern - 时间字符串格式

返回:

验证结果，true: 有效 / false: 无效

getYear

public static int getYear(java.time.LocalDate date)

获取年

参数:

date - 日期 LocalDate

返回:

年

getYear

public static int getYear()

获取年-现在

返回:

年

getStartOfNaturalWeek

public static java.time.LocalDateTime getStartOfNaturalWeek(java.time.LocalDate localDate)

获取自然周的开始时间

参数:

localDate - 日期

返回:

一周的开始时间

getStartOfMonth

public static java.time.LocalDateTime getStartOfMonth(java.time.LocalDate localDate)

获取当前月的开始时间

参数:

localDate - 当前日期

返回:

当前月的开始时间

judgeInTimeDuration

public static boolean judgeInTimeDuration(java.time.LocalTime time,
                                          java.time.LocalTime startTime,
                                          java.time.LocalTime endTime)

判断是否在指定时间区间内

参数:

time - 检测时间

startTime - 开始时间

endTime - 结束时间

返回:

true-在区间内；false-不在区间内

从以下版本开始:

2.2.1

judgeInTimeDurationWithBoundary

public static boolean judgeInTimeDurationWithBoundary(java.time.LocalTime time,
                                                      java.time.LocalTime startTime,
                                                      java.time.LocalTime endTime)

判断是否在指定时间区间内，含边界

参数:

time - 检测时间

startTime - 开始时间

endTime - 结束时间

返回:

true-在区间内；false-不在区间内

从以下版本开始:

2.2.1