Package org.elasticsearch.common.time
Interface DateFormatter
-
public interface DateFormatter
-
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description Stringformat(TemporalAccessor accessor)Print the supplied java time accessor in a string based representation according to this formatterdefault StringformatJoda(org.joda.time.DateTime dateTime)Return the given JodaDateTimeformatted with this format.default StringformatMillis(long millis)Return the given millis-since-epoch formatted with this format.static DateFormatterforPattern(String input)Localelocale()Returns the configured locale of the date formatterTemporalAccessorparse(String input)Try to parse input to a java time TemporalAccessordefault org.joda.time.DateTimeparseJoda(String input)Parse the given input into a JodaDateTime.default longparseMillis(String input)Parse the given input into millis-since-epoch.Stringpattern()A name based format for this formatter.static List<String>splitCombinedPatterns(String input)DateMathParsertoDateMathParser()Create a DateMathParser from the existing formatterDateFormatterwithLocale(Locale locale)Create a copy of this formatter that is configured to parse dates in the specified localeDateFormatterwithZone(ZoneId zoneId)Create a copy of this formatter that is configured to parse dates in the specified time zoneZoneIdzone()Returns the configured time zone of the date formatter
-
-
-
Method Detail
-
parse
TemporalAccessor parse(String input)
Try to parse input to a java time TemporalAccessor- Parameters:
input- An arbitrary string resembling the string representation of a date or time- Returns:
- The java time object containing the parsed input
- Throws:
DateTimeParseException- If parsing fails, this exception will be thrown. Note that it can contained suppressed exceptions when several formatters failed parse this value
-
parseMillis
default long parseMillis(String input)
Parse the given input into millis-since-epoch.
-
parseJoda
default org.joda.time.DateTime parseJoda(String input)
Parse the given input into a JodaDateTime.
-
withZone
DateFormatter withZone(ZoneId zoneId)
Create a copy of this formatter that is configured to parse dates in the specified time zone- Parameters:
zoneId- The time zone to act on- Returns:
- A copy of the date formatter this has been called on
-
withLocale
DateFormatter withLocale(Locale locale)
Create a copy of this formatter that is configured to parse dates in the specified locale- Parameters:
locale- The local to use for the new formatter- Returns:
- A copy of the date formatter this has been called on
-
format
String format(TemporalAccessor accessor)
Print the supplied java time accessor in a string based representation according to this formatter- Parameters:
accessor- The temporal accessor used to format- Returns:
- The string result for the formatting
-
formatMillis
default String formatMillis(long millis)
Return the given millis-since-epoch formatted with this format.
-
formatJoda
default String formatJoda(org.joda.time.DateTime dateTime)
Return the given JodaDateTimeformatted with this format.
-
pattern
String pattern()
A name based format for this formatter. Can be one of the registered formatters likeepoch_millisor a configured format likeHH:mm:ss- Returns:
- The name of this formatter
-
locale
Locale locale()
Returns the configured locale of the date formatter- Returns:
- The locale of this formatter
-
zone
ZoneId zone()
Returns the configured time zone of the date formatter- Returns:
- The time zone of this formatter
-
toDateMathParser
DateMathParser toDateMathParser()
Create a DateMathParser from the existing formatter- Returns:
- The DateMathParser object
-
forPattern
static DateFormatter forPattern(String input)
-
-