pro.fessional.mirana.time

Class DateFormatter

java.lang.Object

pro.fessional.mirana.time.DateFormatter

public class DateFormatter
extends Object

 Thread-safe. Faster than normal formatter.

 - DateTimeFormatter is immutable and thread-safe.
 - DateFormat is not thread-safe.

 see threadlocal-memory-leak-in-java-web
 see threadlocal-memory-leak

 

Since:

2019-07-03

Author:

trydofor

Field Summary

Fields

Modifier and Type	Field and Description
static ThreadLocal<DateFormat>	DATE_FORMAT_19 no leak, for static
static ThreadLocal<DateFormat>	DATE_FORMAT_23 no leak, for static
static DateTimeFormatter	FMT_DATE_10
static DateTimeFormatter	FMT_DATE_PSE
static DateTimeFormatter	FMT_DATE_PSE_US
static DateTimeFormatter	FMT_FULL_19
static DateTimeFormatter	FMT_FULL_23
static DateTimeFormatter	FMT_FULL_OZ
static DateTimeFormatter	FMT_FULL_PSE
static DateTimeFormatter	FMT_FULL_PSE_US
static DateTimeFormatter	FMT_FULL_TZ
static DateTimeFormatter	FMT_TIME_08
static DateTimeFormatter	FMT_TIME_12
static DateTimeFormatter	FMT_TIME_PSE
static DateTimeFormatter	FMT_ZONE_PSE
static DateTimeFormatter	FMT_ZONE_PSE_US
static String	PTN_DATE_10
static String	PTN_DATE_PSE
static String	PTN_DATE_PSE_US
static String	PTN_FULL_19
static String	PTN_FULL_23
static String	PTN_FULL_OZ
static String	PTN_FULL_PSE
static String	PTN_FULL_PSE_US
static String	PTN_FULL_TZ
static String	PTN_TIME_08
static String	PTN_TIME_12
static String	PTN_TIME_PSE
static String	PTN_ZONE_PSE
static String	PTN_ZONE_PSE_US

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DateFormatter()

Method Summary

Modifier and Type	Method and Description
static @NotNull String	date10(@Nullable Date date) Format to yyyy-MM-dd.
static @NotNull String	date10(@Nullable Date date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd at zoneId.
static @NotNull String	date10(@Nullable LocalDate date) Format to yyyy-MM-dd.
static @NotNull String	date10(@Nullable LocalDateTime date) Format to yyyy-MM-dd.
static @NotNull String	date10(@Nullable ZonedDateTime date) Format to yyyy-MM-dd.
static @NotNull String	date10(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd at zoneId.
static @NotNull String	fixFull19(@Nullable String date) Guarantee consistency, i.e.
static @NotNull String	full(@Nullable Date date) Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full(@Nullable Date date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS at zoneId.
static @NotNull String	full(@Nullable LocalDateTime date) Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full(@Nullable ZonedDateTime date) Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS at zoneId.
static DateFormat	full19()
static @NotNull String	full19(@Nullable Date date) Format to yyyy-MM-dd HH:mm:ss.
static @NotNull String	full19(@Nullable Date date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss at zoneId.
static @NotNull String	full19(@Nullable LocalDateTime date) Format to yyyy-MM-dd HH:mm:ss.
static @NotNull String	full19(@Nullable ZonedDateTime date) Format to yyyy-MM-dd HH:mm:ss.
static @NotNull String	full19(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss at zoneId.
static DateFormat	full23()
static @NotNull String	full23(@Nullable Date date) Format to yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full23(@Nullable Date date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss.SSS at zoneId.
static @NotNull String	full23(@Nullable LocalDateTime date) Format to yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full23(@Nullable ZonedDateTime date) Format to yyyy-MM-dd HH:mm:ss.SSS.
static @NotNull String	full23(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to yyyy-MM-dd HH:mm:ss.SSS at zoneId.
static @NotNull String	fullTz(@Nullable OffsetDateTime date)
static @NotNull String	fullTz(@Nullable ZonedDateTime date)
static @NotNull String	time(@Nullable Date date) Format to HH:mm:ss or HH:mm:ss.SSS.
static @NotNull String	time(@Nullable Date date, @Nullable ZoneId zoneId) Format to HH:mm:ss or HH:mm:ss.SSS at zoneId.
static @NotNull String	time(@Nullable LocalDateTime date) Format to HH:mm:ss or HH:mm:ss.SSS.
static @NotNull String	time(@Nullable LocalTime time) Format to HH:mm:ss or HH:mm:ss.SSS.
static @NotNull String	time(@Nullable ZonedDateTime date) Format to HH:mm:ss or HH:mm:ss.SSS.
static @NotNull String	time(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to HH:mm:ss or HH:mm:ss.SSS at zoneId.
static @NotNull String	time08(@Nullable Date date) Format to HH:mm:ss.
static @NotNull String	time08(@Nullable Date date, @Nullable ZoneId zoneId) Format to HH:mm:ss at zoneId.
static @NotNull String	time08(@Nullable LocalDateTime date) Format to HH:mm:ss.
static @NotNull String	time08(@Nullable LocalTime time) Format to HH:mm:ss.
static @NotNull String	time08(@Nullable ZonedDateTime date) Format to HH:mm:ss.
static @NotNull String	time08(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to HH:mm:ss at zoneId.
static @NotNull String	time12(@Nullable Date date) Format to HH:mm:ss.SSS.
static @NotNull String	time12(@Nullable Date date, @Nullable ZoneId zoneId) Format to HH:mm:ss.SSS at zoneId.
static @NotNull String	time12(@Nullable LocalDateTime date) Format to HH:mm:ss.SSS.
static @NotNull String	time12(@Nullable LocalTime time) Format to HH:mm:ss.SSS.
static @NotNull String	time12(@Nullable ZonedDateTime date) Format to HH:mm:ss.SSS.
static @NotNull String	time12(@Nullable ZonedDateTime date, @Nullable ZoneId zoneId) Format to HH:mm:ss.SSS at zoneId.
static @NotNull ZonedDateTime	zoned(@NotNull Date date, @Nullable ZoneId zoneId) convert date at zoneId

Methods inherited from class java.lang.Object

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

Field Detail

PTN_DATE_10

public static final String PTN_DATE_10

See Also:

Constant Field Values

PTN_TIME_08

public static final String PTN_TIME_08

See Also:

Constant Field Values

PTN_TIME_12

public static final String PTN_TIME_12

See Also:

Constant Field Values

PTN_FULL_19

public static final String PTN_FULL_19

See Also:

Constant Field Values

PTN_FULL_23

public static final String PTN_FULL_23

See Also:

Constant Field Values

PTN_FULL_TZ

public static final String PTN_FULL_TZ

See Also:

Constant Field Values

PTN_FULL_OZ

public static final String PTN_FULL_OZ

See Also:

Constant Field Values

PTN_TIME_PSE

public static final String PTN_TIME_PSE

See Also:

Constant Field Values

PTN_DATE_PSE

public static final String PTN_DATE_PSE

See Also:

Constant Field Values

PTN_FULL_PSE

public static final String PTN_FULL_PSE

See Also:

Constant Field Values

PTN_ZONE_PSE

public static final String PTN_ZONE_PSE

See Also:

Constant Field Values

PTN_DATE_PSE_US

public static final String PTN_DATE_PSE_US

See Also:

Constant Field Values

PTN_FULL_PSE_US

public static final String PTN_FULL_PSE_US

See Also:

Constant Field Values

PTN_ZONE_PSE_US

public static final String PTN_ZONE_PSE_US

See Also:

Constant Field Values

FMT_DATE_10

public static final DateTimeFormatter FMT_DATE_10

FMT_TIME_08

public static final DateTimeFormatter FMT_TIME_08

FMT_TIME_12

public static final DateTimeFormatter FMT_TIME_12

FMT_FULL_19

public static final DateTimeFormatter FMT_FULL_19

FMT_FULL_23

public static final DateTimeFormatter FMT_FULL_23

FMT_TIME_PSE

public static final DateTimeFormatter FMT_TIME_PSE

FMT_DATE_PSE

public static final DateTimeFormatter FMT_DATE_PSE

FMT_FULL_PSE

public static final DateTimeFormatter FMT_FULL_PSE

FMT_ZONE_PSE

public static final DateTimeFormatter FMT_ZONE_PSE

FMT_DATE_PSE_US

public static final DateTimeFormatter FMT_DATE_PSE_US

FMT_FULL_PSE_US

public static final DateTimeFormatter FMT_FULL_PSE_US

FMT_ZONE_PSE_US

public static final DateTimeFormatter FMT_ZONE_PSE_US

FMT_FULL_TZ

public static final DateTimeFormatter FMT_FULL_TZ

FMT_FULL_OZ

public static final DateTimeFormatter FMT_FULL_OZ

DATE_FORMAT_19

public static final ThreadLocal<DateFormat> DATE_FORMAT_19

no leak, for static

DATE_FORMAT_23

public static final ThreadLocal<DateFormat> DATE_FORMAT_23

no leak, for static

Constructor Detail

DateFormatter

protected DateFormatter()

Method Detail

full19

public static DateFormat full19()

full23

public static DateFormat full23()

fullTz

@NotNull
public static @NotNull String fullTz(@Nullable
                                              @Nullable ZonedDateTime date)

fullTz

@NotNull
public static @NotNull String fullTz(@Nullable
                                              @Nullable OffsetDateTime date)

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable ZonedDateTime date)

Format to yyyy-MM-dd. empty string if null.

full

@NotNull
public static @NotNull String full(@Nullable
                                            @Nullable ZonedDateTime date)

Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

full19

@NotNull
public static @NotNull String full19(@Nullable
                                              @Nullable ZonedDateTime date)

Format to yyyy-MM-dd HH:mm:ss. empty string if null.

full23

@NotNull
public static @NotNull String full23(@Nullable
                                              @Nullable ZonedDateTime date)

Format to yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable ZonedDateTime date)

Format to HH:mm:ss or HH:mm:ss.SSS. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable ZonedDateTime date)

Format to HH:mm:ss. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable ZonedDateTime date)

Format to HH:mm:ss.SSS. empty string if null.

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable ZonedDateTime date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd at zoneId. empty string if null.

full

@NotNull
public static @NotNull String full(@Nullable
                                            @Nullable ZonedDateTime date,
                                            @Nullable
                                            @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS at zoneId. empty string if null.

full19

@NotNull
public static @NotNull String full19(@Nullable
                                              @Nullable ZonedDateTime date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss at zoneId. empty string if null.

full23

@NotNull
public static @NotNull String full23(@Nullable
                                              @Nullable ZonedDateTime date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss.SSS at zoneId. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable ZonedDateTime date,
                                            @Nullable
                                            @Nullable ZoneId zoneId)

Format to HH:mm:ss or HH:mm:ss.SSS at zoneId. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable ZonedDateTime date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to HH:mm:ss at zoneId. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable ZonedDateTime date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to HH:mm:ss.SSS at zoneId. empty string if null.

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable LocalDateTime date)

Format to yyyy-MM-dd. empty string if null.

full

@NotNull
public static @NotNull String full(@Nullable
                                            @Nullable LocalDateTime date)

Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

full19

@NotNull
public static @NotNull String full19(@Nullable
                                              @Nullable LocalDateTime date)

Format to yyyy-MM-dd HH:mm:ss. empty string if null.

full23

@NotNull
public static @NotNull String full23(@Nullable
                                              @Nullable LocalDateTime date)

Format to yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable LocalDateTime date)

Format to HH:mm:ss or HH:mm:ss.SSS. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable LocalDateTime date)

Format to HH:mm:ss. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable LocalDateTime date)

Format to HH:mm:ss.SSS. empty string if null.

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable LocalDate date)

Format to yyyy-MM-dd. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable LocalTime time)

Format to HH:mm:ss or HH:mm:ss.SSS. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable LocalTime time)

Format to HH:mm:ss. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable LocalTime time)

Format to HH:mm:ss.SSS. empty string if null.

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable Date date)

Format to yyyy-MM-dd. empty string if null.

full

@NotNull
public static @NotNull String full(@Nullable
                                            @Nullable Date date)

Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

full19

@NotNull
public static @NotNull String full19(@Nullable
                                              @Nullable Date date)

Format to yyyy-MM-dd HH:mm:ss. empty string if null.

full23

@NotNull
public static @NotNull String full23(@Nullable
                                              @Nullable Date date)

Format to yyyy-MM-dd HH:mm:ss.SSS. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable Date date)

Format to HH:mm:ss or HH:mm:ss.SSS. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable Date date)

Format to HH:mm:ss. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable Date date)

Format to HH:mm:ss.SSS. empty string if null.

date10

@NotNull
public static @NotNull String date10(@Nullable
                                              @Nullable Date date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd at zoneId. empty string if null.

full

@NotNull
public static @NotNull String full(@Nullable
                                            @Nullable Date date,
                                            @Nullable
                                            @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss or yyyy-MM-dd HH:mm:ss.SSS at zoneId. empty string if null.

full19

@NotNull
public static @NotNull String full19(@Nullable
                                              @Nullable Date date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss at zoneId. empty string if null.

full23

@NotNull
public static @NotNull String full23(@Nullable
                                              @Nullable Date date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to yyyy-MM-dd HH:mm:ss.SSS at zoneId. empty string if null.

time

@NotNull
public static @NotNull String time(@Nullable
                                            @Nullable Date date,
                                            @Nullable
                                            @Nullable ZoneId zoneId)

Format to HH:mm:ss or HH:mm:ss.SSS at zoneId. empty string if null.

time08

@NotNull
public static @NotNull String time08(@Nullable
                                              @Nullable Date date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to HH:mm:ss at zoneId. empty string if null.

time12

@NotNull
public static @NotNull String time12(@Nullable
                                              @Nullable Date date,
                                              @Nullable
                                              @Nullable ZoneId zoneId)

Format to HH:mm:ss.SSS at zoneId. empty string if null.

zoned

@NotNull
public static @NotNull ZonedDateTime zoned(@NotNull
                                                    @NotNull Date date,
                                                    @Nullable
                                                    @Nullable ZoneId zoneId)

convert date at zoneId

fixFull19

@NotNull
public static @NotNull String fixFull19(@Nullable
                                                 @Nullable String date)

 Guarantee consistency, i.e. the same string, returns consistent results.
 Fix date string to yyyy-MM-dd HH:mm:ss
 `HH`, `MM`, `ss` are pseudo-randomly generated based on `yyyy-MM-dd`,
 which defaults to `1979-01-01`, respectively.
 

Parameters:

date - Any date containing numbers, will automatically fix the hours, minutes and seconds.

Returns:

Fixed date.