Please enable JavaScript to view this site.

 

Navigation: Tokens > Astronomical Tokens

Sun, Seasons and Zodiac Tokens

Scroll Prev Up Next More

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.

 

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 a sun data source be calculated using 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 the depression angle.

 

Advanced time and angle formatting

 

If you need more control over the formatting of the time at which the Sun 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.

[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, 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]

Summer Time

There are 2 tokens to display Summer Time changes or status are:

 

[su]

Summer Time Symbol: displays a character, usually from a decorative font such as Wingdings, which represents the current status of Summer Time (ie. on or off).

[sul]

Summer Time Label: displays a label to describe the current status of Summer Time.

 

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]

Seasons

The seasons tokens are:

 

[se]

[SE]

Season Symbol: displays a character, usually from a decorative font such as Wingdings, which represents the current season.

[sen]

[SEN]

Season Name: displays the name of the season that is beginning on the date of the token.

[se#]

[SE#]

Season Number: displays a number for each season (spring =1, summer = 2, fall = 3, winter =4).

[set]

Season Time: displays the time at which the Season started. You can add an h or an m to this token to only display the hours or minutes part of the time.

 

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.

 

Reference time

 

By default, Seasons tokens 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 a calculation time suffix.

[so]

Solstice and Equinoxes

The solstices and equinoxes tokens are:

 

[so]

Solstice/Equinox Symbol: displays a character, usually from a decorative font such as Wingdings, which represents the current solstice or equinox.

[son]

Solstice/Equinox Name: displays the name of the solstice or equinox that is beginning on the date of the token.

[sot]

Solstice/Equinox Time: displays the time at which the solstice or equinox occurred.

 

These tokens are all converted to a blank on days when no solstice or equinox occurs.

 

Reference time

 

By default, Solstices and Equinoxes tokens 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 a calculation time suffix.

[sz]

Sun in Zodiac

The Sun in Zodiac tokens are:

 

[sz]

Sun Zodiac Symbol: displays a character, usually from a decorative font such as Wingdings, which represents the current Zodiac sign, on the days when that sign changes.

[sZ]

Sun Zodiac Symbol (first and last day): similar to the [sz] token, above, but shows the current Zodiac sign on the first and last days of a cycle.

[SZ]

Sun Zodiac Symbol (everyday): similar to the [sz] token, above, but shows the current Zodiac sign on everyday.

[szn]

Sun Zodiac Name: displays the name of the Zodiac sign into which the Sun is entering.

[sZn]

Sun Zodiac Name (first and last day): similar to the [szn] token, above, but shows the current Zodiac name on the first and last days of a cycle.

[SZN]

Sun Zodiac Name (everyday): similar to the [szn] token, above, but shows the current Zodiac names on everyday.

[szt]

Sun Zodiac Time: displays the time at which the Sun enters a new Zodiac sign.

 

Reference time

 

By default, Sun in Zodiac tokens 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 a calculation time suffix.

 

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

 

The suffixes h and m can 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 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, exporting astronomical data and astronomical tokens calculation times.

 


Topic 174730, last updated on 11-Mar-2025