++ed by:
1 non-PAUSE user
Author image Sergey Krushinsky
and 1 contributors


rst_almanac — calculate rise, set and transit times of Sun, Moon and the planets.


  rst_almanac [options]



Prints a brief help message and exits.


Prints the manual page and exits.


Start date, in YYYY-DD-MM format, current date by default.


Number of days to process, 30 by default


Time zone name, e.g.: EST, UTC, Europe/Berlin etc. or offset from Greenwich in format +HHMM / -HHMM, like +0300.

    --timezone=CET # Central European Time
    --timezone=EST # Eastern Standard Time
    --timezone=UTC # Universal Coordinated Time
    --timezone=GMT # Greenwich Mean Time, same as the UTC
    --timezone=+0300 # UTC + 3h (eastward from Greenwich)

By default, local timezone by default.

Please, note: Windows platform does not recognize some time zone names, MSK for instance. In such cases use offset from Greenwich format, as described above.


The observer's location. Contains 2 elements, space separated.

  • latitude in DD(N|S)MM format, N for North, S for South.

  • longitude in DDD(W|E)MM format, W for West, E for East.

E.g.: --place=51N28 0W0 for Greenwich, UK (the default).

Decimal numbers are also supported. In that case

  • The latitude always goes first

  • Negative numbers represent South latitude and East longitudes.

--place=55.75 -37.58 for Moscow, Russian Federation. --place=40.73 73.935 for New-York, NY, USA.


Calculate rise, set and transit times of Sun, Moon and the planets for given range of days


    perl ./script/rst_almanac.pl --place=56N26 37E09 --days=7
    perl ./script/rst_almanac.pl --place=56N26 37E09 --start=2021-01-01 --days=365