org.nuiton.wikitty

Class DateMathParser

java.lang.Object

org.nuiton.wikitty.DateMathParser

public class DateMathParser
extends Object

This class is copy of DateMathParser from SolR librairy, and modified to support ':' to set hour and '=' to set date. A Simple Utility class for parsing "math" like strings relating to Dates.

The basic syntax support addition, subtraction and rounding at various levels of granularity (or "units"). Commands can be chained together and are parsed from left to right. '+' and '-' denote addition and subtraction, while '/' denotes "round". Round requires only a unit, while addition/subtraction require an integer value and a unit. Command strings must not include white space, but the "No-Op" command (empty string) is allowed....

   /HOUR
      ... Round to the start of the current hour
   /DAY
      ... Round to the start of the current day
   +2YEARS
      ... Exactly two years in the future from now
   =????1130
      ... keep year but set date to 30 november
   :12??30
      ... keep minute but set hour to 12 and seconde to 30
   -1DAY
      ... Exactly 1 day prior to now
   /DAY+6MONTHS+3DAYS
      ... 6 months and 3 days in the future from the start of
          the current day
   +6MONTHS+3DAYS/DAY
      ... 6 months and 3 days in the future from now, rounded
          down to nearest day
 

(Multiple aliases exist for the various units of time (ie: MINUTE and MINUTES; MILLI, MILLIS, MILLISECOND, and MILLISECONDS.) The complete list can be found by inspecting the keySet of CALENDAR_UNITS)

All commands are relative to a "now" which is fixed in an instance of DateMathParser such that p.parseMath("+0MILLISECOND").equals(p.parseMath("+0MILLISECOND")) no matter how many wall clock milliseconds elapse between the two distinct calls to parse (Assuming no other thread calls "setNow" in the interim). The default value of 'now' is the time at the moment the DateMathParser instance is constructed, unless overridden by the NOW request param.

All commands are also affected to the rules of a specified TimeZone (including the start/end of DST if any) which determine when each arbitrary day starts. This not only impacts rounding/adding of DAYs, but also cascades to rounding of HOUR, MIN, MONTH, YEAR as well. The default TimeZone used is UTC unless overridden by the TZ request param.

See Also:

SolrRequestInfo#getClientTimeZone, SolrRequestInfo#getNOW

Field Summary

Fields

Modifier and Type	Field and Description
static Map<String,Integer>	CALENDAR_UNITS A mapping from (uppercased) String labels idenyifying time units, to the corresponding Calendar constant used to set/add/roll that unit of measurement.
static Locale	DEFAULT_MATH_LOCALE Default Locale for DateMath rounding (Locale.ROOT)
static TimeZone	DEFAULT_MATH_TZ Default TimeZone for DateMath rounding (UTC)
static TimeZone	UTC

Constructor Summary

Constructors

Constructor and Description
DateMathParser() Default constructor that assumes UTC should be used for rounding unless otherwise specified in the SolrRequestInfo
DateMathParser(TimeZone tz, Locale l)

Method Summary

Methods

Modifier and Type	Method and Description
static void	add(Calendar c, int val, String unit) Modifies the specified Calendar by "adding" the specified value of units
Date	getNow() Returns a cloned of this instance's concept of "now".
Date	parseMath(String math) Parses a string of commands relative "now" are returns the resulting Date.
static void	round(Calendar c, String unit) Modifies the specified Calendar by "rounding" down to the specified unit
static void	setDate(Calendar c, String pattern) Set date with pattern like 2013??01 ex: now=201311 conserve le jour et l'heure mais change le mois et l'annee a novembre 2013 ex: now=????1131 conserve l'annee mais change le mois et le jour 31 novembre ex: now=???????? ne change rien
static void	setHour(Calendar c, String pattern) Set hour with pattern hhmmss now:1200 conserve le jour mais change l'heure a 12:00 now:?????? ne change rien
void	setNow(Date n) Defines this instance's concept of "now".

Methods inherited from class java.lang.Object

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

Field Detail

UTC

public static TimeZone UTC

DEFAULT_MATH_TZ

public static final TimeZone DEFAULT_MATH_TZ

Default TimeZone for DateMath rounding (UTC)

DEFAULT_MATH_LOCALE

public static final Locale DEFAULT_MATH_LOCALE

Default Locale for DateMath rounding (Locale.ROOT)

CALENDAR_UNITS

public static final Map<String,Integer> CALENDAR_UNITS

A mapping from (uppercased) String labels idenyifying time units, to the corresponding Calendar constant used to set/add/roll that unit of measurement.

A single logical unit of time might be represented by multiple labels for convenience (ie: DATE==DAY, MILLI==MILLISECOND)

See Also:

Calendar

Constructor Detail

DateMathParser

public DateMathParser()

Default constructor that assumes UTC should be used for rounding unless otherwise specified in the SolrRequestInfo

See Also:

SolrRequestInfo#getClientTimeZone, DEFAULT_MATH_LOCALE

DateMathParser

public DateMathParser(TimeZone tz,
              Locale l)

Parameters:

tz - The TimeZone used for rounding (to determine when hours/days begin). If null, then this method defaults to the value dicated by the SolrRequestInfo if it exists -- otherwise it uses UTC.

l - The Locale used for rounding (to determine when weeks begin). If null, then this method defaults to en_US.

See Also:

DEFAULT_MATH_TZ, DEFAULT_MATH_LOCALE, Calendar.getInstance(TimeZone,Locale), SolrRequestInfo#getClientTimeZone

Method Detail

setDate

public static void setDate(Calendar c,
           String pattern)

Set date with pattern like 2013??01

ex: now=201311 conserve le jour et l'heure mais change le mois et l'annee a novembre 2013 ex: now=????1131 conserve l'annee mais change le mois et le jour 31 novembre ex: now=???????? ne change rien

Parameters:

c -

pattern -

setHour

public static void setHour(Calendar c,
           String pattern)

Set hour with pattern hhmmss

now:1200 conserve le jour mais change l'heure a 12:00 now:?????? ne change rien