/usr/share/doc/stilts/sun256/uk.ac.starlink.ttools.func.Times.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Times</title>
</head>
<body>
<hr>
<a href="uk.ac.starlink.ttools.func.Arrays.html">Next</a> <a href="uk.ac.starlink.ttools.func.Distances.html">Previous</a> <a href="staticMethods.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="uk.ac.starlink.ttools.func.Arrays.html">Arrays</a><br>
<b>Up: </b><a href="staticMethods.html">Functions</a><br>
<b>Previous: </b><a href="uk.ac.starlink.ttools.func.Distances.html">Distances</a><br>
<hr>
<h4><a name="uk.ac.starlink.ttools.func.Times">10.5.5 Times</a></h4>
<p>Functions for conversion of time values between various forms.
The forms used are
<dl>
<dt><strong>Modified Julian Date (MJD)</strong></dt>
<dd>A continuous measure in days since midnight at the start of
17 November 1858. Based on UTC.
</dd>
<dt><strong>ISO 8601</strong></dt>
<dd>A string representation of the form
<code>yyyy-mm-ddThh:mm:ss.s</code>, where the <code>T</code>
is a literal character (a space character may be used instead).
Based on UTC.
</dd>
<dt><strong>Julian Epoch</strong></dt>
<dd>A continuous measure based on a Julian year of exactly 365.25 days.
For approximate purposes this resembles the fractional number
of years AD represented by the date. Sometimes (but not here)
represented by prefixing a 'J'; J2000.0 is defined as
2000 January 1.5 in the TT timescale.
</dd>
<dt><strong>Besselian Epoch</strong></dt>
<dd>A continuous measure based on a tropical year of about 365.2422 days.
For approximate purposes this resembles the fractional number of
years AD represented by the date. Sometimes (but not here)
represented by prefixing a 'B'.
</dd>
<dt><strong>Decimal Year</strong></dt>
<dd>Fractional number of years AD represented by the date.
2000.0, or equivalently 1999.99recurring, is midnight at the start
of the first of January 2000. Because of leap years, the size of
a unit depends on what year it is in.
</dd>
</dl>
</p>
<p>Therefore midday on the 25th of October 2004 is
<code>2004-10-25T12:00:00</code> in ISO 8601 format,
53303.5 as an MJD value,
2004.81588 as a Julian Epoch and
2004.81726 as a Besselian Epoch.
</p>
<p>Currently this implementation cannot be relied upon to
better than a millisecond.
</p>
<p>
<dl>
<dt><strong><code>isoToMjd( isoDate )</code></strong></dt>
<dd>Converts an ISO8601 date string to Modified Julian Date.
The basic format of the <code>isoDate</code> argument is
<code>yyyy-mm-ddThh:mm:ss.s</code>, though some deviations
from this form are permitted:
<ul>
<li>The '<code>T</code>' which separates date from time
can be replaced by a space
</li>
<li>The seconds, minutes and/or hours can be omitted</li>
<li>The decimal part of the seconds can be any length,
and is optional
</li>
<li>A '<code>Z</code>' (which indicates UTC) may be appended
to the time
</li>
</ul>
Some legal examples are therefore:
"<code>1994-12-21T14:18:23.2</code>",
"<code>1968-01-14</code>", and
"<code>2112-05-25 16:45Z</code>".
<ul>
<li><code>isoDate</code> <em>(String)</em>: date in ISO 8601 format
</li>
<li>return value <em>(floating point)</em>: modified Julian date corresponding to <code>isoDate</code></li>
</ul>
</dd>
<dt><strong><code>dateToMjd( year, month, day, hour, min, sec )</code></strong></dt>
<dd>Converts a calendar date and time to Modified Julian Date.
<ul>
<li><code>year</code> <em>(integer)</em>: year AD
</li>
<li><code>month</code> <em>(integer)</em>: index of month; January is 1, December is 12
</li>
<li><code>day</code> <em>(integer)</em>: day of month (the first day is 1)
</li>
<li><code>hour</code> <em>(integer)</em>: hour (0-23)
</li>
<li><code>min</code> <em>(integer)</em>: minute (0-59)
</li>
<li><code>sec</code> <em>(floating point)</em>: second (0<=sec<60)
</li>
<li>return value <em>(floating point)</em>: modified Julian date corresponding to arguments
</li>
</ul>
</dd>
<dt><strong><code>dateToMjd( year, month, day )</code></strong></dt>
<dd>Converts a calendar date to Modified Julian Date.
<ul>
<li><code>year</code> <em>(integer)</em>: year AD
</li>
<li><code>month</code> <em>(integer)</em>: index of month; January is 1, December is 12
</li>
<li><code>day</code> <em>(integer)</em>: day of month (the first day is 1)
</li>
<li>return value <em>(floating point)</em>: modified Julian date corresponding to 00:00:00 of the date
specified by the arguments
</li>
</ul>
</dd>
<dt><strong><code>decYearToMjd( decYear )</code></strong></dt>
<dd>Converts a Decimal Year to a Modified Julian Date.
<ul>
<li><code>decYear</code> <em>(floating point)</em>: decimal year
</li>
<li>return value <em>(floating point)</em>: modified Julian Date
</li>
</ul>
</dd>
<dt><strong><code>mjdToIso( mjd )</code></strong></dt>
<dd>Converts a Modified Julian Date value to an ISO 8601-format date-time
string. The output format is <code>yyyy-mm-ddThh:mm:ss</code>.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(String)</em>: ISO 8601 format date corresponding to <code>mjd</code></li>
</ul>
</dd>
<dt><strong><code>mjdToDate( mjd )</code></strong></dt>
<dd>Converts a Modified Julian Date value to an ISO 8601-format date
string. The output format is <code>yyyy-mm-dd</code>.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(String)</em>: ISO 8601 format date corresponding to <code>mjd</code></li>
</ul>
</dd>
<dt><strong><code>mjdToTime( mjd )</code></strong></dt>
<dd>Converts a Modified Julian Date value to an ISO 8601-format time-only
string. The output format is <code>hh:mm:ss</code>.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(String)</em>: ISO 8601 format time corresponding to <code>mjd</code></li>
</ul>
</dd>
<dt><strong><code>mjdToDecYear( mjd )</code></strong></dt>
<dd>Converts a Modified Julian Date to Decimal Year.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian Date
</li>
<li>return value <em>(floating point)</em>: decimal year
</li>
</ul>
</dd>
<dt><strong><code>formatMjd( mjd, format )</code></strong></dt>
<dd>Converts a Modified Julian Date value to a date using a customisable
date format.
The format is as defined by the
<a href="http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html"><code>java.text.SimpleDateFormat</code></a> class.
The default output corresponds to the string
"<code>yyyy-MM-dd'T'HH:mm:ss</code>"
<p>Note that the output from certain formatting characters
(such as <code>MMM</code> for month, <code>EEE</code> for day of week)
is dependent on your locale (system language settings).
The output time zone however always corresponds to UTC.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li><code>format</code> <em>(String)</em>: formatting patttern
</li>
<li>return value <em>(String)</em>: custom formatted time corresponding to <code>mjd</code></li>
</ul>
</p>
</dd>
<dt><strong><code>mjdToJulian( mjd )</code></strong></dt>
<dd>Converts a Modified Julian Date to Julian Epoch.
For approximate purposes, the result
of this routine consists of an integral part which gives the
year AD and a fractional part which represents the distance
through that year, so that for instance 2000.5 is approximately
1 July 2000.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(floating point)</em>: Julian epoch
</li>
</ul>
</dd>
<dt><strong><code>julianToMjd( julianEpoch )</code></strong></dt>
<dd>Converts a Julian Epoch to Modified Julian Date.
For approximate purposes, the argument
of this routine consists of an integral part which gives the
year AD and a fractional part which represents the distance
through that year, so that for instance 2000.5 is approximately
1 July 2000.
<ul>
<li><code>julianEpoch</code> <em>(floating point)</em>: Julian epoch
</li>
<li>return value <em>(floating point)</em>: modified Julian date
</li>
</ul>
</dd>
<dt><strong><code>mjdToBesselian( mjd )</code></strong></dt>
<dd>Converts Modified Julian Date to Besselian Epoch.
For approximate purposes, the result
of this routine consists of an integral part which gives the
year AD and a fractional part which represents the distance
through that year, so that for instance 1950.5 is approximately
1 July 1950.
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(floating point)</em>: Besselian epoch
</li>
</ul>
</dd>
<dt><strong><code>besselianToMjd( besselianEpoch )</code></strong></dt>
<dd>Converts Besselian Epoch to Modified Julian Date.
For approximate purposes, the argument
of this routine consists of an integral part which gives the
year AD and a fractional part which represents the distance
through that year, so that for instance 1950.5 is approximately
1 July 1950.
<ul>
<li><code>besselianEpoch</code> <em>(floating point)</em>: Besselian epoch
</li>
<li>return value <em>(floating point)</em>: modified Julian date
</li>
</ul>
</dd>
<dt><strong><code>unixMillisToMjd( unixMillis )</code></strong></dt>
<dd>Converts from milliseconds since the Unix epoch (1970-01-01T00:00:00)
to a modified Julian date value
<ul>
<li><code>unixMillis</code> <em>(long integer)</em>: milliseconds since the Unix epoch
</li>
<li>return value <em>(floating point)</em>: modified Julian date
</li>
</ul>
</dd>
<dt><strong><code>mjdToUnixMillis( mjd )</code></strong></dt>
<dd>Converts from modified Julian date to milliseconds since the Unix
epoch (1970-01-01T00:00:00).
<ul>
<li><code>mjd</code> <em>(floating point)</em>: modified Julian date
</li>
<li>return value <em>(long integer)</em>: milliseconds since the Unix epoch
</li>
</ul>
</dd>
</dl>
</p>
<hr><a href="uk.ac.starlink.ttools.func.Arrays.html">Next</a> <a href="uk.ac.starlink.ttools.func.Distances.html">Previous</a> <a href="staticMethods.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="uk.ac.starlink.ttools.func.Arrays.html">Arrays</a><br>
<b>Up: </b><a href="staticMethods.html">Functions</a><br>
<b>Previous: </b><a href="uk.ac.starlink.ttools.func.Distances.html">Distances</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|