com.helger.commons.datetime

Class PDTFormatter

java.lang.Object

com.helger.commons.datetime.PDTFormatter

@Immutable
public final class PDTFormatter
extends Object

Create common DateTimeFormatter objects used for printing and parsing date and time objects.

Author:

Philip Helger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PDTFormatter.CacheKey Internal cache key for PDTFormatter.LocalizedDateFormatCache.
static class	PDTFormatter.LocalizedDateFormatCache This class caches the compiled patterns for localized date and time formatter.

Field Summary

Fields

Modifier and Type	Field and Description
static FormatStyle	DEFAULT_STYLE By default the medium style is used

Method Summary

Modifier and Type	Method and Description
static DateTimeFormatter	getFormatterDate(FormatStyle eStyle, Locale aDisplayLocale, EDTFormatterMode eMode) Get the date formatter for the passed locale.
static DateTimeFormatter	getFormatterDateTime(FormatStyle eStyle, Locale aDisplayLocale, EDTFormatterMode eMode) Get the date time formatter for the passed locale.
static DateTimeFormatter	getFormatterTime(FormatStyle eStyle, Locale aDisplayLocale, EDTFormatterMode eMode) Get the time formatter for the passed locale.
static DateTimeFormatter	getForPattern(String sPattern) Get the DateTimeFormatter for the given pattern, using our default chronology.
static DateTimeFormatter	getForPattern(String sPattern, Locale aDisplayLocale) Get the STRICT DateTimeFormatter for the given pattern and locale, using our default chronology.
static String	getPattern(EDTType eDTType, Locale aLocale, FormatStyle eStyle, EDTFormatterMode eMode)
static DateTimeFormatter	getWithLocale(DateTimeFormatter aFormatter, Locale aDisplayLocale) Assign the passed display locale to the passed date time formatter.
static int	toDateStyle(FormatStyle eStyle)
static FormatStyle	toFormatStyle(int nStyle)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_STYLE

public static final FormatStyle DEFAULT_STYLE

By default the medium style is used

Method Detail

toFormatStyle

@Nonnull
public static FormatStyle toFormatStyle(int nStyle)

toDateStyle

public static int toDateStyle(@Nonnull
                              FormatStyle eStyle)

getPattern

@Nonnull
public static String getPattern(@Nonnull
                                          EDTType eDTType,
                                          @Nullable
                                          Locale aLocale,
                                          @Nonnull
                                          FormatStyle eStyle,
                                          @Nonnull
                                          EDTFormatterMode eMode)

getWithLocale

@Nonnull
public static DateTimeFormatter getWithLocale(@Nonnull
                                                        DateTimeFormatter aFormatter,
                                                        @Nullable
                                                        Locale aDisplayLocale)

Assign the passed display locale to the passed date time formatter.

Parameters:

aFormatter - The formatter to be modified. May not be null.

aDisplayLocale - The display locale to be used. May be null.

Returns:

The modified date time formatter. Never null.

getFormatterDate

@Nonnull
public static DateTimeFormatter getFormatterDate(@Nonnull
                                                           FormatStyle eStyle,
                                                           @Nullable
                                                           Locale aDisplayLocale,
                                                           @Nonnull
                                                           EDTFormatterMode eMode)

Get the date formatter for the passed locale.

Parameters:

eStyle - The format style to be used. May not be null.

aDisplayLocale - The display locale to be used. May be null.

eMode - Print or parse? May not be null.

Returns:

The created date formatter. Never null.

Since:

8.5.6

getFormatterTime

@Nonnull
public static DateTimeFormatter getFormatterTime(@Nonnull
                                                           FormatStyle eStyle,
                                                           @Nullable
                                                           Locale aDisplayLocale,
                                                           @Nonnull
                                                           EDTFormatterMode eMode)

Get the time formatter for the passed locale.

Parameters:

eStyle - The format style to be used. May not be null.

aDisplayLocale - The display locale to be used. May be null.

eMode - Print or parse? May not be null.

Returns:

The created time formatter. Never null.

Since:

8.5.6

getFormatterDateTime

@Nonnull
public static DateTimeFormatter getFormatterDateTime(@Nonnull
                                                               FormatStyle eStyle,
                                                               @Nullable
                                                               Locale aDisplayLocale,
                                                               @Nonnull
                                                               EDTFormatterMode eMode)

Get the date time formatter for the passed locale.

Parameters:

eStyle - The format style to be used. May not be null.

aDisplayLocale - The display locale to be used. May be null.

eMode - Print or parse? May not be null.

Returns:

The created date time formatter. Never null.

Since:

8.5.6

getForPattern

@Nonnull
public static DateTimeFormatter getForPattern(@Nonnull
                                                        String sPattern)

Get the DateTimeFormatter for the given pattern, using our default chronology.

Parameters:

sPattern - The pattern to be parsed

Returns:

The formatter object.

Throws:

IllegalArgumentException - If the pattern is illegal

getForPattern

@Nonnull
public static DateTimeFormatter getForPattern(@Nonnull
                                                        String sPattern,
                                                        @Nullable
                                                        Locale aDisplayLocale)

Get the STRICT DateTimeFormatter for the given pattern and locale, using our default chronology.

Parameters:

sPattern - The pattern to be parsed

aDisplayLocale - The locale to be used. May be null.

Returns:

The formatter object.

Throws:

IllegalArgumentException - If the pattern is illegal