PlanetsNearOn

Navigation:  Appendices > Macro Language > Built-in Functions > All Functions (Alphabetical) >

PlanetsNearOn

Previous pageReturn to chapter overviewNext page

int = PlanetsNearOn(nDate, nSunDataSourceIndex, nPlanet1, nPlanet2)

 

This macro function returns a value of -1 if the planets nPlanet1 and nPlanet2 are not near each other on nDate (nearness is defined as the 2 planets having the same Right Ascension). If the 2 planets are near each other on that date, then this function returns the time of the day, as a fraction from 0 (the beginning of the day to 1000000 (at midnight at the end of the day). As there are about 85000 seconds in a day, the division of the day into 1 million results in a precision of about 1/10th of a second.

 

The planets are specified using a numerical index, as found in the table below :

 

Index

Name

0

Sun

1

Moon

2

Mercury

3

Venus

4

Mars

Index

Name

5

Jupiter

6

Saturn

7

Uranus

8

Neptune

9

Pluto

 

 

You will get an error message in the following cases:

 

nPlanet1 = nPlanet2

 

Either of the planets is the Sun, as nearness with respect to the Sun is not defined.

 

Either of the planets indices is less than 0 or more than 9.

 

Note that the result of this function are affected by the Sun data source you have selected for the current script.


Topic 177565 updated on 11-Jun-2005.
Topic URL: http://www.qppstudio.net/webhelp/index.html?planetsnearon.htm