Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DateTime::Calendar::DiUserdContributed Perl DDateTime::Calendar::Discordian(3)

NAME
       DateTime::Calendar::Discordian -	Perl extension for the Discordian
       Calendar

SYNOPSIS
	 use DateTime::Calendar::Discordian;

ABSTRACT
       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.

VERSION
       This document describes DateTime::Calendar::Discordian version 1.0

DESCRIPTION
   The Discordian Calendar
       Seasons

	       Name	       Patron apostle
	       ----	       --------------
	       Chaos	       Hung Mung
	       Discord	       Dr. Van Van Mojo
	       Confusion       Sri Syadasti
	       Bureaucracy	   Zarathud
	       The Aftermath   The Elder Malaclypse

       Each season contains 73 consecutively numbered days.

       Holydays

	       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. Tib's 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,
       -1167 B.C.

       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	YOLD.

       Days Of The Week

	       1. Sweetmorn
	       2. Boomtime
	       3. Pungenday
	       4. Prickle-Prickle
	       5. Setting Orange

       The days	of the week are	named from the five Basic Elements: sweet,
       boom, pungent, prickle and orange.

METHODS
   new
       Constructs a new	DateTime::Calendar::Discordian object.	This class
       method requires the parameters day, season, and year.  If day is	given
       as "St. Tib's 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.

   clone
       Returns a copy of the object.

   day
       Returns the day of the season as	a number between 1 and 73 or the
       string "St. Tib's Day".

   day_abbr
       Returns the name	of the day of the week in abbreviated form or false if
       it is "St. Tib's	Day".

   day_name
       Returns the full	name of	the day	of the week or "St. Tib's Day" if it
       is that day.

   days_till_x
       Returns the number of days until	X Day.

   from_object
       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,));

   holyday
       If the current day is a holy day, returns the name of that day
       otherwise returns an empty string.

   season_abbr
       Returns the abbreviated name of the current season.

   season_name
       Returns the full	name of	the current season.

   strftime
       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 doesn't exist, then it is simply treated as text.

       strftime	Specifiers

       The following specifiers	are allowed in the format string given to the
       strftime	method:

       o   %a

	   Abbreviated name of the day of the week (i.e., SM.)	Internally
	   uses	the day_abbr function.

       o   %A

	   Full	name of	the day	of the week (i.e., Sweetmorn.)	Internally
	   uses	the day_name function.

       o   %b

	   Abbreviated name of the season (i.e., Chs.)	Internally uses	the
	   season_abbr function.

       o   %B

	   Full	name of	the season (i.e., Chaos.)  Internally uses the
	   season_name function.

       o   %d

	   Ordinal number of day in season (i.e., 23.)	Internally uses	the
	   day function.

       o   %e

	   Cardinal number of day in season (i.e., 23rd.)

       o   %H

	   Name	of current Holyday, if any.  Internally	uses the holyday
	   function.

       o   %n

	   A newline character.

       o   %N

	   Magic code to prevent rest of format	from being printed unless
	   today is a Holyday.

       o   %t

	   A tab character.

       o   %X

	   Number of days remaining until X-Day.  Internally uses the
	   days_till_x function.

       o   %Y

	   Number of Year Of Lady Discord (YOLD.)  Internally uses the year
	   function.

       o   %{

       o   %}

	   Used	to enclose the part of the string which	is to be replaced with
	   the words "St. Tib's	Day" if	the current day	is St. Tib's Day.

       o   %%

	   A literal `%' character.

       o   %.

	   Try it and see.

   utc_rd_values
       Returns a three-element array containing	the current UTC	RD days,
       seconds,	and nanoseconds.  See DateTime for more	details.

   year
       Returns the current year	according to the YOLD (Year Of Lady Discord)
       era.

SUPPORT
       After installing, you can find documentation for	this module with the
       perldoc command.

	   perldoc DateTime::Calendar::Discordian

       Support for this	module is provided via the datetime@perl.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
       bug-datetime-calendar-discordian@rt.cpan.org.

       You can also look for information at:

       o   Search CPAN.	<http://search.cpan.org/dist/DateTime-Calendar-
	   Discordian>

       o   AnnoCPAN, annotated CPAN documentation.
	   <http://annocpan.org/dist/DateTime-Calendar-Discordian>

       o   CPAN	Ratings. <http://cpanratings.perl.org/d/DateTime-Calendar-
	   Discordian>

AUTHOR
       Jaldhar H. Vyas,	<jaldhar@braincells.com>

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.

SEE ALSO
       o   The DateTime	project	web site. <http://datetime.perl.org/>

       o   The Principia Discordia. <http://www.ology.org/principia/>

       o   The Church of the SubGenius.	<http://www.subgenius.com/>

perl v5.32.1			  2012-06-12 DateTime::Calendar::Discordian(3)

NAME | SYNOPSIS | ABSTRACT | VERSION | DESCRIPTION | METHODS | SUPPORT | AUTHOR | COPYRIGHT AND LICENSE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DateTime::Calendar::Discordian&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help