Manual Reference Pages - DATETIME::CALENDAR::DISCORDIAN (3)
DateTime::Calendar::Discordian - Perl extension for the Discordian Calendar
A module that implements the Discordian calendar made popular(?) in the
Illuminatus! trilogy by Robert Shea and Robert Anton Wilson and by the
Church of the SubGenius.
This document describes DateTime::Calendar::Discordian version 1.0
The Discordian Calendar
Name Patron apostle
Chaos Hung Mung
Discord Dr. Van Van Mojo
Confusion Sri Syadasti
The Aftermath The Elder Malaclypse
Each season contains 73 consecutively numbered days.
Apostle Holydays Season Holydays
1) Mungday 1) Chaoflux
2) Mojoday 2) Discoflux
3) Syaday 3) Confuflux
4) Zaraday 4) Bureflux
5) Maladay 5) Afflux
Apostle Holydays occur on the 5th day of the season.
Season Holydays occur on the 50th day of the deason.
St. Tibs Day occurs once every 4 years (1+4=5) and is inserted between
the 59th and 60th days of the Season of Chaos.
The era of the Discordian Calendar is called Year Of Lady Discord
(YOLD.) Its epoch (Confusion 1 of year 0) is equivalent to January 1,
X Day is when the Church of the SubGenius believes the alien X-ists will
destroy the world. The revised date is equivalent to Confusion 40, 9827
Days Of The Week
5. Setting Orange
The days of the week are named from the five Basic Elements: sweet,
boom, pungent, prickle and orange.
Constructs a new DateTime::Calendar::Discordian object. This class
method requires the parameters day, season, and year. If
day is given as St. Tibs Day (or reasonable facsimile thereof,)
then season is omitted. This function will die if invalid
parameters are given. For example:
my $dtcd = DateTime::Calendar::Discordian->new(
day => 8, season => Discord, year => 3137, );
The second, nanosecond, and locale parameters are also accepted for
compatability with DateTime but nothing is done with them.
Returns a copy of the object.
Returns the day of the season as a number between 1 and 73 or the string
St. Tibs Day.
Returns the name of the day of the week in abbreviated form or false if
it is St. Tibs Day.
Returns the full name of the day of the week or St. Tibs Day if it is
Returns the number of days until X Day.
Builds a DateTime::Calendar::Discordian object from another
DateTime object. This function takes an object parameter and
optionally locale. For example:
my $dtcd = DateTime::Calendar::Discordian->from_object(
object => DateTime->new(day => 22, month => 3, year => 1971,));
If the current day is a holy day, returns the name of that day otherwise
returns an empty string.
Returns the abbreviated name of the current season.
Returns the full name of the current season.
This function takes one or more parameters consisting of strings
containing special specifiers. For each such string it will return a
string formatted according to the specifiers, er, specified. See the
strftime Specifiers section for a list of the
available format specifiers. They have been chosen to be compatible
with the ddate(1) program not necessarily the strftime(3) C
function. If you give a format specifier that doesnt exist, then it is
simply treated as text.
The following specifiers are allowed in the format string given to the
Abbreviated name of the day of the week (i.e., SM.) Internally uses the
Full name of the day of the week (i.e., Sweetmorn.) Internally uses the
Abbreviated name of the season (i.e., Chs.) Internally uses the
Full name of the season (i.e., Chaos.) Internally uses the
Ordinal number of day in season (i.e., 23.) Internally uses the day
Cardinal number of day in season (i.e., 23rd.)
Name of current Holyday, if any. Internally uses the holyday
A newline character.
Magic code to prevent rest of format from being printed unless today is
A tab character.
Number of days remaining until X-Day. Internally uses the
Number of Year Of Lady Discord (YOLD.) Internally uses the year
Used to enclose the part of the string which is to be replaced with the
words St. Tibs Day if the current day is St. Tibs Day.
A literal % character.
Try it and see.
Returns a three-element array containing the current UTC RD days,
seconds, and nanoseconds. See DateTime for more details.
Returns the current year according to the YOLD (Year Of Lady Discord)
After installing, you can find documentation for this module with the perldoc
Support for this module is provided via the firstname.lastname@example.org email list. See
lists.perl.org <http://lists.perl.org/> for more details.
Please submit bugs to the CPAN RT system <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=datetime-Calendar-Discordian>
or via email at email@example.com.
You can also look for information at:
Jaldhar H. Vyas, <firstname.lastname@example.org>
COPYRIGHT AND LICENSE
Copyright (C) 2012, Consolidated Braincells Inc.
This distribution is free software; you can redistribute it and/or modify it
under the terms of either:
a) the GNU General Public License as published by the Free Software
Foundation; either version 2, or (at your option) any later version, or
b) the Artistic License version 2.0.
The full text of the license can be found in the LICENSE file included
with this distribution.
|perl v5.20.3 ||DATETIME::CALENDAR::DISCORDIAN (3) ||2012-06-12 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.