ddate(1) - f14

1DDATE(1)                   Emperor Norton Utilities                   DDATE(1)
2
3
4

NAME

6       ddate - converts Gregorian dates to Discordian dates
7

SYNOPSIS

9       ddate [+format] [date]
10

DESCRIPTION

12       ddate prints the date in Discordian date format.
13
14       If  called  with  no arguments, ddate will get the current system date,
15       convert this to the Discordian date format and print this on the  stan‐
16       dard  output.  Alternatively,  a Gregorian date may be specified on the
17       command line, in the form of a numerical day, month and year.
18
19       If a format string is specified, the Discordian date will be printed in
20       a format specified by the string. This mechanism works similarly to the
21       format string mechanism of date(1), only almost completely differently.
22       The fields are:
23
24       %A     Full name of the day of the week (i.e., Sweetmorn)
25
26       %a     Abbreviated name of the day of the week (i.e., SM)
27
28       %B     Full name of the season (i.e., Chaos)
29
30       %b     Abbreviated name of the season (i.e., Chs)
31
32       %d     Ordinal number of day in season (i.e., 23)
33
34       %e     Cardinal number of day in season (i.e., 23rd)
35
36       %H     Name of current Holyday, if any
37
38       %N     Magic  code  to prevent rest of format from being printed unless
39              today is a Holyday.
40
41       %n     Newline
42
43       %t     Tab
44
45       %X     Number of days remaining until X-Day. (Not valid if  the  SubGe‐
46              nius options are not compiled in.)
47
48       %{
49
50       %}     Used  to  enclose the part of the string which is to be replaced
51              with the words "St. Tib's Day" if the current day is  St.  Tib's
52              Day.
53
54       %.     Try it and see.
55

EXAMPLES

57       % ddate
58       Sweetmorn, Bureaucracy 42, 3161 YOLD
59
60       % ddate +'Today is %{%A, the %e of %B%}, %Y. %N%nCelebrate %H'
61       Today is Sweetmorn, the 42nd of Bureaucracy, 3161.
62
63       % ddate +"It's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 26 9 1995
64       It's Prickle-Prickle, the 50th of Bureaucracy, 3161.
65       Celebrate Bureflux
66
67       % ddate +"Today's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 29 2 1996
68       Today's St. Tib's Day, 3162.
69
70

BUGS

72       ddate(1)  will produce undefined behaviour if asked to produce the date
73       for St. Tib's day and its format string does not contain the St.  Tib's
74       Day delimiters %{ and %}.
75
76

NOTE

78       After  `X-Day'  passed  without  incident,  the Church of the SubGenius
79       declared that it had got the year upside down - X-Day  is  actually  in
80       8661 AD rather than 1998 AD.  Thus, the True X-Day is Cfn 40, 9827.
81
82

AUTHOR

84       Original   program   by   Druel   the   Chaotic   aka   Jeremy  Johnson
85       (mpython@gnu.ai.mit.edu)
86       Major  rewrite  by  Lee  H:.  O:.  Smith,  KYTP,  aka   Andrew   Bulhak
87       (acb@dev.null.org)
88       Five tons of flax.
89
90

DISTRIBUTION POLICY

92       Public domain. All rites reversed.
93
94

AVAILABILITY

103       The ddate command is part of the util-linux-ng package and is available
104       from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
105
106
107
108                              59 Bureaucracy 3161                     DDATE(1)