.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
. if \nF \{
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DateTime::Calendar::Discordian 3pm"
.TH DateTime::Calendar::Discordian 3pm "2015-06-19" "perl v5.20.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
DateTime::Calendar::Discordian \- Perl extension for the Discordian Calendar
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& use DateTime::Calendar::Discordian;
.Ve
.SH "ABSTRACT"
.IX Header "ABSTRACT"
A module that implements the Discordian calendar made popular(?) in the
\&\*(L"Illuminatus!\*(R" trilogy by Robert Shea and Robert Anton Wilson and by the
Church of the SubGenius.
.SH "VERSION"
.IX Header "VERSION"
This document describes DateTime::Calendar::Discordian version 1.0
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.SS "The Discordian Calendar"
.IX Subsection "The Discordian Calendar"
\fISeasons\fR
.IX Subsection "Seasons"
.PP
.Vb 7
\& Name Patron apostle
\& \-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-
\& Chaos Hung Mung
\& Discord Dr. Van Van Mojo
\& Confusion Sri Syadasti
\& Bureaucracy Zarathud
\& The Aftermath The Elder Malaclypse
.Ve
.PP
Each season contains 73 consecutively numbered days.
.PP
\fIHolydays\fR
.IX Subsection "Holydays"
.PP
.Vb 7
\& Apostle Holydays Season Holydays
\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\& 1) Mungday 1) Chaoflux
\& 2) Mojoday 2) Discoflux
\& 3) Syaday 3) Confuflux
\& 4) Zaraday 4) Bureflux
\& 5) Maladay 5) Afflux
.Ve
.PP
Apostle Holydays occur on the 5th day of the season.
.PP
Season Holydays occur on the 50th day of the deason.
.PP
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.
.PP
The era of the Discordian Calendar is called Year Of Lady Discord
(\s-1YOLD.\s0) Its' epoch (Confusion 1 of year 0) is equivalent to January 1,
\&\-1167 B.C.
.PP
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
\&\s-1YOLD.\s0
.PP
\fIDays Of The Week\fR
.IX Subsection "Days Of The Week"
.PP
.Vb 5
\& 1. Sweetmorn
\& 2. Boomtime
\& 3. Pungenday
\& 4. Prickle\-Prickle
\& 5. Setting Orange
.Ve
.PP
The days of the week are named from the five Basic Elements: sweet,
boom, pungent, prickle and orange.
.SH "METHODS"
.IX Header "METHODS"
.SS "new"
.IX Subsection "new"
Constructs a new \fIDateTime::Calendar::Discordian\fR object. This class
method requires the parameters \fIday\fR, \fIseason\fR, and \fIyear\fR. If
\&\fIday\fR is given as \*(L"St. Tib's Day\*(R" (or reasonable facsimile thereof,)
then \fIseason\fR is omitted. This function will \f(CW\*(C`die\*(C'\fR if invalid
parameters are given. For example:
.PP
my \f(CW$dtcd\fR = DateTime::Calendar::Discordian\->new(
day => 8, season => 'Discord', year => 3137, );
.PP
The \fIsecond\fR, \fInanosecond\fR, and \fIlocale\fR parameters are also accepted for
compatability with DateTime but nothing is done with them.
.SS "clone"
.IX Subsection "clone"
Returns a copy of the object.
.SS "day"
.IX Subsection "day"
Returns the day of the season as a number between 1 and 73 or the string
\&\*(L"St. Tib's Day\*(R".
.SS "day_abbr"
.IX Subsection "day_abbr"
Returns the name of the day of the week in abbreviated form or false if
it is \*(L"St. Tib's Day\*(R".
.SS "day_name"
.IX Subsection "day_name"
Returns the full name of the day of the week or \*(L"St. Tib's Day\*(R" if it is
that day.
.SS "days_till_x"
.IX Subsection "days_till_x"
Returns the number of days until X Day.
.SS "from_object"
.IX Subsection "from_object"
Builds a \fIDateTime::Calendar::Discordian\fR object from another
\&\fIDateTime\fR object. This function takes an \fIobject\fR parameter and
optionally \fIlocale\fR. For example:
.PP
my \f(CW$dtcd\fR = DateTime::Calendar::Discordian\->from_object(
object => DateTime\->new(day => 22, month => 3, year => 1971,));
.SS "holyday"
.IX Subsection "holyday"
If the current day is a holy day, returns the name of that day otherwise
returns an empty string.
.SS "season_abbr"
.IX Subsection "season_abbr"
Returns the abbreviated name of the current season.
.SS "season_name"
.IX Subsection "season_name"
Returns the full name of the current season.
.SS "strftime"
.IX Subsection "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 \fIddate\fR\|(1) program not necessarily the \fIstrftime\fR\|(3) C
function. If you give a format specifier that doesn't exist, then it is
simply treated as text.
.PP
\fIstrftime Specifiers\fR
.IX Subsection "strftime Specifiers"
.PP
The following specifiers are allowed in the format string given to the
\&\fBstrftime\fR method:
.IP "\(bu" 4
\&\f(CW%a\fR
.Sp
Abbreviated name of the day of the week (i.e., \s-1SM.\s0) Internally uses the
\&\fIday_abbr\fR function.
.IP "\(bu" 4
\&\f(CW%A\fR
.Sp
Full name of the day of the week (i.e., Sweetmorn.) Internally uses the
\&\fIday_name\fR function.
.IP "\(bu" 4
\&\f(CW%b\fR
.Sp
Abbreviated name of the season (i.e., Chs.) Internally uses the
\&\fIseason_abbr\fR function.
.IP "\(bu" 4
\&\f(CW%B\fR
.Sp
Full name of the season (i.e., Chaos.) Internally uses the
\&\fIseason_name\fR function.
.IP "\(bu" 4
\&\f(CW%d\fR
.Sp
Ordinal number of day in season (i.e., 23.) Internally uses the \fIday\fR
function.
.IP "\(bu" 4
\&\f(CW%e\fR
.Sp
Cardinal number of day in season (i.e., 23rd.)
.IP "\(bu" 4
\&\f(CW%H\fR
.Sp
Name of current Holyday, if any. Internally uses the \fIholyday\fR
function.
.IP "\(bu" 4
\&\f(CW%n\fR
.Sp
A newline character.
.IP "\(bu" 4
\&\f(CW%N\fR
.Sp
Magic code to prevent rest of format from being printed unless today is
a Holyday.
.IP "\(bu" 4
\&\f(CW%t\fR
.Sp
A tab character.
.IP "\(bu" 4
\&\f(CW%X\fR
.Sp
Number of days remaining until X\-Day. Internally uses the
\&\fIdays_till_x\fR function.
.IP "\(bu" 4
\&\f(CW%Y\fR
.Sp
Number of Year Of Lady Discord (\s-1YOLD.\s0) Internally uses the \fIyear\fR
function.
.IP "\(bu" 4
%{
.IP "\(bu" 4
%}
.Sp
Used to enclose the part of the string which is to be replaced with the
words \*(L"St. Tib's Day\*(R" if the current day is St. Tib's Day.
.IP "\(bu" 4
%%
.Sp
A literal `%' character.
.IP "\(bu" 4
%.
.Sp
Try it and see.
.SS "utc_rd_values"
.IX Subsection "utc_rd_values"
Returns a three-element array containing the current \s-1UTC RD\s0 days,
seconds, and nanoseconds. See DateTime for more details.
.SS "year"
.IX Subsection "year"
Returns the current year according to the \s-1YOLD \s0(Year Of Lady Discord)
era.
.SH "SUPPORT"
.IX Header "SUPPORT"
After installing, you can find documentation for this module with the perldoc
command.
.PP
.Vb 1
\& perldoc DateTime::Calendar::Discordian
.Ve
.PP
Support for this module is provided via the datetime@perl.org email list. See
lists.perl.org for more details.
.PP
Please submit bugs to the \s-1CPAN RT\s0 system
or via email at bug\-datetime\-calendar\-discordian@rt.cpan.org.
.PP
You can also look for information at:
.IP "\(bu" 4
Search \s-1CPAN.\s0
.IP "\(bu" 4
AnnoCPAN, annotated \s-1CPAN\s0 documentation.
.IP "\(bu" 4
\&\s-1CPAN\s0 Ratings.
.SH "AUTHOR"
.IX Header "AUTHOR"
Jaldhar H. Vyas,
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2012, Consolidated Braincells Inc.
.PP
This distribution is free software; you can redistribute it and/or modify it
under the terms of either:
.PP
a) the \s-1GNU\s0 General Public License as published by the Free Software
Foundation; either version 2, or (at your option) any later version, or
.PP
b) the Artistic License version 2.0.
.PP
The full text of the license can be found in the \s-1LICENSE\s0 file included
with this distribution.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\(bu" 4
The DateTime project web site.
.IP "\(bu" 4
The Principia Discordia.
.IP "\(bu" 4
The Church of the SubGenius.