Program JULDATE

Usage

    timeshift <YYYYDDD>.<HHMMSS> <HHMMSS>
or
    timeshift --help

Summary

Increment Julian date & time YYYYDDD.HHMMSS by time interval H*MMSS and echothe result to standard output (e.g., for use in scripting).

If --help is the first argument, writes the "USAGE" screen and exits.

Examples

Some sample executions of this program are as indicated below.

Note that in shell-scripting, the back-quote character means "the result of evaluating the enclosed command" so that the third example below sets shell variable foo to the result of executing the indicated timeshift command.

     % timeshift 2014029.120000 183000
     2014030.063000

     % timeshift 2014031.120000 -480000
     2014029.120000

     % @ nhours = 365 * 240000
     % set foo  = `timeshift 2014029 $nhours`
     % echo $foo
     2015029

     % timeshift --help
         DESCRIPTION:  increment date&time by time interval.

         USAGE: timeshift <YYYYDDD.HHMMSS> <HHMMSS>
                timeshift --help
         or (using back-quotes)
         %  set <var> = `timeshift <juldate> <ndays>`

         EXAMPLE: shift by 24h 30m 0s
            % set foo  = `timeshift 2011123.120000 243000
              [${foo}  will be      2011124.123000]
            % set date = $foo:r
            % set time = $foo:e

         yields ${date}==2011124 and ${time}==123000

See Also

EDSS/ Models-3 date-time manipulation routines
datshift
gregdate
greg2jul
juldate
jul2greg
juldiff
julshift
timediff

Previous: GREGDATE
Next: UTMTOOL
Up: Related Programs
To: Models-3/EDSS I/O API: The Help Pages