The data used to calculate Sun tokens comes from the sun data source and calculation options script property, while the diary grid property sun and moon display options specify how this data is displayed (if you need more control over the formatting of the time at which the moon rises, transits and sets, you can use planetary tokens, where the Sun and the Moon are treated as planets, and which offer a wide range of formatting options).
token |
description |
|||||||||||||||
[da] |
Dawn |
The time of dawn (the moment of first light, before sunrise). Depends on the setting used for the depression angle. |
||||||||||||||
[SR] |
Sunrise |
|||||||||||||||
[SS] |
Sunset |
|||||||||||||||
[du] |
Dusk |
The time of dusk (the moment of last light, after sunset). Depends on the setting used for the depression angle. |
||||||||||||||
[Srs] |
Hours of Daylight |
The time from sunrise to sunset. |
||||||||||||||
[DL] |
Hours of Daylight 2 |
The time from dawn to dusk. |
||||||||||||||
[TW] |
Hours of Twilight |
The time from dawn to sunrise, plus the time from sunset to dusk. |
||||||||||||||
[sab] |
Sun always above/below horizon |
Some text or symbol, as specified in the the all day above/below horizon control of the daylight tab of the moon and sun options, if the date of the token corresponds to a date when the Sun is always above the horizon (ie. does not set) or always below the horizon (ie. does not rise). |
||||||||||||||
[su] |
There are 2 tokens to display Summer Time changes or status are:
Depending on the value of the setting display label and symbol everyday, the above tokens are either displayed only on dates when when the status of summer time changes, or on every date. |
|||||||||||||||
[se] |
The seasons tokens are:
Use the uppercase version of the first 3 tokens above, if you want to show this token on every day (not only on dates when seasons change). In all cases, on days when there is a change of season, it is the new season which is shown. |
|||||||||||||||
[so] |
The solstices and equinoxes tokens are:
These tokens are all converted to a blank on days when no solstice or equinox occurs. |
|||||||||||||||
[sz] |
Sun in Zodiac |
The Sun in Zodiac tokens are:
|
Multiple sources
If more than one source is selected in the the sun data source, you can specify which source to use by appending a digit that corresponds to that source's position in the list of selected sources. For example, in a script with 2 Sun data sources, Oslo and Stockholm, you would use the token [SR1] to display sunrise in Oslo, and the token [SR2] to display sunrise in Stockholm.
Time formatting
The diary grid property sun data display options specify how times are formatted, for any of the above tokens that represent a time.
Advanced time and angle formatting
If you need even more control over the formatting of the times generated above, you can use planetary tokens, where the Sun and the Moon are treated as planets, and which offer a wide range of formatting options.
Hours and minutes
Note that, if there are multiple sources, then the h and m suffixes are placed between the token and the number of the source. For example, to display the hours part of the sunrise of the 2nd Sun data source, you would use the [SRh2].
Sun and planets
To display information that relates to the Sun and any of the other planets (including the Earth), see planetary tokens.
Examples
Seasons
Solstices
Zodiac
See also: other astronomical tokens.
Topic 174730, last updated on 05-Oct-2023