>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  DT_TM_FROMJS

DT_TM_FROMJS

DT_TM_FROMJS

Name


      DT_TM_FROMJS

Purpose


      Convert "Julian Seconds" to a date/time string.

Category


Calling Sequence


      dt = dt_tm_fromjs(js)

Inputs


      js = "Julian Seconds". in

Keyword Parameters


Keywords


        FORMAT=fmt format for dt (see dt_tm_mak).
          Def = "Y$ n$ d$ h$:m$:s$ w$"
        /FRACTION displays fraction of second in default format.
        DECIMAL=dp Number of decimal places to use for fraction of
          second (def=3) for f$ in format. f$ will include dec pt.
        DENOMINATOR=den If given then fraction is listed as nnn/ddd
          ddd is given by den. Over-rides DECIMAL keyword. Ex:
          DENOM=1000 might give 087/1000 for f$ in format.
        DDECIMAL=ddp Number of decimal places to use in day
          of year (if doy$ included in format, def=none).
        YEAR=yy returns extracted year.
        MONTH=mm returns extracted month.
        DAY=dd returns extracted day.
        SECOND=ss returns extracted seconds after midnight.
        JD=jd returns extracted Julian Day of date.
        NUMBERS=st Returned structure with numeric values.

Outputs


      dt = date/time string. out

Common Blocks


Notes


      Notes: Julian seconds (not an official unit) serve the
        same purpose as Julian Days, interval computations.
        The zero point is 0:00 1 Jan 2000, so js < 0 before then.
        Julian Seconds are double precision and have a precision
        better than 1 millisecond over a span of +/- 1000 years.
     
      See also dt_tm_tojs, ymds2js, js2ymds, jscheck.

Modification History


      R. Sterner, 3 Sep, 1992
      R. Sterner, 18 Aug, 1993 --- Added JD keyword.
      R. Sterner, 2 Dec, 1993 --- Changed default format.
      R. Sterner, 1998 Apr 15 --- Returned NUMBERS structure.
      R. Sterner, 2008 May 27 --- Fixed den check to use n_elements.
      R. Sterner, 2008 May 27 --- If dec not given defaults to 3.
      R. Sterner, 2014 Feb 10 --- Returns null string if NaN.
      R. Sterner, 2014 Feb 22 --- Now returns a scalar if 1 element.
  Copyright (C) 1992, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us