STIME(1)

📦 version 1.09, in alpine 3.24

STIME(1) — stime: print current time information to standard out 🌸

okay so bestie, this is STIME(1) from the User Contributed Perl Documentation, and it's giving cosmic time decoder ring energy. 🪐✨ Not me being obsessed with sidereal time, but here we are.

🌸 NAME 🌸

stime — print current time information to standard out. That's it. That's the assignment, bestie. 💖

✨ 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. And as if that wasn't already a whole buffet of time info, 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). Important caveat, bestie: 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. iykyk 🫶

🎀 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. Cute, brief, iconic.
  • -man — this manual page. Hi bestie, you're looking at it. 💅

🌈 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 — go give it a lil look, bestie. 🦋

📝 REVISION 📝

$Id$ — yes, that's literally the revision field. iconic. 💀

Legal bestie moment, not me changing a single character:

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 👑

Shoutout to the authors: Tim Jenness, Remo Tilanus. 👑💖

💖 cute sign-off: the footer says perl v5.42.2, dated 2026-02-15, and the manual is STIME(1) — bye bestie! 🫶💅

📦 where this page comes from