Date Offset Suffixes are used to specify that a token is to be evaluated for a certain number of days or months or years* before or after the date indicated by its DayValue.
These suffixes are particularly useful in the text and tokens to display on each generated line field of GenTokens Options, where the DayValue is dynamic.
The 3 types of date offset suffixes are:
:-Xd :+Xd |
Evaluate the token X days before/after its date. |
:-Xm :+Xm |
Evaluate the token X months before/after its date. |
:-Xy :+Xy |
Evaluate the token X years before/after its date. |
The structure of these suffixes is as follows:
•the suffix is added at the end of any token
•it begins with a colon:
•followed by a plus or minus
•followed by the number of days or months to offset
•followed bydormorydepending if the offset is counted in days or months or years*.
Some examples:
[1d:-1m] |
Evaluate the token [1d] one month before the date determined by DayValue 1. |
[1SR:-7d] |
Show the Sunrise of one week before (note how we use 7 days rather than 1 week)* |
[#fa:+1d] |
The a-Holidays of tomorrow (used inside GenTokens Options) |
[1yyyy:+3y] |
3 years after the year of day 1 |
*IMPORTANT: Date Offset Suffixes can only be specified as a number of days or months or years (such as :+5d or :-1m or :+2y). Using the same notation, but as a number of weeks (such as :-2w or :+3w) is interpreted as a mini-calendar current week offset modifier. To have a number of weeks as offset, use 7 times that number in days (for example use :+21d instead of :+3w).
See also: mini-calendar starting date offset modifier, mini-calendar current week offset modifier, mini-calendar year offset modifier, mini-calendar offset from script year modifier.
Topic 179755, last updated on 27-Oct-2026