The data used to calculateSun tokenscomes from thesun data source and calculation optionsscript property, while the diary grid propertysun and moon display optionsspecify how this data is displayed.
token |
description |
|||||||||||||||
[da] |
Dawn |
Displays the time of dawn, sunrise, sunset, and dusk.
•By default, the times of sunrise and sunset are calculated when the upper limb of the Sun touches the horizon. This is the accepted standard, but you can specify that asun data sourcebe calculatedusing a different convention. •The time of dawn (the moment of first light, before sunrise) and dusk (the moment of last light, after sunset) depend on the setting used for thedepression angle.
Advanced time and angle formatting
If you need more control over the formatting of thetime at which the Sun rises, transits and sets, you can useplanetary tokens, where the Sun and the Moon are treated as planets, and which offer a wide range offormatting options. |
||||||||||||||
[SR] |
Sunrise |
|||||||||||||||
[SS] |
Sunset |
|||||||||||||||
[du] |
Dusk |
|||||||||||||||
[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,plusthe time from sunset to dusk. |
||||||||||||||
[sab] |
Sun always above/below horizon |
Some text or symbol, as specified in the theall day above/below horizon controlof thedaylight 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 settingdisplay 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 thenewseason which is shown.
Reference time
By default,Seasonstokens are calculated based on the phase angle calculated at the end of the day (23:59:59.9999), which is the standard. To have the token based on the phase angle calculated at a different time of the day, use acalculation time suffix. |
|||||||||||||||
[so] |
The solstices and equinoxes tokens are:
These tokens are all converted to a blank on days when no solstice or equinox occurs.
Reference time
By default,Solstices and Equinoxestokens are calculated based on the phase angle calculated at the end of the day (23:59:59.9999), which is the standard. To have the token based on the phase angle calculated at a different time of the day, use acalculation time suffix. |
|||||||||||||||
[sz] |
Sun in Zodiac |
The Sun in Zodiac tokens are:
Reference time
By default,Sun in Zodiactokens are calculated based on the phase angle calculated at the end of the day (23:59:59.9999), which is the standard. To have the token based on the phase angle calculated at a different time of the day, use acalculation time suffix. |
Multiple sources
If more than one source is selected in the thesun 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
Thediary grid propertysun data display optionsspecifyhow 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 useplanetary tokens, where the Sun and the Moon are treated as planets, and which offer a wide range offormatting options.
Hours and minutes
The suffixeshandmcan be added, to any of the above Sun tokens that represent a time, to only display the hours or minute part of that time, or to display the hours and minutes using different formatting as shown on the right
Note that, if there are multiple sources, then thehandmsuffixes 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 Sunandany of the other planets (including the Earth), seeplanetary tokens.
Examples
Seasons
![]() |
![]() |
Solstices
![]() |
![]() |
Zodiac
![]() |
![]() |
See also:solar macro functions,astrological macro functions,astronomical macro functions,other astronomical tokens,exporting astronomical dataandastronomical tokens calculation times.