Next: , Previous: Year number, Up: Replacements with date argument


G.2.1.9 Moon phase %[format]?[date] special texts

Gcal uses a very simple algorithm for detecting the Moon phase, which computes approximate values only. The Moon phase is always calculated for 0 o'clock Universal time (UTC/GMT). See Calendar option --time-offset=argument, how to change the base time for which the astronomical functions are calculated. The following Moon phase %[format]?[date] special texts are respected:

%O[date]
Is replaced by the Moon phase text of the current day of year, e.g.:
The text ‘Moon phase %O , %n will be expanded to
==> ‘Moon phase 94%+, 22-Dec-1996, in case the actual system date is the 22nd December 1996.

The constructed Moon phase text consists of a percent value, which informs about the illuminated fraction of the Moon's disk, and a trailing sign that tells something about the state of the Moon. A trailing ‘+’ sign indicates a waxing Moon, a ‘-’ sign a waning Moon, a ‘@’ sign indicates the Full Moon phase, and a ‘!’ sign the New Moon phase.

%>03*O[date]
Is replaced by the 3-digit Moon phase text with leading zeroes of the current day of year, e.g.:
The text ‘Moon phase %>03*O0@t+1 , %n+1 will be expanded to
==> ‘Moon phase 098%+, 23-Dec-1996, in case the actual system date is the 22nd December 1996.

The constructed Moon phase text consists of a percent value, which informs about the illuminated fraction of the Moon's disk, and a trailing sign that tells something about the state of the Moon. A trailing ‘+’ sign indicates a waxing Moon, a ‘-’ sign a waning Moon, a ‘@’ sign indicates the Full Moon phase, and a ‘!’ sign the New Moon phase.

%Z[date]
Is replaced by the Moon phase text graphics of the current day of year, e.g.:
The text ‘Date %n %Z  --- Moon phase %>03*O ~Text will be expanded to
==> ‘Date 08-Mar-1995 
==> ‘           (       @@@@@@
==> ‘      (              @@@@@@@@@
==> ‘    (                @@@@@@@@@@@
==> ‘  (                   @@@@@@@@@@@@
==> ‘ (                    @@@@@@@@@@@@@
==> ‘(                      @@@@@@@@@@@@@
==> ‘(                      @@@@@@@@@@@@@
==> ‘ (                    @@@@@@@@@@@@@
==> ‘  (                   @@@@@@@@@@@@
==> ‘   (                  @@@@@@@@@@@
==> ‘      (             @@@@@@@@@
==> ‘           (        @@@@@@@ --- Moon phase 041%+
==> ‘Text, in case the actual system date is the 8th March 1995.

See Fixed date option --moonimage-lines=number, how to change the size of a Moon phase text graphics.

A possibly specified format within this special text is ignored by Gcal.