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


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


  riseset [options]



Prints a brief help message and exits.


Prints the manual page and exits.


Calendar date in format YYYY-MM-DD, e.g.:


Current date in default local time zone If omitted.


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.

--twilight: type of twilight:
  • civil

  • nautical (default)

  • astronomical

--theme: color theme:
  • dark (default): for dark consoles

  • light: for light consoles

  • colorless: without colors, for terminals that do not support ANSI color codes

--no-colors: do not use colors, same as --theme=colorless


Calculate rise, set and transit times of Sun, Moon and the planets. The program also calculates twilight, nautical by default. To calculate civil or astronomical twilight, use --twilight option.

All times are given in the same time zone which was provided by --time option, or the default system time zone.

There are some conditions when an event can not be calculated. For instance, when celestial body is circumpolar or never rises. In such cases there is a dash () instead of time.


    perl ./script/riseset.pl --place=56N26 37E09 --twilight=civil
    perl ./script/riseset.pl --place=56N26 37E09 --date=1968-02-11 --timezone=UTC