<h2>org.das2.datum.TimeParser</h2><p>TimeParser designed to quickly parse strings with a known format. This parser has been
shown to perform around 20 times faster than the discovery parser.
This class is not thread-safe, so clients must make sure that only one thread accesses the class at a time.</p>
<hr>
<a name="TIMEFORMAT_Z"></a>
<h2>TIMEFORMAT_Z</h2>
<p>$Y-$m-$dT$H:$M:$S.$(subsec;places=3)Z</p>
<hr>
<a name="IGNORE_FIELD_HANDLER"></a>
<h2>IGNORE_FIELD_HANDLER</h2>
<p>handy FieldHandler that ignores the contents. For example,
<pre>tp= TimeParser.create(sagg,"v", TimeParser.IGNORE_FIELD_HANDLER );</pre></p>
<hr>
<a name="create"></a>
<h2>create</h2>
create( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> formatString ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a>
<p>Create a TimeParser object, which is the fast time parser for use when a known format specification is used to
parse many instances of a formatted string. For example, this would be used to interpret the times in an text file,
but not times entered in a time range GUI to control an axis. This can also be and is used for filenames,
for example omni2_h0_mrg1hr_$Y$(m,span=6)01_v01.cdf.
Note field lengths are used when formatting the data, but when parsing often fractional components are accepted. For
example, the format might be "%Y %j %H", and "2012 365 12.003" is accepted.
Note also that often $(Y) is used where %{Y} is used. These are equivalent, and useful when $() interferes with parsing
elsewhere.
URI_Templates is a public project with translations to Java, JavaScript, and Python, and provides an specification for
this. See https://github.com/hapi-server/uri-templates/wiki/Specification .
<pre>
$[fieldLength]<1-char code> or
$[fieldLength](<code>)
$[fieldLength](<code>;qualifiers)
fieldLength=0 --> makes field length indeterminate, deliminator must follow.
$Y 4-digit year
$y 2-digit year
$j 3-digit day of year
$m 2-digit month
$b 3-char month name (jan,feb,mar,apr,may,jun,jul,aug,sep,oct,nov,dec. Sorry, rest of world...)
$d 2-digit day
$H 2-digit hour
$M 2-digit minute
$S 2-digit second
$(milli) 3-digit milliseconds
$(ignore) skip this field
$x skip this field
$(enum) skip this field. If id is specified, then id can be retrieved.
$v skip this field
$(hrinterval;values=0,1,2,3) enumeration of part of day
$(subsec;places=6) fractional seconds (6->microseconds)
$(periodic;offset=0;start=2000-001;period=P1D)
Qualifiers:
span=<int>
delta=<int>
Y=2004 Also for Y,m,d,H,M,S
For example:
$(j;Y=2004) means the day-of-year, within the year 2004.
$(H;Y=2004;j=117) means the hour of day 2004-117
$(m;span=6) means the 6-month interval starting at the given month.
</pre></p>
<h3>Parameters</h3>
formatString - the format string.
<h3>Returns:</h3>
the time parser.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=create&unscoped_q=create">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#create">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
create( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> formatString, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> fieldName, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser/FieldHandler.html'>org.das2.datum.TimeParser.FieldHandler</a> handler, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html'>Object[]</a> moreHandler ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a><br>
<hr>
<a name="format"></a>
<h2>format</h2>
format( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> range ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a>
<p>return the formatted range. This actually returns the range that contains the min
of the given range.</p>
<h3>Parameters</h3>
range - a DatumRange
<h3>Returns:</h3>
a String
<br><br>
<a href="https://github.com/autoplot/dev/search?q=format&unscoped_q=format">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#format">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
format( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> start ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a><br>
format( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> start, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> stop ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a><br>
format( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> start, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> stop, <a href='https://docs.oracle.com/javase/8/docs/api/java/util/Map.html'>java.util.Map</a> extra ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a><br>
<hr>
<a name="getEndTime"></a>
<h2>getEndTime</h2>
getEndTime( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → double
<p>return the end time of the range in units, e.g. Units.us2000</p>
<h3>Parameters</h3>
units - an Units
<h3>Returns:</h3>
a double
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getEndTime&unscoped_q=getEndTime">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getEndTime">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getFieldHandlerByCode"></a>
<h2>getFieldHandlerByCode</h2>
getFieldHandlerByCode( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> code ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser/FieldHandler.html'>org.das2.datum.TimeParser.FieldHandler</a>
<p>return the field handler for the id. For example, enum
returns the field handler handling enumerations. Note there
is currently only one field handler for each type, so for example
two enumerations are not allowed.</p>
<h3>Parameters</h3>
code - a String
<h3>Returns:</h3>
the field handler.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getFieldHandlerByCode&unscoped_q=getFieldHandlerByCode">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getFieldHandlerByCode">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getFieldHandlerById"></a>
<h2>getFieldHandlerById</h2>
getFieldHandlerById( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> id ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser/FieldHandler.html'>org.das2.datum.TimeParser.FieldHandler</a>
<p>return the field handler for the id. For example, enum
returns the field handler handling enumerations. Note there
is currently only one field handler for each type, so for example
two enumerations are not allowed.</p>
<h3>Parameters</h3>
id - the field handler id
<h3>Returns:</h3>
the field handler.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getFieldHandlerById&unscoped_q=getFieldHandlerById">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getFieldHandlerById">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getPad"></a>
<h2>getPad</h2>
getPad( <a href='https://docs.oracle.com/javase/8/docs/api/java/util/Map.html'>java.util.Map</a> args ) → char
<p>return the pad for the spec, like "underscore" "space" "zero" or "none"
For "none", space is returned, and clients allowing special behavior should check for this.</p>
<h3>Parameters</h3>
args - a java.util.Map
<h3>Returns:</h3>
the char, or (char)0.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getPad&unscoped_q=getPad">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getPad">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getRegex"></a>
<h2>getRegex</h2>
getRegex( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a>
<p>peek at the regular expression used.</p>
<h3>Returns:</h3>
a String
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getRegex&unscoped_q=getRegex">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getRegex">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getTime"></a>
<h2>getTime</h2>
getTime( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → double
<p>return the parsed time in the given units. Here Autoplot
Jython code shows how this is used:
<code>
from org.virbo.dataset import SemanticOps
tp= TimeParser.create("$Y-$m-$dT$H")
u= SemanticOps.lookupTimeUnits("seconds since 2014-01-01T00:00")
print tp.parse("2014-01-06T02").getTime( u )
</code></p>
<h3>Parameters</h3>
units - as in Units.us2000
<h3>Returns:</h3>
the value in the given units.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getTime&unscoped_q=getTime">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getTime">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getTimeDatum"></a>
<h2>getTimeDatum</h2>
getTimeDatum( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>
<p>return the parsed time as a Datum. For years less than 1990,
Units.us1980 is used, otherwise Units.us2000 is used.</p>
<h3>Returns:</h3>
a datum representing the parsed time.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getTimeDatum&unscoped_q=getTimeDatum">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getTimeDatum">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getTimeRange"></a>
<h2>getTimeRange</h2>
getTimeRange( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a>
<p>Returns the implicit interval as a DatumRange.
For example, "Jan 1, 2003" would have a getTimeDatum of "Jan 1, 2003 00:00:00",
and getDatumRange() would go from midnight to midnight.
This will try to create MonthDatumRanges when possible, to keep it abstract,
so for example,
<blockquote><pre>
tr= tp.getTimeRange() // "Jan 2015"
tr= tr.next() // "Feb 2015", not 31 days starting Feb 1
</pre></blockquote>
This accesses time, timeWidth, orbitDatumRange, startTime.</p>
<h3>Returns:</h3>
the DatumRange
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getTimeRange&unscoped_q=getTimeRange">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getTimeRange">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="getValidRange"></a>
<h2>getValidRange</h2>
getValidRange( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a>
<p>return the limits of the range we can parse. These limits come from
orbit files like "$(o,sc=rbspa-pp)"
or from explicit fields like "$(M,Y=1999)"</p>
<h3>Returns:</h3>
a DatumRange
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getValidRange&unscoped_q=getValidRange">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#getValidRange">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="hasField"></a>
<h2>hasField</h2>
hasField( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> field ) → boolean
<p>return true if the parser has a field.</p>
<h3>Parameters</h3>
field - e.g. "x"
<h3>Returns:</h3>
true if the parser has a field.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=hasField&unscoped_q=hasField">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#hasField">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="isIso8601String"></a>
<h2>isIso8601String</h2>
isIso8601String( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> exampleTime ) → boolean
<p>return true if the string appears to be an ISO8601 time. This
requires that the string contain a "T" or space and the hours and
minutes components.</p>
<h3>Parameters</h3>
exampleTime - string like "1992-353T02:00"
<h3>Returns:</h3>
true if the string appears to be an ISO8601 time.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=isIso8601String&unscoped_q=isIso8601String">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#isIso8601String">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="isNested"></a>
<h2>isNested</h2>
isNested( ) → boolean
<p>return true if each successive field is nested within the previous,
e.g. $Y$m/$d is nested, but $Y$m/$Y$m$d is not because of the second $Y.</p>
<h3>Returns:</h3>
true if the spec is nested.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=isNested&unscoped_q=isNested">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#isNested">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="isSpec"></a>
<h2>isSpec</h2>
isSpec( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> spec ) → boolean
<p>Provide standard means of indicating this appears to be a spec by
looking for something that would assert the year.</p>
<h3>Parameters</h3>
spec - a String
<h3>Returns:</h3>
true if the string appears to be a spec.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=isSpec&unscoped_q=isSpec">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#isSpec">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="isStartTimeOnly"></a>
<h2>isStartTimeOnly</h2>
isStartTimeOnly( ) → boolean
<p>true if the flag (startTimeOnly) was set in the spec. This is a hint to clients (FileStorageModel) using the time that
it shouldn't infer that the time is bounded.</p>
<h3>Returns:</h3>
a boolean
<br><br>
<a href="https://github.com/autoplot/dev/search?q=isStartTimeOnly&unscoped_q=isStartTimeOnly">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#isStartTimeOnly">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="iso8601String"></a>
<h2>iso8601String</h2>
iso8601String( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> exampleTime ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a>
<p>must contain T or space to delimit date and time.</p>
<h3>Parameters</h3>
exampleTime - "1992-353T02:00"
<h3>Returns:</h3>
"$Y-$jT$H$M" etc.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=iso8601String&unscoped_q=iso8601String">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#iso8601String">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="main"></a>
<h2>main</h2>
main( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> aa ) → void
<p></p>
<h3>Parameters</h3>
aa - a java.lang.String[]
<h3>Returns:</h3>
void (returns nothing)
<br><br>
<a href="https://github.com/autoplot/dev/search?q=main&unscoped_q=main">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#main">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="parse"></a>
<h2>parse</h2>
parse( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> timeString ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a>
<p>parse the string, which presumably contains a time matching the
spec. A reference to the TimeParser is returned so operations can be
chained together:<code>
tp.parse("2014-01-06T02").getTime( Units.us2000 )
</code>
Since this the TimeParser has a state, it is not safe to use simultaneously
by multiple threads. Each thread should create its own parser.</p>
<h3>Parameters</h3>
timeString - string containing a time
<h3>Returns:</h3>
a reference to this TimeParser object, which now contains the time.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=parse&unscoped_q=parse">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#parse">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
parse( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> timeString, <a href='https://docs.oracle.com/javase/8/docs/api/java/util/Map.html'>java.util.Map</a> extra ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a><br>
<hr>
<a name="setContext"></a>
<h2>setContext</h2>
setContext( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> tr ) → void
<p>explicitly set the context for time parsing. For example,
filenames are just $H$M$S.dat, and the context is "Jan 17th, 2015"
Note that the context is stored internally as just a start time, so
spans (e.g. 3-day) are not supported.</p>
<h3>Parameters</h3>
tr - the range
<h3>Returns:</h3>
void (returns nothing)
<br><br>
<a href="https://github.com/autoplot/dev/search?q=setContext&unscoped_q=setContext">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#setContext">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="setDigit"></a>
<h2>setDigit</h2>
setDigit( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> format, double value ) → void
<p>set the digit with the integer part, and move the fractional part to the
less significant digits. Format should contain just one field,
see setDigit( String format, int value ) to break up fields.</p>
<h3>Parameters</h3>
format - like "Y"
<br>
value - like 2014
<h3>Returns:</h3>
void (returns nothing)
<br><br>
<a href="https://github.com/autoplot/dev/search?q=setDigit&unscoped_q=setDigit">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#setDigit">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
setDigit( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> format, int value ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a><br>
setDigit( int digitNumber, int digit ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a><br>
<hr>
<a name="sloppyColumns"></a>
<h2>sloppyColumns</h2>
sloppyColumns( ) → void
<p>force the parser to look for delimiters. This should be called immediately after</p>
<h3>Returns:</h3>
void (returns nothing)
<br><br>
<a href="https://github.com/autoplot/dev/search?q=sloppyColumns&unscoped_q=sloppyColumns">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#sloppyColumns">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="testTimeParser"></a>
<h2>testTimeParser</h2>
testTimeParser( ) → void
<p>test time parsing when the format is known. This time parser is much faster than the time parser of Test009, which must
infer the format as it parses.</p>
<h3>Returns:</h3>
void (returns nothing)
<br><br>
<a href="https://github.com/autoplot/dev/search?q=testTimeParser&unscoped_q=testTimeParser">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#testTimeParser">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>
<hr>
<a name="toString"></a>
<h2>toString</h2>
toString( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a>
<p></p>
<h3>Returns:</h3>
java.lang.String
<br><br>
<a href="https://github.com/autoplot/dev/search?q=toString&unscoped_q=toString">[search for examples]</a>
<a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeParser.md">[view on GitHub]</a>
<a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeParser.html#toString">[view on old javadoc]</a>
<a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeParser.java">[view source]</a>
<br>
<br>