Main
Latest
About
Photos
WebCam
Words
Graphics
RISC OS
AMPlay
SpriteUtils
Recurse
BitField
Diary
Macros
Options
Scripts
History
Fan
Icons
Music
Links
Credits
Site Map
Diary
Macros
RISC OS applications have a built in standard for referring to date and time information. This is detailed in the RISC OS 3 (and presumably later) manual, as part of the documentation for the Alarm application. Organizer also supports this format, as may other RISC OS applications.
Diary currently supports some of it, but not all, as we'll see below. It also has a few additions of its own, some for convenience, and some for necessity as it needs to encode information other than the date.
First, the list of RISC OS macros:
| Name | Meaning | Typical value | Supported by Diary? |
|---|---|---|---|
%se | seconds | 59 | N |
%mi | minutes | 05 | Y 1 |
%12 | hours in 12 hour format | 07 | Y 1 |
%24 | hours in 24 hour format | 23 | Y 1 |
%amor %pm | 'AM' or 'PM' | PM | Y 1 |
%we | weekday in full | Sunday | Y |
%w3 | weekday in three characters | Sun | Y |
%wn | weekday as a number | 7 | Y |
%dy | day of the month | 26 | Y |
%st | appropriate suffix | th | Y 2 |
%mo | month name in full | March | Y |
%m3 | month name in three characters | Mar | Y |
%mn | month as a number | 3 | Y |
%ce | century as two digits | 20 | Y |
%yr | year within century | 00 | Y |
%wk | week within year | 12 | Y 3 |
%dn | day within year | 86 | Y |
%tz | timezone | GMT | N |
%0 | insert a null character | - | N |
%% | insert a percentage sign | % | Y 4 |
1: Time macros always return the current time, are only useful in certain circumstances - creating a new entry, setting a last modified date etc. Don't use them in loops - it doesn't work.
2: This returns the suffix appropriate to the most recently used numeric value.
3: Week 1 is taken as the week which commences with the first Monday in January.
4: Also, '%' on its own will insert a '%' as long as it doesn't form part of a recognised macro.
In addition to the above named macros, RISC OS also includes support for a modifier prefix, 'z'. This has the effect of removing any leading zero(es) from a numeric value. It only affects the macro which contains it.
As an example;
%we the %dy%st of %momight be
Monday the 06th of March
whereas, with the 'z' modifier;
%we the %zdy%st of %mowould be
Monday the 6th of March
Still with me?
In Diary, the 'z' modifier can be applied to most numeric values - day of year, week of year, hour etc, but not year, century etc.
Additional macros that Diary uses;
| Name | Meaning | Typical value |
|---|---|---|
%cn | century as four digits | 2000 1 |
%ye | year as four digits | 2000 1 |
%ec | name of current diary entry | varies |
%en | name of next diary entry | varies |
%ep | name of previous diary entry | varies |
%ef | name of first diary entry in current month | varies |
%el | name of last diary entry in current month | varies |
%ve | !Diary's version string | 0.06 1.5.2000 |
1: These macros have been added to make it simpler to refer to four digit years. Currently the century and year are identical, but next year the year will change while the century will not.
The '%e?' macros return the name of the relevant entry - whether it gives names or numbers, and whether it has leading zeroes or not will depend on the journal naming options in the options file.
Additional modifiers that Diary supports;
The additional modifiers are 'u' and 'l'. These have the effect of forcing the output to entirely UPPER or lower case as appropriate. The default for all the text output is Leading Capitals, except for the suffix, which is lower case unless you use the 'u' modifier.
The macros themselves are not case-sensitve - %we and %WE are equivalent.
 Diary.
|
 Top.
|
