Usually, the @ dates markers, $$ weekdays markers and w# week numbers markers of a mini-calendar are converted and formatted using various point-and-click mini-calendar options.
➢If you only need the color of each date to depend on that date, using the :*XX modifier might be overkill and cause most other mini-calendar Options to be ignored. Instead, use a dynamic color in the current month dates formatting options of mini-calendar options. Use :*XX when the macro must control the actual conversion of the @ marker.
To use macros to override the conversion and formatting of the dates, weekdays and week numbers of a mini-calendar, use the modifiers list further down.
Important Remarks
When you use any of these modifiers, most mini-calendar formatting options are ignored for that particular marker (except for the outside days exception mentioned in the section on @ date markers, above), giving you total control over the way each mini-calendar marker is displayed, but also requiring your macro to handle all details.
Also, these tokens are treated as normal tokens inside a mini-calendar which means that by default their DayValue 1 is the 1st day of the month. To start on the weekstart of the 1st of the month, make sure to use the weekstart modifier.
List of Markers
marker |
modifier |
|
@ |
:*XX |
To use a macro to modify the processing of the @ markers of a mini-calendar, simply add a mini-calendar modifier of the form
:*XX
where XX represents any number from 1-30, in analogy with macro tokens.
Token Used for Conversion
The token supplied to the macro as the value of the system variable s_TokenRoot is [d]
If you want to display a 2-digit date number, then you must add the :dd modifier to your mini-calendar token.
Outside Days
By default, the use of this @ marker modifier will hide all outside days.
If you wish to show outside days, then you should include a :ws weekstart mini-calendar modifier, :ws, and in that case the macro you use is responsible for the showing/hiding and formatting of any outside days; the outside days mini-calendar options are also ignored. |
$$ |
:$*XX |
To use a macro to modify the processing of the $$ weekday markers of a mini-calendar, simply add a mini-calendar modifier of the form
:$*XX
where XX represents any number from 1-30, in analogy with macro tokens.
Token Used for Conversion
The token supplied to the macro as the value of the system variable s_TokenRoot is [ddd] which means that to tweak the result of that token you must either do it in the macro code or using the Length of [ddd] grid option (and not the weekdays mini-calendar options). |
w# |
:w*XX |
To use a macro to modify the processing of the w# week number markers of a mini-calendar, simply add a mini-calendar modifier of the form
:w*XX
where XX represents any number from 1-30, in analogy with macro tokens.
Note that the use of the current week offset modifier is incompatible with the use of macros to modify the processing of the w# marker.
Token Used for Conversion
The token supplied to the macro as the value of the system variable s_TokenRoot is [w] which means that if you want to work with a variant, such as a 2-digit week number, then you must do so in the code of your macro.
Outside Days
By default, the use of this W# marker modifier will hide weeks beginning outside the month. If you wish to show these, then you should include a :ws weekstart mini-calendar modifier, :ws. |
Once again, note that when you use any of these modifiers, all mini-calendar formatting options are ignored for that particular marker (except for the outside days exception mentioned in the section on @ date markers, above), giving you total control over the way each mini-calendar marker is displayed, but also requiring your macro to handle all details, such as making holidays into a second color, etc...
See also: other mini-calendar modifiers, dynamic colors.
Topic 178560, last updated on 03-Sep-2026
