Class DateFormatUtils

java.lang.Object

org.frankframework.util.DateFormatUtils

@NullMarked
public class DateFormatUtils
extends Object

Utilities for formatting and parsing dates.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FORMAT_DATE_ISO
static final String	FORMAT_DATETIME_GENERIC
static final String	FORMAT_FULL_GENERIC
static final String	FORMAT_FULL_ISO
static final String	FORMAT_FULL_ISO_8601_TZ_OFFSET
static final String	FORMAT_FULL_ISO_TIMESTAMP_NO_TZ
static final String	FORMAT_SHORT_DATE
static final String	FORMAT_TIME_HMS
static final DateTimeFormatter	FULL_GENERIC_FORMATTER
static final DateTimeFormatter	FULL_ISO_FORMAT_PARSER
static final DateTimeFormatter	FULL_ISO_FORMATTER
static final DateTimeFormatter	FULL_ISO_TIMESTAMP_NO_TZ_FORMATTER
static final DateTimeFormatter	FULL_ISO_TIMESTAMP_WITH_TZ_FORMATTER
static final DateTimeFormatter	GENERIC_DATETIME_FORMATTER
static final DateTimeFormatter	HTTP_DATE_HEADER_FORMAT
static final DateTimeFormatter	ISO_DATE_FORMATTER
static final DateTimeFormatter	SHORT_DATE_FORMATTER
static final DateTimeFormatter	TIME_HMS_FORMATTER

Method Summary

Modifier and Type	Method	Description
static DateTimeFormatter	buildFormatter(String format)
static DateTimeFormatter	buildIso8601Parser()	Builds a DateTimeFormatter that can parse ISO 8601 date-time strings with optional milliseconds and timezone information.
static DateTimeFormatter	buildParser(String format)	Java time API is more strict compared to the old Date API.
static String	format(long date)
static String	format(long date, DateTimeFormatter formatter)
static String	format(Instant instant)
static String	format(Instant instant, DateTimeFormatter formatter)
static @Nullable String	format(@Nullable Date date)	Deprecated.
static String	format(Date date, DateTimeFormatter formatter)	Deprecated.
static String	getTimeStamp()	Get current date-time timestamp in generic format.
static String	now()
static String	now(String format)	Deprecated.
static String	now(DateTimeFormatter formatter)
static Date	parseAnyDate(String dateInAnyFormat)	Deprecated.
static Instant	parseGenericDate(String dateString)
static Instant	parseToInstant(String dateString, DateTimeFormatter parser)
static LocalDate	parseToLocalDate(String dateString)
static LocalDate	parseToLocalDate(String dateString, DateTimeFormatter parser)

Methods inherited from class Object

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

Field Details

FORMAT_FULL_ISO

public static final String FORMAT_FULL_ISO

See Also:

• Constant Field Values

FORMAT_FULL_ISO_8601_TZ_OFFSET

public static final String FORMAT_FULL_ISO_8601_TZ_OFFSET

See Also:

• Constant Field Values

FORMAT_FULL_ISO_TIMESTAMP_NO_TZ

public static final String FORMAT_FULL_ISO_TIMESTAMP_NO_TZ

See Also:

• Constant Field Values

FORMAT_FULL_GENERIC

public static final String FORMAT_FULL_GENERIC

See Also:

• Constant Field Values

FORMAT_DATETIME_GENERIC

public static final String FORMAT_DATETIME_GENERIC

See Also:

• Constant Field Values

FULL_ISO_FORMATTER

public static final DateTimeFormatter FULL_ISO_FORMATTER

FULL_ISO_FORMAT_PARSER

public static final DateTimeFormatter FULL_ISO_FORMAT_PARSER

FULL_ISO_TIMESTAMP_WITH_TZ_FORMATTER

public static final DateTimeFormatter FULL_ISO_TIMESTAMP_WITH_TZ_FORMATTER

FULL_ISO_TIMESTAMP_NO_TZ_FORMATTER

public static final DateTimeFormatter FULL_ISO_TIMESTAMP_NO_TZ_FORMATTER

FULL_GENERIC_FORMATTER

public static final DateTimeFormatter FULL_GENERIC_FORMATTER

GENERIC_DATETIME_FORMATTER

public static final DateTimeFormatter GENERIC_DATETIME_FORMATTER

FORMAT_DATE_ISO

public static final String FORMAT_DATE_ISO

See Also:

• Constant Field Values

ISO_DATE_FORMATTER

public static final DateTimeFormatter ISO_DATE_FORMATTER

FORMAT_SHORT_DATE

public static final String FORMAT_SHORT_DATE

See Also:

• Constant Field Values

SHORT_DATE_FORMATTER

public static final DateTimeFormatter SHORT_DATE_FORMATTER

FORMAT_TIME_HMS

public static final String FORMAT_TIME_HMS

See Also:

• Constant Field Values

TIME_HMS_FORMATTER

public static final DateTimeFormatter TIME_HMS_FORMATTER

HTTP_DATE_HEADER_FORMAT

public static final DateTimeFormatter HTTP_DATE_HEADER_FORMAT

Method Details

buildFormatter

public static DateTimeFormatter buildFormatter(String format)

buildIso8601Parser

public static DateTimeFormatter buildIso8601Parser()

Builds a DateTimeFormatter that can parse ISO 8601 date-time strings with optional milliseconds and timezone information. The timezone can be either a zone ID (e.g., "Europe/Amsterdam") or an offset (e.g., "+02:00"). Merges DateTimeFormatter.ISO_ZONED_DATE_TIME and DateTimeFormatter.ISO_OFFSET_DATE_TIME into one formatter.

now

public static String now()

now

@Deprecated
public static String now(String format)

Deprecated.

now

public static String now(DateTimeFormatter formatter)

format

@Deprecated
public static @Nullable String format(@Nullable Date date)

Deprecated.

format

public static String format(long date)

format

public static String format(Instant instant)

format

public static String format(long date,
 DateTimeFormatter formatter)

format

@Deprecated
public static String format(Date date,
 DateTimeFormatter formatter)

Deprecated.

format

public static String format(Instant instant,
 DateTimeFormatter formatter)

getTimeStamp

public static String getTimeStamp()

Get current date-time timestamp in generic format.

parseToInstant

public static Instant parseToInstant(String dateString,
 DateTimeFormatter parser)
                              throws DateTimeException

Throws:

DateTimeException

parseToLocalDate

public static LocalDate parseToLocalDate(String dateString)
                                  throws DateTimeParseException

Throws:

DateTimeParseException

parseToLocalDate

public static LocalDate parseToLocalDate(String dateString,
 DateTimeFormatter parser)
                                  throws DateTimeParseException

Throws:

DateTimeParseException

parseAnyDate

@Deprecated
public static Date parseAnyDate(String dateInAnyFormat)
                         throws DateTimeParseException,
IllegalArgumentException

Deprecated.

Parses a string to a Date using CalendarParser

Throws:

DateTimeParseException

IllegalArgumentException

parseGenericDate

public static Instant parseGenericDate(String dateString)
                                throws DateTimeParseException,
IllegalArgumentException

Throws:

DateTimeParseException

IllegalArgumentException

buildParser

public static DateTimeFormatter buildParser(String format)

Java time API is more strict compared to the old Date API. This method allows for parsing dates with optional components. Lenient parser, nanoseconds and timezone is optional. If the timezone is not present, the system default timezone will be used.

Should not be used for formatting, only for parsing. For formatting, use buildFormatter(String).

Parameters:

format - Date formatting pattern according to the rules of the JDK DateTimeFormatter.