Actual date modifier

It is allowed to use that date -- instead of the actual system date -- which is defined by the `%date' option. 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)!

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 ISO-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 ISO-week in 1994 => 19940313.
• `gcal %0*w10' (== yyyy*wn)
  The actual date is set to the date Monday of the 10th ISO-week in 1993 => 19930308.
• `gcal %0*w10sun' (== yyyy*wnwww)
  The actual date is set to the date Sunday of the 10th ISO-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.

Go to the first, previous, next, last section, table of contents.