Time specifications at the command line are used for selecting the time-span
for data processing. These specifications require two out of the sTime, eTime
and dTime arguments. sTime and eTime refer to the start and end time of the
time window, and can be specified according to Supported Time Formats below.
Additionally, dTime argument can be used to specify the time-span, according
to Supported Time Span Formats below. If sTime and eTime are used, the
time-span is the length of time between sTime and eTime. Alternatively, if
dTime is used in conjunction with either sTime or eTime, dTime defines the
length of the time-span.
The fixed formats supported are:
[yy]yy/mm/dd[,hh:mm:ss] or ddmmmyy[yy],hhmmss] or [yy]yyMMdd[hhmmss]
By default, fixed time zones are assumed to be in the time zone of the
host machine. Two options exist for altering default the time zone used
for interpreting time arguments:
1) The time zone may be appended onto the end of any of these
formats with "::". For example, "06OCT1985,000000::GMT"
2) The -Duser.timezone java argument may be used
(i.e. java -Duser.timezone="GMT") to specify the default time zone.
The relative generalized format is of the form T[{-|+}nnUU][@[[[[mm:]dd:]hh:]mm:]ss]
Where T signifies current time. The optional - or + is used to signify
the adjustment is before or after current time.
'nn' is the amount of time to adjust T by. 'uu' is the units of time and
can be one of the set Y[ears], Mo[nths], D[ays], H[ours], M[inutes], and S[econds].
The [@[[[[mm:]dd:]hh:]mm:]ss] is used to specify a fixed portion for the
date. If @ is specified then so must the seconds 'ss' at a minimum.
Examples of relative date specifications:
-sTime T-3D - Set the the starting time to 3 days prior to the
current date/time.
-sTime T+24H@07:00:00 - Add 24 hours to the current date/time and
then adjust the time to 0700 in the morning.
-sTime T+1Month@3:16:30:00 - Add 1 month to the current date/time
and then adjust it to the third day of the month at 1630.
The amount of time from either the start or end time expressed in one of 3 formats:
nnX where nn is the number of intervals of the given interval type.
e.g. -dTime 10days or -dTime 3600seconds
ddd.hh:mm:ss where days is optional but the hours minutes and seconds
are required.
e.g. -dTime 4.8:11:00 (https://www.w3.org/TR/xmlschema11-2/#time specification)
PnYnMnDTnHnMnS (or PnYnMnD or TnHnMnS)
e.g. -dTime P1Y2M3DT6H30M25S (https://www.w3.org/TR/xmlschema-2/#duration specification)
Time Unit specifications
Time span units can be Days, Hours, Minutes or Seconds. Relative time specification
units can be Years, Months, Days, Hours, Minutes, or Seconds. Minimum specification text
of time units are described in the table below. Any amount of the full unit name can be
used, as long as the minimum specification text is provided. For example, 1Month,
1Mon, and 1Mo would all result in one month being specified, but 1M would result in one
minute being specified. Time units are not case sensitive.
Units | Minimum Specification Text |
---|
Years | Y |
Months | Mo |
Days | D |
Hours | H |
Minutes | M |
Seconds | S |