Package org.elasticsearch.common.time
Class DateFormatters
java.lang.Object
org.elasticsearch.common.time.DateFormatters
public class DateFormatters
extends java.lang.Object
-
Field Summary
Fields Modifier and Type Field Description static java.time.temporal.WeekFields
WEEK_FIELDS_ROOT
-
Constructor Summary
Constructors Constructor Description DateFormatters()
-
Method Summary
Modifier and Type Method Description static java.time.ZonedDateTime
from(java.time.temporal.TemporalAccessor accessor)
Convert a temporal accessor to a zoned date time object - as performant as possible.static java.time.ZonedDateTime
from(java.time.temporal.TemporalAccessor accessor, java.util.Locale locale)
static java.time.ZonedDateTime
from(java.time.temporal.TemporalAccessor accessor, java.util.Locale locale, java.time.ZoneId defaultZone)
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Field Details
-
WEEK_FIELDS_ROOT
public static final java.time.temporal.WeekFields WEEK_FIELDS_ROOT
-
-
Constructor Details
-
DateFormatters
public DateFormatters()
-
-
Method Details
-
from
public static java.time.ZonedDateTime from(java.time.temporal.TemporalAccessor accessor)Convert a temporal accessor to a zoned date time object - as performant as possible. The .from() methods from the JDK are throwing exceptions when for example ZonedDateTime.from(accessor) or Instant.from(accessor). This results in a huge performance penalty and should be prevented This method prevents exceptions by querying the accessor for certain capabilities and then act on it accordingly This action assumes that we can reliably fall back to some defaults if not all parts of a zoned date time are set - If a zoned date time is passed, it is returned - If no timezone is found, ZoneOffset.UTC is used - If we find a time and a date, converting to a ZonedDateTime is straight forward, no defaults will be applied - If an accessor only containing of seconds and nanos is found (like epoch_millis/second) an Instant is created out of that, that becomes a ZonedDateTime with a time zone - If no time is given, the start of the day is used - If no month of the year is found, the first day of the year is used - If an iso based weekyear is found, but not week is specified, the first monday of the new year is chosen (reataining BWC to joda time) - If an iso based weekyear is found and an iso based weekyear week, the start of the day is used- Parameters:
accessor
- The accessor returned from a parser- Returns:
- The converted zoned date time
-
from
public static java.time.ZonedDateTime from(java.time.temporal.TemporalAccessor accessor, java.util.Locale locale) -
from
public static java.time.ZonedDateTime from(java.time.temporal.TemporalAccessor accessor, java.util.Locale locale, java.time.ZoneId defaultZone)
-