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
-