summaryrefslogtreecommitdiff
path: root/Doc/lib/libcalendar.tex
blob: 0c7207b5fd0e6402acdfd16d47266598b84e7f56 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
% This section was contributed by Drew Csillag <drew_csillag@geocities.com>.

\section{\module{calendar} ---
         Functions that emulate the \UNIX{} \program{cal} program.}
\declaremodule{standard}{calendar}

\modulesynopsis{Functions that emulate the \UNIX{} \program{cal}
program.}


This module allows you to output calendars like the \UNIX{}
\manpage{cal}{1} program.

\begin{funcdesc}{isleap}{year}
Returns \code{1} if \var{year} is a leap year.
\end{funcdesc}

\begin{funcdesc}{leapdays}{year1, year2}
Return the number of leap years in the range
[\var{year1}\ldots\var{year2}].
\end{funcdesc}

\begin{funcdesc}{weekday}{year, month, day}
Returns the day of the week (\code{0} is Monday) for \var{year}
(\code{1970}--\ldots), \var{month} (\code{1}--\code{12}), \var{day}
(\code{1}--\code{31}).
\end{funcdesc}

\begin{funcdesc}{monthrange}{year, month}
Returns weekday of first day of the month and number of days in month, 
for the specified \var{year} and \var{month}.
\end{funcdesc}

\begin{funcdesc}{monthcalendar}{year, month}
Returns a matrix representing a month's calendar.  Each row represents
a week; days outside of the month a represented by zeros.
\end{funcdesc}

\begin{funcdesc}{prmonth}{year, month\optional{, width\optional{, length}}}
Prints a month's calendar.  If \var{width} is provided, it specifies
the width of the columns that the numbers are centered in.  If
\var{length} is given, it specifies the number of lines that each
week will use.
\end{funcdesc}

\begin{funcdesc}{prcal}{year}
Prints the calendar for the year \var{year}.
\end{funcdesc}