Next: , Previous: Replacements with other argument, Up: Replacements with other argument


G.2.2.1 Actual clocktime %[format]?[argument] special texts

Gcal is able to represent the actual clocktime as local/zone time and as Universal time (UTC/GMT), and additionally the RFC-8221 style numerical Universal time timezone offset value and the actual numerical local time timezone offset value. See Actual local time %t[argument] special text, for the detailed description of all components of the argument, which may trail the actual clocktime %[format]?[argument] special texts. All actual clocktime %[format]?[argument] special texts must always be trailed by a whitespace character which is removed in output! The following actual clocktime %[format]?[argument] special texts are respected:

%t[argument]
%t[*][[+|-]mmmm|hh:[mm]] references the actual local time, which is displayed by using the hh:mm output format, e.g.:
The text ‘Local time: %t  --> Dentist at 10:00 will be expanded to
==> ‘Local time: 07:32 --> Dentist at 10:00, in case the actual local time value is 07:32 o'clock (hh:mm).

If only %t is specified, the local time value will implicitly be displayed by using the 24-hours format. For displaying using the 12-hours format, add a ‘*’ character directly behind %t, e.g. ‘%t*’.

A displacement value may trail the %t special text, which has to be specified either by using the [+|-]mmmm format or the [+|-]hh:[mm] format. [+|-]mmmm adds respectively subtracts the specified amount of minutes mmmm from the local time value (range 0...9999), while [+|-]hh:[mm] adds respectively subtracts the given amount of hours hh (range 0...99) and minutes mm (range 0...59) from the local time value. The displacement value is always added to the local time value in case it is specified without a +|- sign. In case Gcal is unable to compute the actual local time in hh:mm format by reason of a misspecified argument, a ??:?? text will be created instead of the actual local time in hh:mm format.

The text ‘Local time: %t-3:  --> Dentist at 10:00 will be expanded to
==> ‘Local time: 04:32 --> Dentist at 10:00, in case the actual local time value is 07:32 o'clock (hh:mm).

%[format]'[argument]
%[format]'[[+|-]mmmm|hh:[mm]] references the actual local time in minutes since midnight, which is displayed by using the m[m...] output format, e.g.:
The text ‘Local time: %'  --> Dentist at 10:00 will be expanded to
==> ‘Local time: 452 --> Dentist at 10:00, in case the actual local time value is 07:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual local time in m[m...] format by reason of a misspecified argument, a ?? text will be created instead of the actual local time in m[m...] format.

%[format]_[argument]
%[format]_[*][[+|-]mmmm|hh:[mm]] references the actual local time hour, which is displayed by using the h[h...] output format, e.g.:
The text ‘Local time hour: %_-1: will be expanded to
==> ‘Local time hour: 6 in case the actual local time value is 07:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual local time hour by reason of a misspecified argument, a ?? text will be created instead of the actual local time hour h[h...].

%[format]?[argument]
%[format]?[[+|-]mmmm|hh:[mm]] references the actual local time minute, which is displayed by using the m[m...] output format, e.g.:
The text ‘Local time minute: %>04*?+:2 will be expanded to
==> ‘Local time minute: 0034 in case the actual local time value is 07:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual local time minute by reason of a misspecified argument, a ?? text will be created instead of the actual local time minute m[m...].

%[format]{[argument]
%[format]{[[+|-]mmmm|hh:[mm]] references the actual local time 12-hour format suffix, which is displayed as am|pm, e.g.:
The text ‘Local time suffix: %{ will be expanded to
==> ‘Local time suffix: am in case the actual local time value is 07:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual local time 12-hour format suffix by reason of a misspecified argument, a ?? text will be created instead of the actual local time 12-hour format suffix am|pm.

%@[argument]
%@[*][[+|-]mmmm|hh:[mm]] references the actual Universal time (UTC/GMT), which is displayed by using the hh:mm/date output format, e.g.:
The text ‘Universal time: %@*-3. will be expanded to
==> ‘Universal time: 03:32am/15-Feb-1999, in case the actual date is the 15th February 1999 and the actual Universal time value is 06:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual Universal time in hh:mm/date format by reason of a misspecified argument, a ??:??/??-???-???? text will be created instead of the actual Universal time in hh:mm/date format.

%[format]`[argument]
%[format]`[[+|-]mmmm|hh:[mm]] references the actual Universal time in minutes since midnight, which is displayed by using the m[m...]/date output format, e.g.:
The text ‘Universal time: %>06*`-3: will be expanded to
==> ‘Universal time: 000212/15-Feb-1999 in case the actual date is the 15th February 1999 and the actual Universal time value is 06:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual Universal time in m[m...]/date format by reason of a misspecified argument, a ??/??-???-???? text will be created instead of the actual Universal time in m[m...]/date format.

%[format].[argument]
%[format].[*][[+|-]mmmm|hh:[mm]] references the actual Universal time hour, which is displayed by using the h[h...] output format, e.g.:
The text ‘Universal time hour: %.-1: will be expanded to
==> ‘Universal time hour: 5 in case the actual Universal time value is 06:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual Universal time hour by reason of a misspecified argument, a ?? text will be created instead of the actual Universal time hour h[h...].

%[format]/[argument]
%[format]/[[+|-]mmmm|hh:[mm]] references the actual Universal time minute, which is displayed by using the m[m...] output format, e.g.:
The text ‘Universal time minute: %>04*/+:2 will be expanded to
==> ‘Universal time minute: 0034 in case the actual Universal time value is 06:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual Universal time minute by reason of a misspecified argument, a ?? text will be created instead of the actual Universal time minute m[m...].

%[format]}[argument]
%[format]}[[+|-]mmmm|hh:[mm]] references the actual Universal time 12-hour format suffix, which is displayed as am|pm, e.g.:
The text ‘Universal time suffix: %>1w*}+10: will be expanded to
==> ‘Universal time suffix: Pm in case the actual Universal time value is 06:32 o'clock (hh:mm).

In case Gcal is unable to compute the actual Universal time 12-hour format suffix by reason of a misspecified argument, a ?? text will be created instead of the actual Universal time 12-hour format suffix am|pm.

%"[argument]
%"[[+|-]mmmm|hh:[mm]] references the RFC-822 style numerical Universal time timezone offset value, which is displayed by using the +|-hhmm output format, e.g.:
The text ‘Universal time timezone offset value: %"-90 will be expanded to
==> ‘Universal time timezone offset value: -0130, at which calculations are always based on the timezone of the Universal time UTC/GMT.

In case Gcal is unable to compute the numerical Universal time timezone offset value by reason of a misspecified argument, a +???? text will be created instead of the numerical Universal time timezone offset value +|-hhmm.

%=[argument]
%=[[+|-]mmmm|hh:[mm]] references the RFC-822 style actual numerical local time timezone offset value, which is displayed by using the +|-hhmm output format, e.g.:
The text ‘Local time timezone offset value CET: %=-10 will be expanded to
==> ‘Local time timezone offset value CET: +0050, in case the actual timezone is equal the Central European (winter)time CEWT/CET (+hhmm). Calculations are always based on the timezone of the local time.

In case Gcal is unable to compute the actual numerical local time timezone offset value by reason of a misspecified argument, a +???? text will be created instead of the actual numerical local time timezone offset value +|-hhmm.


Footnotes

[1] RFC is the abbreviation of Request for Comments.