Moon Phases Display Options

Navigation:  ScriptLine Properties > Moon and Sun Options >

Moon Phases Display Options

Previous pageReturn to chapter overviewNext page

The general appearance of moon phases in your output files is controled by Font for [mp] and by the symbols and text you set in Moon Phases tokens [mp] and [mt], and the Font for [mp]. Note that in addition to the 4 well-known phases of the moon, you can also specify symbols and text to appear on 1/8th phases (also called waxing and waning crescent and gibbous).


The Moon Phases Options option tells Q++Studio if the appropriate moon phase symbol should be displayed on a date when a moon phase occurs.


Usually this is set to true for single days, but often set to false for duration tokens, where you may want to list the dates of the moon phases, along with the moon text [mt]. To do this you would use an [mp:m+00] token, set the Display [mp] Symbol to false for duration tokens, separate the moon phases with a soft return, and put the following text to the left : "[mt]&n[mt]".


You can, within the same grid, use different moon options, depending on the type of moon phase token. Single Days moon phases tokens are of the form [mp] or [mt] and are replaced by the moon phase symbol corresponding to that date. Duration Tokens moon phases are of the form [mp:m+00] and concatenate all moon phases that occur in a given period.


Since you cannot have multiple moon phases on the same day, the option Separate Multiple Moon Phases with applies only to duration tokens. You can use a tabulation, a soft return or a string (max. 5 characters) which can contain Special Characters Tokens.


You can surround each appearance of a moon phase symbol to the left and right, using the Surround Symbol option. You can surround the moon phases symbols with any text and/or tokens, and decide if this surrounding should occur for single days and/or duration tokens. Usually, for single days, the surrounding text or tokens can be set directly in the GridTemplate and so this option is false for single days. However it is almost always true for duration tokens, provided the GridTemplate contains a duration token.


You can also use the Display 1/8 Phases option to specify if 1/8th phases are displayed for either single days or durations.


Finally, you can specify how the time of Moon Phase Time [mpt] should be displayed :



The format in which to display the times obtained. A few pre-formatted selections are available, and you can create your own. This formatting is described in the topic Time Formatting. You should generally avoid using any formatting string that contains characters that refer to Windows global variables, since these can change on each workstation.

Round to Nearest Minute


Use this option to round off times to the nearest minute. For example, suppose we had the 2 following times : 07:33:13 and 17:24:43. With this option turned OFF, these times would be displayed as 07:33 and 17:24. However, if this option is turned ON, then these 2 times would be displayed as 07:33 and 17:24 (note how the 17:24 was rounded up to 17:25).


This setting lets you specify that minutes should be displayed with different attributes than the original token (hence than the hours). Usually this setting is used to display the minutes in a smaller size font than the hours.

If no time, display

There are days when no moonrise, moonset or moon phase occurs. This option allows you to specify what text to use to represent these non-times (for example --:--).


Sample output showing the effect of the format selected above on a time before noon and a time after noon.

Display times

for 1/8 phases

Use this option to specify if the token [mpt] should display a time, or the no-time text, on days when eighths of a phase occur.

Lunar Days (Tithis)

Use these settings to change the way Lunar Day Tokens are displayed, in particular when a given solar day contains 2 lunar days.


Note that you can set a set of default moon options in the Preferences. These settings will then be used for every new Script that you create. Of course these settings can later be modified in each script depending of each script's requirements.

Topic 174783 updated on 03-May-2018.
Topic URL: