Package org.miaixz.bus.core.center.date

Class Formatter

java.lang.Object

org.miaixz.bus.core.center.date.Formatter

Direct Known Subclasses:

Converter

public class Formatter
extends Object

日期格式化和解析 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:ss.SSSZ等等，支持毫秒、微秒和纳秒等精确时间

Since:

Java 17+

Author:

Kimi Liu

Field Summary

Fields

Modifier and Type	Field	Description
static final FormatBuilder	CN_DATE_FORMAT	标准日期格式 FormatBuilder：yyyy年MM月dd日
static final DateTimeFormatter	CN_DATE_FORMATTER	标准日期格式 DateTimeFormatter：yyyy年MM月dd日
static final FormatBuilder	CN_DATE_TIME_FORMAT	标准日期格式 FormatBuilder：yyyy年MM月dd日HH时mm分ss秒
static final DateTimeFormatter	CN_DATE_TIME_FORMATTER	标准日期格式 DateTimeFormatter：yyyy年MM月dd日HH时mm分ss秒
static final FormatBuilder	HTTP_DATETIME_FORMAT	HTTP头中日期时间格式 FormatBuilder：EEE, dd MMM yyyy HH:mm:ss z
static final FormatBuilder	HTTP_DATETIME_FORMAT_GMT	HTTP头中日期时间格式 FormatBuilder：EEE, dd MMM yyyy HH:mm:ss GMT
static final FormatBuilder	ISO8601_FORMAT	ISO8601日期时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss
static final FormatBuilder	ISO8601_MS_FORMAT	UTC时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSS
static final FormatBuilder	ISO8601_MS_WITH_XXX_OFFSET_FORMAT	UTC时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
static final FormatBuilder	ISO8601_MS_WITH_ZONE_OFFSET_FORMAT	ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSSZ
static final FormatBuilder	ISO8601_WITH_XXX_OFFSET_FORMAT	ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ssXXX
static final FormatBuilder	ISO8601_WITH_ZONE_OFFSET_FORMAT	ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ssZ，Z表示一个时间偏移，如+0800
static final FormatBuilder	JDK_DATETIME_FORMAT	JDK中日期时间格式 FormatBuilder：EEE MMM dd HH:mm:ss zzz yyyy
static final LocalTime	MAX_HMS	只有时分秒的最大时间
static final FormatBuilder	NORM_DATE_FORMAT	标准日期格式 FormatBuilder：yyyy-MM-dd
static final DateTimeFormatter	NORM_DATE_FORMATTER	标准日期格式 DateTimeFormatter：yyyy-MM-dd
static final FormatBuilder	NORM_DATETIME_COMMA_MS_FORMAT	ISO8601日期时间格式，精确到毫秒 FormatBuilder：yyyy-MM-dd HH:mm:ss,SSS
static final DateTimeFormatter	NORM_DATETIME_COMMA_MS_FORMATTER	标准日期格式 DateTimeFormatter：yyyy-MM-dd HH:mm:ss,SSS
static final FormatBuilder	NORM_DATETIME_FORMAT	标准日期时间格式，精确到秒 FormatBuilder：yyyy-MM-dd HH:mm:ss
static final DateTimeFormatter	NORM_DATETIME_FORMATTER	标准日期时间格式，精确到秒 DateTimeFormatter：yyyy-MM-dd HH:mm:ss
static final FormatBuilder	NORM_DATETIME_MINUTE_FORMAT	标准日期时间格式，精确到分 FormatBuilder：yyyy-MM-dd HH:mm
static final DateTimeFormatter	NORM_DATETIME_MINUTE_FORMATTER	标准日期格式 DateTimeFormatter：yyyy-MM-dd HH:mm
static final FormatBuilder	NORM_DATETIME_MS_FORMAT	标准日期时间格式，精确到毫秒 FormatBuilder：yyyy-MM-dd HH:mm:ss.SSS
static final DateTimeFormatter	NORM_DATETIME_MS_FORMATTER	标准日期时间格式，精确到毫秒 DateTimeFormatter：yyyy-MM-dd HH:mm:ss.SSS
static final FormatBuilder	NORM_MONTH_FORMAT	年月格式 FormatBuilder：yyyy-MM
static final DateTimeFormatter	NORM_MONTH_FORMATTER	年月格式 DateTimeFormatter：yyyy-MM
static final FormatBuilder	NORM_TIME_FORMAT	标准时间格式 FormatBuilder：HH:mm:ss
static final DateTimeFormatter	NORM_TIME_FORMATTER	标准日期格式 DateTimeFormatter：HH:mm:ss
static final FormatBuilder	PURE_DATE_FORMAT	标准日期格式 FormatBuilder：yyyyMMdd
static final DateTimeFormatter	PURE_DATE_FORMATTER	标准日期格式 DateTimeFormatter：yyyyMMdd
static final FormatBuilder	PURE_DATETIME_FORMAT	标准日期格式 FormatBuilder：yyyyMMddHHmmss
static final DateTimeFormatter	PURE_DATETIME_FORMATTER	标准日期格式 DateTimeFormatter：yyyyMMddHHmmss
static final FormatBuilder	PURE_DATETIME_MS_FORMAT	标准日期格式 FormatBuilder：yyyyMMddHHmmssSSS
static final DateTimeFormatter	PURE_DATETIME_MS_FORMATTER	标准日期格式 DateTimeFormatter：yyyyMMddHHmmssSSS see https://stackoverflow.com/questions/22588051/is-java-time-failing-to-parse-fraction-of-second jdk8 bug at: https://bugs.openjdk.java.net/browse/JDK-8031085
static final FormatBuilder	PURE_DATETIME_TIP_FORMAT	格式化通配符: FormatBuilder yyyyMMddHHmmss.SSS
static final FormatBuilder	PURE_TIME_FORMAT	标准日期格式 FormatBuilder：HHmmss
static final DateTimeFormatter	PURE_TIME_FORMATTER	标准日期格式 DateTimeFormatter：HHmmss
static final FormatBuilder	SIMPLE_MONTH_FORMAT	简单年月格式 FormatBuilder：yyyyMM
static final DateTimeFormatter	SIMPLE_MONTH_FORMATTER	简单年月格式 DateTimeFormatter：yyyyMM
static final FormatBuilder	UTC_FORMAT	ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss'Z'
static final FormatBuilder	UTC_MS_FORMAT	ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

Constructor Summary

Constructors

Constructor	Description
Formatter()

Method Summary

Modifier and Type	Method	Description
static String	format(TemporalAccessor time, String format)	格式化日期时间为指定格式 如果为Month，调用Enum.toString()
static String	format(TemporalAccessor time, DateTimeFormatter formatter)	格式化日期时间为指定格式 如果为Month，调用Enum.toString()
static Function<TemporalAccessor,String>	formatFunc(DateTimeFormatter dateTimeFormatter)	格式化时间函数
static String	formatNormal(ChronoLocalDate date)	格式化日期时间为yyyy-MM-dd格式
static String	formatNormal(ChronoLocalDateTime<?> time)	格式化日期时间为yyyy-MM-dd HH:mm:ss格式

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

NORM_MONTH_FORMAT

public static final FormatBuilder NORM_MONTH_FORMAT

年月格式 FormatBuilder：yyyy-MM

NORM_MONTH_FORMATTER

public static final DateTimeFormatter NORM_MONTH_FORMATTER

年月格式 DateTimeFormatter：yyyy-MM

SIMPLE_MONTH_FORMAT

public static final FormatBuilder SIMPLE_MONTH_FORMAT

简单年月格式 FormatBuilder：yyyyMM

SIMPLE_MONTH_FORMATTER

public static final DateTimeFormatter SIMPLE_MONTH_FORMATTER

简单年月格式 DateTimeFormatter：yyyyMM

NORM_DATE_FORMAT

public static final FormatBuilder NORM_DATE_FORMAT

标准日期格式 FormatBuilder：yyyy-MM-dd

NORM_DATE_FORMATTER

public static final DateTimeFormatter NORM_DATE_FORMATTER

标准日期格式 DateTimeFormatter：yyyy-MM-dd

NORM_TIME_FORMAT

public static final FormatBuilder NORM_TIME_FORMAT

标准时间格式 FormatBuilder：HH:mm:ss

NORM_TIME_FORMATTER

public static final DateTimeFormatter NORM_TIME_FORMATTER

标准日期格式 DateTimeFormatter：HH:mm:ss

NORM_DATETIME_MINUTE_FORMAT

public static final FormatBuilder NORM_DATETIME_MINUTE_FORMAT

标准日期时间格式，精确到分 FormatBuilder：yyyy-MM-dd HH:mm

NORM_DATETIME_MINUTE_FORMATTER

public static final DateTimeFormatter NORM_DATETIME_MINUTE_FORMATTER

标准日期格式 DateTimeFormatter：yyyy-MM-dd HH:mm

NORM_DATETIME_FORMAT

public static final FormatBuilder NORM_DATETIME_FORMAT

标准日期时间格式，精确到秒 FormatBuilder：yyyy-MM-dd HH:mm:ss

NORM_DATETIME_FORMATTER

public static final DateTimeFormatter NORM_DATETIME_FORMATTER

标准日期时间格式，精确到秒 DateTimeFormatter：yyyy-MM-dd HH:mm:ss

NORM_DATETIME_MS_FORMAT

public static final FormatBuilder NORM_DATETIME_MS_FORMAT

标准日期时间格式，精确到毫秒 FormatBuilder：yyyy-MM-dd HH:mm:ss.SSS

NORM_DATETIME_MS_FORMATTER

public static final DateTimeFormatter NORM_DATETIME_MS_FORMATTER

标准日期时间格式，精确到毫秒 DateTimeFormatter：yyyy-MM-dd HH:mm:ss.SSS

NORM_DATETIME_COMMA_MS_FORMAT

public static final FormatBuilder NORM_DATETIME_COMMA_MS_FORMAT

ISO8601日期时间格式，精确到毫秒 FormatBuilder：yyyy-MM-dd HH:mm:ss,SSS

NORM_DATETIME_COMMA_MS_FORMATTER

public static final DateTimeFormatter NORM_DATETIME_COMMA_MS_FORMATTER

标准日期格式 DateTimeFormatter：yyyy-MM-dd HH:mm:ss,SSS

CN_DATE_FORMAT

public static final FormatBuilder CN_DATE_FORMAT

标准日期格式 FormatBuilder：yyyy年MM月dd日

CN_DATE_FORMATTER

public static final DateTimeFormatter CN_DATE_FORMATTER

标准日期格式 DateTimeFormatter：yyyy年MM月dd日

CN_DATE_TIME_FORMAT

public static final FormatBuilder CN_DATE_TIME_FORMAT

标准日期格式 FormatBuilder：yyyy年MM月dd日HH时mm分ss秒

CN_DATE_TIME_FORMATTER

public static final DateTimeFormatter CN_DATE_TIME_FORMATTER

标准日期格式 DateTimeFormatter：yyyy年MM月dd日HH时mm分ss秒

PURE_DATE_FORMAT

public static final FormatBuilder PURE_DATE_FORMAT

标准日期格式 FormatBuilder：yyyyMMdd

PURE_DATE_FORMATTER

public static final DateTimeFormatter PURE_DATE_FORMATTER

标准日期格式 DateTimeFormatter：yyyyMMdd

PURE_TIME_FORMAT

public static final FormatBuilder PURE_TIME_FORMAT

标准日期格式 FormatBuilder：HHmmss

PURE_TIME_FORMATTER

public static final DateTimeFormatter PURE_TIME_FORMATTER

标准日期格式 DateTimeFormatter：HHmmss

PURE_DATETIME_FORMAT

public static final FormatBuilder PURE_DATETIME_FORMAT

标准日期格式 FormatBuilder：yyyyMMddHHmmss

PURE_DATETIME_FORMATTER

public static final DateTimeFormatter PURE_DATETIME_FORMATTER

标准日期格式 DateTimeFormatter：yyyyMMddHHmmss

PURE_DATETIME_MS_FORMAT

public static final FormatBuilder PURE_DATETIME_MS_FORMAT

标准日期格式 FormatBuilder：yyyyMMddHHmmssSSS

PURE_DATETIME_TIP_FORMAT

public static final FormatBuilder PURE_DATETIME_TIP_FORMAT

格式化通配符: FormatBuilder yyyyMMddHHmmss.SSS

PURE_DATETIME_MS_FORMATTER

public static final DateTimeFormatter PURE_DATETIME_MS_FORMATTER

标准日期格式 DateTimeFormatter：yyyyMMddHHmmssSSS see https://stackoverflow.com/questions/22588051/is-java-time-failing-to-parse-fraction-of-second jdk8 bug at: https://bugs.openjdk.java.net/browse/JDK-8031085

HTTP_DATETIME_FORMAT_GMT

public static final FormatBuilder HTTP_DATETIME_FORMAT_GMT

HTTP头中日期时间格式 FormatBuilder：EEE, dd MMM yyyy HH:mm:ss GMT

HTTP_DATETIME_FORMAT

public static final FormatBuilder HTTP_DATETIME_FORMAT

HTTP头中日期时间格式 FormatBuilder：EEE, dd MMM yyyy HH:mm:ss z

JDK_DATETIME_FORMAT

public static final FormatBuilder JDK_DATETIME_FORMAT

JDK中日期时间格式 FormatBuilder：EEE MMM dd HH:mm:ss zzz yyyy

ISO8601_FORMAT

public static final FormatBuilder ISO8601_FORMAT

ISO8601日期时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss

ISO8601_MS_FORMAT

public static final FormatBuilder ISO8601_MS_FORMAT

UTC时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSS

UTC_FORMAT

public static final FormatBuilder UTC_FORMAT

ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss'Z'

ISO8601_WITH_ZONE_OFFSET_FORMAT

public static final FormatBuilder ISO8601_WITH_ZONE_OFFSET_FORMAT

ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ssZ，Z表示一个时间偏移，如+0800

ISO8601_WITH_XXX_OFFSET_FORMAT

public static final FormatBuilder ISO8601_WITH_XXX_OFFSET_FORMAT

ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ssXXX

UTC_MS_FORMAT

public static final FormatBuilder UTC_MS_FORMAT

ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

ISO8601_MS_WITH_ZONE_OFFSET_FORMAT

public static final FormatBuilder ISO8601_MS_WITH_ZONE_OFFSET_FORMAT

ISO8601时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSSZ

ISO8601_MS_WITH_XXX_OFFSET_FORMAT

public static final FormatBuilder ISO8601_MS_WITH_XXX_OFFSET_FORMAT

UTC时间FormatBuilder：yyyy-MM-dd'T'HH:mm:ss.SSSXXX

MAX_HMS

public static final LocalTime MAX_HMS

只有时分秒的最大时间

Constructor Details

Formatter

public Formatter()

Method Details

format

public static String format(TemporalAccessor time,
 DateTimeFormatter formatter)

格式化日期时间为指定格式 如果为Month，调用Enum.toString()

Parameters:

time - TemporalAccessor

formatter - 日期格式化器，预定义的格式见：DateTimeFormatter

Returns:

格式化后的字符串

format

public static String format(TemporalAccessor time,
 String format)

格式化日期时间为指定格式 如果为Month，调用Enum.toString()

Parameters:

time - TemporalAccessor

format - 日期格式

Returns:

格式化后的字符串

formatNormal

public static String formatNormal(ChronoLocalDateTime<?> time)

格式化日期时间为yyyy-MM-dd HH:mm:ss格式

Parameters:

time - LocalDateTime

Returns:

格式化后的字符串

formatNormal

public static String formatNormal(ChronoLocalDate date)

格式化日期时间为yyyy-MM-dd格式

Parameters:

date - LocalDate

Returns:

格式化后的字符串

formatFunc

public static Function<TemporalAccessor,String> formatFunc(DateTimeFormatter dateTimeFormatter)

格式化时间函数

Parameters:

dateTimeFormatter - DateTimeFormatter

Returns:

格式化时间的函数