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

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 asWingdings, which represents the current status of Summer Time (ie.onoroff).

[sul]

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

 

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]

Seasons

The seasons tokens are:

 

[se]

[SE]

Season Symbol: displays a character, usually from a decorative font such asWingdings, 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 anhor anmto 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 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]

Solstice and Equinoxes

The solstices and equinoxes tokens are:

 

[so]

Solstice/Equinox Symbol: displays a character, usually from a decorative font such asWingdings, 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 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:

 

[sz]

Sun Zodiac Symbol: displays a character, usually from a decorative font such asWingdings, 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 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.