Tim Jenness > Astro-PAL > stime

Download:
Astro-PAL-1.07.tar.gz

Annotate this POD

Website

View/Report Bugs
Source  

NAME ^

stime - print current time information to standard out

SYNOPSIS ^

  stime

  stime UKIRT

  stime -epoch 837459706 JCMT

  stime -h

DESCRIPTION ^

This program prints current local time, UTC, Julian date, modified Julian date, current equinox and year day to standard output. Additionally, local sidereal time for the specified telescope is also displayed.

ARGUMENTS ^

The optional argument can be used to specify the details for a particular telescope. This affects the local sidereal time calculation. The default is for the LST of Mauna Kea to be listed (specifically the James Clerk Maxwell Telescope). The sidereal time does not reflect the longitude of the computer used to run the command.

The format of this string is identical to that required by palObs routine in the Astro::PAL package.

OPTIONS ^

The following command line options are supported:

-epoch

Override the time for which the LST will be calculated. By default will use the current time/date. This epoch should be supplied in seconds in the Unix epoch (essentially the argument to the perl localtime/gmtime functions).

-help

Simple help message.

-man

This manual page.

OUTPUT ^

Example output of this program is:

 At local date and time         Fri Mar 24 14:50:31 2000
 The UT date and time was:      Sat Mar 25 00:50:31 2000
 Julian date:                   2451628.54
 Modified Julian date:          51628.04
 Equinox for today is           2000.23
 Local Day number (UT):         84 (85)
 For telescope JCMT
 The local sidereal time was    2 39 46.16

SEE ALSO ^

Astro::PAL

REVISION ^

$Id$

COPYRIGHT ^

Copyright (C) 1996-2000,2004 Particle Physics and Astronomy Research Council. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA

AUTHORS ^

Tim Jenness, Remo Tilanus

syntax highlighting: