<h2>org.das2.datum.TimeUtil</h2><p>Various time utilities</p>
<hr>
<a name="YEAR"></a>
<h2>YEAR</h2>
<p></p>

<hr>
<a name="MONTH"></a>
<h2>MONTH</h2>
<p></p>

<hr>
<a name="DAY"></a>
<h2>DAY</h2>
<p></p>

<hr>
<a name="HOUR"></a>
<h2>HOUR</h2>
<p></p>

<hr>
<a name="MINUTE"></a>
<h2>MINUTE</h2>
<p></p>

<hr>
<a name="SECOND"></a>
<h2>SECOND</h2>
<p></p>

<hr>
<a name="MILLI"></a>
<h2>MILLI</h2>
<p></p>

<hr>
<a name="MICRO"></a>
<h2>MICRO</h2>
<p></p>

<hr>
<a name="NANO"></a>
<h2>NANO</h2>
<p></p>

<hr>
<a name="WEEK"></a>
<h2>WEEK</h2>
<p></p>

<hr>
<a name="QUARTER"></a>
<h2>QUARTER</h2>
<p></p>

<hr>
<a name="HALF_YEAR"></a>
<h2>HALF_YEAR</h2>
<p></p>

<hr>
<a name="TD_YEAR"></a>
<h2>TD_YEAR</h2>
<p></p>

<hr>
<a name="TD_MONTH"></a>
<h2>TD_MONTH</h2>
<p></p>

<hr>
<a name="TD_DAY"></a>
<h2>TD_DAY</h2>
<p></p>

<hr>
<a name="TD_HOUR"></a>
<h2>TD_HOUR</h2>
<p></p>

<hr>
<a name="TD_MINUTE"></a>
<h2>TD_MINUTE</h2>
<p></p>

<hr>
<a name="TD_SECOND"></a>
<h2>TD_SECOND</h2>
<p></p>

<hr>
<a name="TD_MILLI"></a>
<h2>TD_MILLI</h2>
<p></p>

<hr>
<a name="TD_MICRO"></a>
<h2>TD_MICRO</h2>
<p></p>

<hr>
<a name="TD_NANO"></a>
<h2>TD_NANO</h2>
<p></p>

<hr>
<a name="add"></a>
<h2>add</h2>
add( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> a, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> b ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p></p>

<h3>Parameters</h3>
a - a TimeUtil.TimeStruct
<br>
b - a TimeUtil.TimeStruct

<h3>Returns:</h3>
org.das2.datum.TimeUtil.TimeStruct

<br><br>
<a href="https://github.com/autoplot/dev/search?q=add&unscoped_q=add">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#add">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="borrow"></a>
<h2>borrow</h2>
borrow( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>Normalize the TimeStruct by decrementing higher digits.</p>

<h3>Parameters</h3>
t - the time.

<h3>Returns:</h3>
the normalized TimeStruct
<h3>See Also:</h3>
<a href='null'>normalize(org.das2.datum.TimeUtil.TimeStruct)</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=borrow&unscoped_q=borrow">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#borrow">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="carry"></a>
<h2>carry</h2>
carry( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>Normalize the TimeStruct by incrementing higher digits.  For
 example, 2002-01-01T24:00 &rarr;  2002-01-02T00:00.
 This will only carry one to the next higher place, so 70 seconds is handled but not 130.
 2015-09-08: this now supports leap seconds.</p>

<h3>Parameters</h3>
t - a time structure

<h3>Returns:</h3>
a time structure where extra minutes are moved into hours, etc.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=carry&unscoped_q=carry">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#carry">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="ceil"></a>
<h2>ceil</h2>
ceil( int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>return the next ordinal boundary if we aren't at one already.</p>

<h3>Parameters</h3>
step - the ordinal location, such as TimeUtil.DAY or TimeUtil.HALF_YEAR
<br>
datum - the location.

<h3>Returns:</h3>
the next ordinal boundary if we aren't at one already.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=ceil&unscoped_q=ceil">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#ceil">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="convert"></a>
<h2>convert</h2>
convert( int year, int month, int day, int hour, int minute, double second, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeLocationUnits.html'>org.das2.datum.TimeLocationUnits</a> units ) &rarr; double

<p>convert the month components to a double in the given units.</p>

<h3>Parameters</h3>
year - the year, which must be greater than 1582
<br>
month - the month
<br>
day - the day of month, unless month==0, then day is day of year.
<br>
hour - additional hours
<br>
minute - additional minutes
<br>
second - additional seconds
<br>
units - the Units in which to return the result.

<h3>Returns:</h3>
a double in the given units.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=convert&unscoped_q=convert">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#convert">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<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> s ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>Creates a datum from a string</p>

<h3>Parameters</h3>
s - a String

<h3>Returns:</h3>
a Datum

<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/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.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/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="createTimeDatum"></a>
<h2>createTimeDatum</h2>
createTimeDatum( int year, int month, int day, int hour, int minute, int second, int nano ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>creates a Datum representing the time given in integer years, months, ..., seconds, nanoseconds.  The year
 must be at least 1000, and must be a four-digit year.  A double in Units.us2000 is used to represent the
 Datum, so resolution will drop as the year drops away from 2000.</p>

<h3>Parameters</h3>
year - four digit year &gt;= 1060.
<br>
month - integer month, 1..12.
<br>
day - integer day of month.
<br>
hour - additional hours
<br>
minute - additional minutes
<br>
second - additional seconds
<br>
nano - additional nanoseconds

<h3>Returns:</h3>
a Datum with units Units.us2000.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=createTimeDatum&unscoped_q=createTimeDatum">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#createTimeDatum">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="createValid"></a>
<h2>createValid</h2>
createValid( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> validString ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>creates a Datum from a string which is known to contain
 a valid time format.  Throws a RuntimeException if the
 string is not valid.</p>

<h3>Parameters</h3>
validString - a String

<h3>Returns:</h3>
a Datum

<br><br>
<a href="https://github.com/autoplot/dev/search?q=createValid&unscoped_q=createValid">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#createValid">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="dayContaining"></a>
<h2>dayContaining</h2>
dayContaining( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a>

<p>return a DatumRange for the day containing the given time.  Midnight
 is contained within the following day.</p>

<h3>Parameters</h3>
t - a time.

<h3>Returns:</h3>
the day containing the time.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=dayContaining&unscoped_q=dayContaining">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#dayContaining">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="dayOfYear"></a>
<h2>dayOfYear</h2>
dayOfYear( int month, int day, int year ) &rarr; int

<p>return the day of year for the month and day, for the given year</p>

<h3>Parameters</h3>
month - the month, january=1, february=2, etc.
<br>
day - day of month
<br>
year - four-digit year

<h3>Returns:</h3>
the day of year
<br><br>
<a href="https://github.com/autoplot/dev/search?q=dayOfYear&unscoped_q=dayOfYear">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#dayOfYear">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="daysInMonth"></a>
<h2>daysInMonth</h2>
daysInMonth( int month, int year ) &rarr; int

<p></p>

<h3>Parameters</h3>
month - an int
<br>
year - an int

<h3>Returns:</h3>
int

<br><br>
<a href="https://github.com/autoplot/dev/search?q=daysInMonth&unscoped_q=daysInMonth">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#daysInMonth">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="floor"></a>
<h2>floor</h2>
floor( int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>return the previous ordinal boundary if we aren't at one already.</p>

<h3>Parameters</h3>
step - the ordinal location, such as TimeUtil.DAY or TimeUtil.HALF_YEAR
<br>
datum - the location.

<h3>Returns:</h3>
the previous ordinal boundary if we aren't at one already.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=floor&unscoped_q=floor">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#floor">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="fromDatum"></a>
<h2>fromDatum</h2>
fromDatum( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> time ) &rarr; int[]

<p>returns the 7-element array of components from the time location datum:
 0:year, 1:month, 2:day, 3:hour, 4:minute, 5:second, 6:nanoseconds
 Note special care is taken to not use units conversions which introduce
 noise into the numbers, so the following units are handled directly:
 cdfTT2000, cdfEpoch, us2000, and mj1958.  Also, a separate leap seconds
 table provides the leap seconds, since these are easily managed within
 code, removing the external dependence on a file.</p>

<h3>Parameters</h3>
time - a Datum

<h3>Returns:</h3>
seven-element int array.
<h3>See Also:</h3>
<a href='null'>fromJulianDayAndOffset(int, int, int)</a> <br>
<a href='null'>lastLeapSecond(org.das2.datum.Datum)</a> which uses similar code and is not used because Java doesn't have tuple results.<br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=fromDatum&unscoped_q=fromDatum">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#fromDatum">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="getJulianDay"></a>
<h2>getJulianDay</h2>
getJulianDay( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; int

<p>return the the integer number of days that have elapsed since roughly Monday, January 1, 4713 BC.  Julian Day
 is defined as starting at noon UT, here is is defined starting at midnight.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
an int

<br><br>
<a href="https://github.com/autoplot/dev/search?q=getJulianDay&unscoped_q=getJulianDay">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#getJulianDay">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
getJulianDay( long val, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) &rarr; int<br>
<hr>
<a name="getMicroSecondsSinceMidnight"></a>
<h2>getMicroSecondsSinceMidnight</h2>
getMicroSecondsSinceMidnight( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; double

<p>return the number of microseconds elapsed since the last midnight.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
a double

<br><br>
<a href="https://github.com/autoplot/dev/search?q=getMicroSecondsSinceMidnight&unscoped_q=getMicroSecondsSinceMidnight">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#getMicroSecondsSinceMidnight">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="getSecondsSinceMidnight"></a>
<h2>getSecondsSinceMidnight</h2>
getSecondsSinceMidnight( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; double

<p>return the number of seconds elapsed since the last midnight.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
a double

<br><br>
<a href="https://github.com/autoplot/dev/search?q=getSecondsSinceMidnight&unscoped_q=getSecondsSinceMidnight">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#getSecondsSinceMidnight">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="isLeapYear"></a>
<h2>isLeapYear</h2>
isLeapYear( int year ) &rarr; boolean

<p>return the leap year for years 1901-2099.</p>

<h3>Parameters</h3>
year - an int

<h3>Returns:</h3>
a boolean

<br><br>
<a href="https://github.com/autoplot/dev/search?q=isLeapYear&unscoped_q=isLeapYear">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#isLeapYear">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="isValidTime"></a>
<h2>isValidTime</h2>
isValidTime( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> string ) &rarr; boolean

<p>check to see if the string is parseable as a time.</p>

<h3>Parameters</h3>
string - any string

<h3>Returns:</h3>
true if the string is clearly a time.
<h3>See Also:</h3>
<a href='null'>create(java.lang.String)</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=isValidTime&unscoped_q=isValidTime">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#isValidTime">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="julianDay"></a>
<h2>julianDay</h2>
julianDay( int year, int month, int day ) &rarr; int

<p>return the julianDay for the year month and day.  This was verified
 against another calculation (julianDayWP, commented out above) from 
 http://en.wikipedia.org/wiki/Julian_day.  Both calculations have 20 operations.
 Note this does not match</p>

<h3>Parameters</h3>
year - calendar year greater than 1582.
<br>
month - an int
<br>
day - day of month. For day of year, use month=1 and doy for day.

<h3>Returns:</h3>
the Julian day
<h3>See Also:</h3>
<a href='null'>julianToGregorian</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=julianDay&unscoped_q=julianDay">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#julianDay">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="julianDayIMCCE"></a>
<h2>julianDayIMCCE</h2>
julianDayIMCCE( int YY, int MM, int DD ) &rarr; int

<p>calculation of julianDay based on http://www.imcce.fr/en/grandpublic/temps/jour_julien.php
 This is slightly slower because of a cusp at 1582, but is accurate
 before these times.</p>

<h3>Parameters</h3>
YY - Gregorian year
<br>
MM - Gregorian month
<br>
DD - Gregorian day

<h3>Returns:</h3>
an int

<br><br>
<a href="https://github.com/autoplot/dev/search?q=julianDayIMCCE&unscoped_q=julianDayIMCCE">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#julianDayIMCCE">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="julianToGregorian"></a>
<h2>julianToGregorian</h2>
julianToGregorian( int julian ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>Break the Julian day apart into month, day year.  This is based on
http://en.wikipedia.org/wiki/Julian_day (GNU Public License), and 
was introduced when toTimeStruct failed when the year was 1886.</p>

<h3>Parameters</h3>
julian - the (integer) number of days that have elapsed since the initial epoch at noon Universal Time (UT) Monday, January 1, 4713 BC

<h3>Returns:</h3>
a TimeStruct with the month, day and year fields set.
<h3>See Also:</h3>
<a href='null'>julianDay( int year, int mon, int day )</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=julianToGregorian&unscoped_q=julianToGregorian">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#julianToGregorian">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="lastLeapSecond"></a>
<h2>lastLeapSecond</h2>
lastLeapSecond( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>returns the instant after the last leap second. So for example,
 lastLeapSecond(datum('2020-01-01T00:00')) &rarr; datum('2017-01-01T00:00Z')
 This code is introduced only to provide some transparency to leap second
 handling.  Note that leap seconds before 1970-01-01 are not supported.
 Note that most time units do not include leap seconds, so 
 TimeUtil.lastLeapSecond(datum('2016-12-31T23:60Z')) uses us2000 internally
 and the result is 2017-01-01T00:00Z, not 2015-01-01T00:00Z as one might
 expect.</p>

<h3>Parameters</h3>
t - a time after 1970-01-01

<h3>Returns:</h3>
the instant after the last leap second.
<h3>See Also:</h3>
<a href='#fromDatum which uses similar code.'>fromDatum which uses similar code.</a> which uses similar code.<br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=lastLeapSecond&unscoped_q=lastLeapSecond">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#lastLeapSecond">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.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> args ) &rarr; void

<p></p>

<h3>Parameters</h3>
args - 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/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.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/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="monthNameAbbrev"></a>
<h2>monthNameAbbrev</h2>
monthNameAbbrev( int mon ) &rarr; <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a>

<p>returns "Jan", "Feb", ... for month number (1..12).</p>

<h3>Parameters</h3>
mon - integer from 1 to 12.

<h3>Returns:</h3>
three character English month name.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=monthNameAbbrev&unscoped_q=monthNameAbbrev">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#monthNameAbbrev">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="monthNumber"></a>
<h2>monthNumber</h2>
monthNumber( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> s ) &rarr; int

<p>returns 1..12 for the English month name.  (Sorry, rest of world...)</p>

<h3>Parameters</h3>
s - the three-letter month name, jan,feb,...,nov,dec

<h3>Returns:</h3>
1,2,...,11,12 for the English month name
<br><br>
<a href="https://github.com/autoplot/dev/search?q=monthNumber&unscoped_q=monthNumber">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#monthNumber">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="next"></a>
<h2>next</h2>
next( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeDigit.html'>org.das2.datum.TimeUtil.TimeDigit</a> td, int count, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>return the next boundary</p>

<h3>Parameters</h3>
td - the boundary, e.g. TimeUtil.TD_HALF_YEAR
<br>
count - the number of boundaries
<br>
datum - the starting point.

<h3>Returns:</h3>
the boundary
<br><br>
<a href="https://github.com/autoplot/dev/search?q=next&unscoped_q=next">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#next">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
next( int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a><br>
<hr>
<a name="nextMidnight"></a>
<h2>nextMidnight</h2>
nextMidnight( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>provide the next midnight, similar to the ceil function, noting that
 if the datum provided is midnight already then it is simply returned.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
the Datum for the next day boundary.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=nextMidnight&unscoped_q=nextMidnight">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#nextMidnight">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="nextMonth"></a>
<h2><del>nextMonth</del></h2>
Deprecated: Use next(MONTH,datum) instead
<hr>
<a name="normalize"></a>
<h2>normalize</h2>
normalize( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>convert times like "2000-01-01T24:00" to "2000-01-02T00:00" and
 "2000-002T00:00" to "2000-01-02T00:00".
 This will only carry one to the next higher place, so 70 seconds is handled but not 130.</p>

<h3>Parameters</h3>
t - a TimeUtil.TimeStruct

<h3>Returns:</h3>
an org.das2.datum.TimeUtil.TimeStruct

<h3>See Also:</h3>
<a href='null'>borrow(org.das2.datum.TimeUtil.TimeStruct)</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=normalize&unscoped_q=normalize">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#normalize">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="now"></a>
<h2>now</h2>
now(  ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>return the current time as a Datum.</p>

<h3>Returns:</h3>
the current time as a Datum.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=now&unscoped_q=now">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#now">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="parseTime"></a>
<h2>parseTime</h2>
parseTime( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> s ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>parse the time into a timestruct.</p>

<h3>Parameters</h3>
s - a String

<h3>Returns:</h3>
an org.das2.datum.TimeUtil.TimeStruct

<h3>See Also:</h3>
<a href='null'>createValid(java.lang.String)</a> createValid which creates a Datum.<br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=parseTime&unscoped_q=parseTime">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#parseTime">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="prev"></a>
<h2>prev</h2>
prev( int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>step down the previous ordinal.  If the datum is already at an ordinal
 boundary, then step down by one ordinal.</p>

<h3>Parameters</h3>
step - the ordinal location, such as TimeUtil.DAY or TimeUtil.HALF_YEAR
<br>
datum - the location.

<h3>Returns:</h3>
the prev boundary location.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=prev&unscoped_q=prev">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#prev">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="prevMidnight"></a>
<h2>prevMidnight</h2>
prevMidnight( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>provide the previous midnight, similar to the floor function, noting that
 if the datum provided is midnight exactly then it is simply returned.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
the Datum for the next day boundary.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=prevMidnight&unscoped_q=prevMidnight">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#prevMidnight">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="prevWeek"></a>
<h2>prevWeek</h2>
prevWeek( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>decrement by 7 days.</p>

<h3>Parameters</h3>
datum - a Datum

<h3>Returns:</h3>
the datum
<br><br>
<a href="https://github.com/autoplot/dev/search?q=prevWeek&unscoped_q=prevWeek">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#prevWeek">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="rangeContaining"></a>
<h2>rangeContaining</h2>
rangeContaining( int count, int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> tr ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a>

<p>return the hours or minutes or days interval containing the time range,
 or multiple spans of this when the given range spans boundaries. For example,
 rangeContaining(1,TimeUtil.DAY,datumRange('2024-07-17T23:30/2024-07-18T00:30'))
 would be '2024-07-17/2024-07-19'.</p>

<h3>Parameters</h3>
count - an int
<br>
step - the ordinal unit, such as TimeUtil.DAY or TimeUtil.HALF_YEAR
<br>
tr - the timerange

<h3>Returns:</h3>
the range containing the interval.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=rangeContaining&unscoped_q=rangeContaining">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#rangeContaining">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
rangeContaining( int count, int step, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> t ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a><br>
<hr>
<a name="roundNDigits"></a>
<h2>roundNDigits</h2>
roundNDigits( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> ts, int n ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>round seconds to N decimal places.  For example, n=3 means round to the 
 millisecond.</p>

<h3>Parameters</h3>
ts - a time structure
<br>
n - number of digits, 3 is millis, 6 is micros.

<h3>Returns:</h3>
rounded and normalized TimeStruct.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=roundNDigits&unscoped_q=roundNDigits">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#roundNDigits">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="subtract"></a>
<h2>subtract</h2>
subtract( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> a, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> b ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p></p>

<h3>Parameters</h3>
a - a TimeUtil.TimeStruct
<br>
b - a TimeUtil.TimeStruct

<h3>Returns:</h3>
org.das2.datum.TimeUtil.TimeStruct

<br><br>
<a href="https://github.com/autoplot/dev/search?q=subtract&unscoped_q=subtract">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#subtract">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="toDatum"></a>
<h2>toDatum</h2>
toDatum( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> d ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>convert to Datum without regard to the type of unit used to represent time.
 This will use the canonical Units.us2000 for time locations, which does 
 not represent leap seconds.</p>

<h3>Parameters</h3>
d - the decomposed time or time width.

<h3>Returns:</h3>
the Datum.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=toDatum&unscoped_q=toDatum">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#toDatum">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
toDatum( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a> d, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> u ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a><br>
toDatum( int[] timeArray ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a><br>
toDatum( int[] timeArray, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> u ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a><br>
<hr>
<a name="toDatumDuration"></a>
<h2>toDatumDuration</h2>
toDatumDuration( int[] timeArray ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a>

<p>return approximate duration in Units.seconds or in Units.days.
 This is assuming a year is 365 days, a month is 30 days, and a day 
 is 86400 seconds.</p>

<h3>Parameters</h3>
timeArray - 6 or 7 element array [ yrs, months, days, hours, minutes, seconds, nanos ]

<h3>Returns:</h3>
a Datum

<h3>See Also:</h3>
<a href='null'>DatumRangeUtil#parseISO8601Duration(java.lang.String)</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=toDatumDuration&unscoped_q=toDatumDuration">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#toDatumDuration">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
<hr>
<a name="toTimeArray"></a>
<h2><del>toTimeArray</del></h2>
Deprecated: use 7-element fromDatum instead, which is consistent with toDatum.  Note the array elements are different!
<hr>
<a name="toTimeStruct"></a>
<h2>toTimeStruct</h2>
toTimeStruct( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum/Long.html'>org.das2.datum.Datum.Long</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a>

<p>splits the time location datum into y,m,d,etc components, using the full
 precision of the Long backing the Datum.  The datum can have the units
 of ms1970 or cdf_tt2000, and</p>

<h3>Parameters</h3>
datum - with time location units.

<h3>Returns:</h3>
TimeStruct containing the time components.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=toTimeStruct&unscoped_q=toTimeStruct">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/TimeUtil.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/TimeUtil.html#toTimeStruct">[view on old javadoc]</a>
 <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/TimeUtil.java">[view source]</a>
<br>
<br>
toTimeStruct( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeUtil/TimeStruct.html'>org.das2.datum.TimeUtil.TimeStruct</a><br>