Sun Tokens

Navigation:  Tokens > Astronomical Tokens >

Sun Tokens

Previous pageReturn to chapter overviewNext page

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

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]

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.

[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.

[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.

 

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.

 

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.


Topic 174730 updated on 24-Jan-2019.
Topic URL: https://www.qppstudio.net/webhelp_xv4/index.html?suntokens.htm