psShowTime

Description

     This program converts time values from operating system
integers to Gregorian format, and vice-versa.

Syntax

psShowTime -Ttext -Foutput_file

-T

Time (operating system time, see Notes.) [current time]

-G

Gregorian Time (YYYYMMDDHHMMSS) [current time]

-F

Name of file to write results [standard output]

PS_SYSMSG_FILE

For the location of the system-wide messages file.

Notes

     Most operating systems keep track of time with integers.  The
operating system time is expressed in 'seconds past midnight, Jan. 1, 1970 UT.'
UT = Universal Coordinated Time.  UT is important.  The time(0) function
always returns the number of seconds past midnight, Jan. 1, 1970 UT.
UT is not the same as GMT.  UT also includes leap seconds as computed
by the US Naval Observatory.  GMT does not.   The US Naval Observatory
adds about 1 leap second every 4 months as dictated by the position of
the moon.
     This program will convert such UT integers into Gregorian format in
the local time zone.  If you enter the number in Gregorian format, then
the program figures out the operating system time.
     This program also computes the Julian day.  Julian day '0' is
at 12 hours UT January 1, 4713 B.C.