Package org.elasticsearch.common.time
Interface DateFormatter
- All Known Implementing Classes:
JodaDateFormatter
public interface DateFormatter
-
Method Summary
Modifier and TypeMethodDescriptionformat(TemporalAccessor accessor)
Print the supplied java time accessor in a string based representation according to this formatterdefault String
formatJoda(org.joda.time.DateTime dateTime)
Return the given JodaDateTime
formatted with this format.default String
formatMillis(long millis)
Return the given millis-since-epoch formatted with this format.static DateFormatter
forPattern(String input)
locale()
Returns the configured locale of the date formatterTry to parse input to a java time TemporalAccessordefault org.joda.time.DateTime
Parse the given input into a JodaDateTime
.default long
parseMillis(String input)
Parse the given input into millis-since-epoch.pattern()
A name based format for this formatter.splitCombinedPatterns(String input)
static String
strip8Prefix(String input)
Create a DateMathParser from the existing formatterwithLocale(Locale locale)
Create a copy of this formatter that is configured to parse dates in the specified localeCreate a copy of this formatter that is configured to parse dates in the specified time zonezone()
Returns the configured time zone of the date formatter
-
Method Details
-
parse
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
Parse the given input into millis-since-epoch. -
parseJoda
Parse the given input into a JodaDateTime
. -
withZone
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
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
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
Return the given millis-since-epoch formatted with this format. -
formatJoda
Return the given JodaDateTime
formatted with this format. -
pattern
String pattern()A name based format for this formatter. Can be one of the registered formatters likeepoch_millis
or 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
-
strip8Prefix
-
splitCombinedPatterns
-