3.1.3 Actual date modifier
It is allowed to use that date —instead of the actual system date— which
is defined by the %date command line argument. This means,
fixed dates can be checked for any year and are respected in the
same way, as if they would be fixed dates of the actual year.
The date must be denoted in one of these formats:
-
yyyy[mm[dd|wwwn]]
-
yyyy*d|wn[www]
-
yyyy@e|t|dvar[[+|-]n[www]]
-
month name[dd]
-
weekday name[n]
- dd
Some examples to this:
Please note:
The following examples assumes the actual system date is
Wednesday, the 17th February 1993 (19930217), weeks
start on Mondays and ISO week numbers are used!
- The
yyyy[mm[dd|wwwn]] format:
-
- ‘gcal %1994’ (≡ yyyy)
The actual date is set to the date 17th February 1994
⇒ 19940217.
- ‘gcal %1994Mar’
- ‘gcal %19943’
- ‘gcal %199403’ (≡ yyyymm)
The actual date is set to the date 17th March 1994
⇒ 19940317.
- ‘gcal %1994Mar3’
- ‘gcal %1994033’
- ‘gcal %19940303’ (≡ yyyymmdd)
The actual date is set to the date 3rd March 1994
⇒ 19940303.
- ‘gcal %1994MarWed3’
- ‘gcal %199403wed3’ (≡ yyyymmwwwn)
The actual date is set to the date 3rd Wednesday in March 1994
(n ≡ ‘1…5|9’) ⇒ 19940316.
- ‘gcal %0’
- ‘gcal %00’
- ‘gcal %000’
- ‘gcal %0000’ (≡ yyyy)
The actual date remains unchanged ⇒ 19930217.
- ‘gcal %0000Mar’
- ‘gcal %00003’
- ‘gcal %000003’ (≡ yyyymm)
The actual date is set to the date 17th March 1993
⇒ 19930317.
- ‘gcal %0000Mar3’
- ‘gcal %0000033’
- ‘gcal %00000303’ (≡ yyyymmdd)
The actual date is set to the date 3rd March 1993
⇒ 19930303.
- ‘gcal %0000MarWed3’
- ‘gcal %000003wed3’ (≡ yyyymmwwwn)
The actual date is set to the date 3rd Wednesday in March 1993
(n ≡ ‘1…5|9’) ⇒ 19930317.
- The
yyyy*d|wn[www] format:
-
- ‘gcal %1994*d10’ (≡
yyyy*dn)
The actual date is set to the date 10th absolute day in 1994
(n ≡ ‘1…365|366|999’)
⇒ 19940110.
- ‘gcal %1994*d10sun’ (≡
yyyy*dnwww)
The actual date is set to the date 10th Sunday in 1994
(n ≡ ‘1…51|52|53|99’)
⇒ 19940306.
- ‘gcal %0*d10’ (≡
yyyy*dn)
The actual date is set to the date 10th absolute day in 1993
⇒ 19930110.
- ‘gcal %0*d10sun’ (≡
yyyy*dnwww)
The actual date is set to the date 10th Sunday in 1993
⇒ 19930307.
- ‘gcal %1994*w10’ (≡
yyyy*wn)
The actual date is set to the date Monday of the 10th week in 1994
(n ≡ ‘0|1…52|53|99’)
⇒ 19940307.
- ‘gcal %1994*w10sun’ (≡
yyyy*wnwww)
The actual date is set to the date Sunday of the 10th week in 1994
⇒ 19940313.
- ‘gcal %0*w10’ (≡
yyyy*wn)
The actual date is set to the date Monday of the 10th week in 1993
⇒ 19930308.
- ‘gcal %0*w10sun’ (≡
yyyy*wnwww)
The actual date is set to the date Sunday of the 10th week in 1993
⇒ 19930314.
- The
yyyy@e|t|dvar[[+|-]n[www]] format:
-
- ‘gcal %1994@e’ (≡
yyyy@e)
The actual date is set to the date Easter Sunday 1994
⇒ 19940403.
- ‘gcal %1994@e10’
- ‘gcal %1994@e+10’ (≡
yyyy@e[+]n)
The actual date is set to the date 10 days after Easter Sunday 1994
⇒ 19940413.
- ‘gcal %1994@e-10’ (≡
yyyy@e-n)
The actual date is set to the date 10 days before Easter Sunday 1994
⇒ 19940324.
- ‘gcal %0@e’
- ‘gcal %00@e’
- ‘gcal %000@e’
- ‘gcal %0000@e’ (≡
yyyy@e)
The actual date is set to the date Easter Sunday 1993
⇒ 19930411.
- ‘gcal %0@e10’
- ‘gcal %0@e+10’ (≡
yyyy@e[|]n)
The actual date is set to the date 10 days after Easter Sunday 1993
⇒ 19930421.
- ‘gcal %0@e-10’ (≡
yyyy@e-n)
The actual date is set to the date 10 days before Easter Sunday 1993
⇒ 19930401.
- ‘gcal %1994@e3Wed’
- ‘gcal %1994@e+3Wed’ (≡
yyyy@e[+]nwww)
The actual date is set to the date 3rd Wednesday after Easter Sunday 1994
⇒ 19940420.
- ‘gcal %1994@e-3wed’ (≡
yyyy@e-nwww)
The actual date is set to the date 3rd Wednesday before Easter Sunday 1994
⇒ 19940316.
- ‘gcal %0@e3wed’
- ‘gcal %0@e+3wed’ (≡
yyyy@e[+]nwww)
The actual date is set to the date 3rd Wednesday after Easter Sunday 1993
⇒ 19930428.
- ‘gcal %0@e-3we’ (≡
yyyy@e-nwww)
The actual date is set to the date 3rd Wednesday before Easter Sunday 1993
⇒ 19930324.
- ‘gcal %1994@t’ (≡
yyyy@t)
The actual date is set to today’s date in 1994
⇒ 199400217.
- ‘gcal %1994@t10’
- ‘gcal %1994@t+10’ (≡
yyyy@t[+]n)
The actual date is set to the date 10 days after today’s date in 1994
⇒ 19940227.
- ‘gcal %1994@t-10’ (≡
yyyy@e-n)
The actual date is set to the date 10 days before today’s date in 1994
⇒ 19940207.
- ‘gcal %0@t’
- ‘gcal %00@t’
- ‘gcal %000@t’
- ‘gcal %0000@t’ (≡
yyyy@t)
The actual date is set to today’s date
⇒ 19930217.
- ‘gcal %0@t10’
- ‘gcal %0@t+10’ (≡
yyyy@t[|]n)
The actual date is set to the date 10 days after today’s date
⇒ 19930227.
- ‘gcal %0@t-10’ (≡
yyyy@t-n)
The actual date is set to the date 10 days before today’s date
⇒ 19930207.
- ‘gcal %1994@t3Wed’
- ‘gcal %1994@t+3Wed’ (≡
yyyy@t[+]nwww)
The actual date is set to the date 3rd Wednesday after today’s date in 1994
⇒ 19940309.
- ‘gcal %1994@t-3wed’ (≡
yyyy@t-nwww)
The actual date is set to the date 3rd Wednesday before today’s date in 1994
⇒ 19940302.
- ‘gcal %0@t3wed’
- ‘gcal %0@t+3wed’ (≡
yyyy@t[+]nwww)
The actual date is set to the date 3rd Wednesday after today’s date
⇒ 19930310.
- ‘gcal %0@t-3we’ (≡
yyyy@t-nwww)
The actual date is set to the date 3rd Wednesday before today’s date
⇒ 19930127.
- ‘gcal -v a=0303 %1994@a’ (≡
yyyy@dvar)
The actual date is set to the date 3rd March 1994
⇒ 19940303.
- ‘gcal -v a=0303 %1994@a10’
- ‘gcal -v a=0303 %1994@a+10’ (≡
yyyy@dvar[+]n)
The actual date is set to the date 10 days after 3rd March 1994
⇒ 19940313.
- ‘gcal -v a=0303 %1994@a-10’ (≡
yyyy@dvar-n)
The actual date is set to the date 10 days before 3rd March 1994
⇒ 19940221.
- ‘gcal -v a=0303 %0@a’ (≡
yyyy@dvar)
The actual date is set to the date 3rd March 1993
⇒ 19930303.
- ‘gcal -v a=0303 %0@a10’
- ‘gcal -v a=0303 %0@a+10’ (≡
yyyy@dvar[+]n)
The actual date is set to the date 10 days after 3rd March 1993
⇒ 19930313.
- ‘gcal -v a=0303 %0@a-10’ (≡
yyyy@dvar-n)
The actual date is set to the date 10 days before 3rd March 1993
⇒ 19930221.
- ‘gcal -v a=0303 %1994@a3wed’
- ‘gcal -v a=0303 %1994@a+3wed’ (≡
yyyy@dvar[+]nwww)
The actual date is set to the date 3rd Wednesday after 3rd March 1994
⇒ 19940323.
- ‘gcal -v a=0303 %1994@a-3wed’ (≡
yyyy@dvar-nwww)
The actual date is set to the date 3rd Wednesday before 3rd March 1994
⇒ 19940216.
- ‘gcal -v a=0303 %0@a3wed’
- ‘gcal -v a=0303 %0@a+3wed’ (≡
yyyy@dvar[+]nwww)
The actual date is set to the date 3rd Wednesday after 3rd March 1993
⇒ 19930324.
- ‘gcal -v a=0303 %0@a-3wed’ (≡
yyyy@dvar-nwww)
The actual date is set to the date 3rd Wednesday before 3rd March 1993
⇒ 19930210.
- The
month name[dd] format:
-
- ‘gcal %April’ (≡ month name)
The actual date is set to the date 17th April 1993
⇒ 19930417.
- ‘gcal %april3’
- ‘gcal %april03’ (≡ month name dd)
The actual date is set to the date 3rd April 1993
⇒ 19930403.
- The
weekday name[n] format:
-
- ‘gcal %Friday’ (≡ weekday name)
The actual date is set to the date Friday of current week in February 1993
⇒ 19930219.
- ‘gcal %Friday2’
- ‘gcal %Friday02’ (≡ weekday name n)
The actual date is set to the date 2nd Friday in February 1993
(n ≡ ‘1…5|9’) ⇒ 19930212.
- The dd format:
-
- ‘gcal %3’
- ‘gcal %03’ (≡ dd)
The actual date is set to the date 3rd February 1993
⇒ 19930203.