uTools-Manuals/docs/python/calendar.html

<div class="body" role="main"><div class="section" id="module-calendar"><h1><span class="yiyi-st" id="yiyi-10">8.2. <a class="reference internal" href="#module-calendar" title="calendar: Functions for working with calendars, including some emulation of the Unix cal program."><code class="xref py py-mod docutils literal"><span class="pre">calendar</span></code></a>  - 一般日历相关功能</span></h1><p><span class="yiyi-st" id="yiyi-11"><strong>源代码：</strong> <a class="reference external" href="https://hg.python.org/cpython/file/3.5/Lib/calendar.py">Lib / calendar.py</a></span></p><p><span class="yiyi-st" id="yiyi-12">该模块允许您输出日历像 Unix <strong class="program">cal</strong>的程序，并提供有关日历的其他有用的功能。</span><span class="yiyi-st" id="yiyi-13">默认情况下，这些日历会将星期一作为一周的第一天，将星期日作为最后一天（欧洲公约）。</span><span class="yiyi-st" id="yiyi-14">使用<a class="reference internal" href="#calendar.setfirstweekday" title="calendar.setfirstweekday"><code class="xref py py-func docutils literal"><span class="pre">setfirstweekday()</span></code></a>将星期几的第一天设置为星期日（6）或任何其他工作日。</span><span class="yiyi-st" id="yiyi-15">指定日期的参数以整数形式给出。</span><span class="yiyi-st" id="yiyi-16">有关相关功能，另请参阅<a class="reference internal" href="datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal"><span class="pre">datetime</span></code></a>和<a class="reference internal" href="time.html#module-time" title="time: Time access and conversions."><code class="xref py py-mod docutils literal"><span class="pre">time</span></code></a>模块。</span></p><p><span class="yiyi-st" id="yiyi-17">这些函数和类中的大多数依赖于使用理想化日历的<a class="reference internal" href="datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal"><span class="pre">datetime</span></code></a>模块，当前公历日历在两个方向上延伸。</span><span class="yiyi-st" id="yiyi-18">这符合定义的"可"公历的德肖维茨和莱因戈尔德的书"历法计算"，它在哪里的基准日历的所有计算。</span></p><dl class="class"><dt id="calendar.Calendar"><span class="yiyi-st" id="yiyi-19"><em class="property">class </em><code class="descclassname">calendar.</code><code class="descname">Calendar</code><span class="sig-paren">(</span><em>firstweekday=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-20">创建<a class="reference internal" href="#calendar.Calendar" title="calendar.Calendar"><code class="xref py py-class docutils literal"><span class="pre">Calendar</span></code></a>对象。</span><span class="yiyi-st" id="yiyi-21"><em>firstweekday</em>是一个整数，指定一周的第一天。</span><span class="yiyi-st" id="yiyi-22"><code class="docutils literal"><span class="pre">0</span></code>是星期一（默认），<code class="docutils literal"><span class="pre">6</span></code>是星期日。</span></p><p><span class="yiyi-st" id="yiyi-23"><a class="reference internal" href="#calendar.Calendar" title="calendar.Calendar"><code class="xref py py-class docutils literal"><span class="pre">Calendar</span></code></a>对象提供了几种可用于准备日历数据进行格式化的方法。</span><span class="yiyi-st" id="yiyi-24">此类不做任何格式本身。</span><span class="yiyi-st" id="yiyi-25">这是子类的工作。</span></p><p><span class="yiyi-st" id="yiyi-26"><a class="reference internal" href="#calendar.Calendar" title="calendar.Calendar"><code class="xref py py-class docutils literal"><span class="pre">Calendar</span></code></a>实例具有以下方法：</span></p><dl class="method"><dt id="calendar.Calendar.iterweekdays"><span class="yiyi-st" id="yiyi-27"><code class="descname">iterweekdays</code><span class="sig-paren">(</span><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-28">返回迭代器将用于一周星期天的数字。</span><span class="yiyi-st" id="yiyi-29">迭代器的第一个值将与<a class="reference internal" href="#calendar.firstweekday" title="calendar.firstweekday"><code class="xref py py-attr docutils literal"><span class="pre">firstweekday</span></code></a>属性的值相同。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.itermonthdates"><span class="yiyi-st" id="yiyi-30"><code class="descname">itermonthdates</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-31">在今年<em>年</em>中返回迭代器，供月<em>个月</em>（1-12）。</span><span class="yiyi-st" id="yiyi-32">此迭代器将返回获取完整周所需的月份和月初之前的所有天以及月末之后的所有天（如<a class="reference internal" href="datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal"><span class="pre">datetime.date</span></code></a>对象）。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.itermonthdays2"><span class="yiyi-st" id="yiyi-33"><code class="descname">itermonthdays2</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-34">返回类似于<a class="reference internal" href="#calendar.Calendar.itermonthdates" title="calendar.Calendar.itermonthdates"><code class="xref py py-meth docutils literal"><span class="pre">itermonthdates()</span></code></a>的<em>年</em>中的<em>月</em>月的迭代器。</span><span class="yiyi-st" id="yiyi-35">天返回将元组组成的日数和每周的天数。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.itermonthdays"><span class="yiyi-st" id="yiyi-36"><code class="descname">itermonthdays</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-37">返回类似于<a class="reference internal" href="#calendar.Calendar.itermonthdates" title="calendar.Calendar.itermonthdates"><code class="xref py py-meth docutils literal"><span class="pre">itermonthdates()</span></code></a>的<em>年</em>中的<em>月</em>月的迭代器。</span><span class="yiyi-st" id="yiyi-38">天返回只会天的数字。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.monthdatescalendar"><span class="yiyi-st" id="yiyi-39"><code class="descname">monthdatescalendar</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-40">全周在<em>一年</em>的月<em>每月</em>返回列表的几个星期。</span><span class="yiyi-st" id="yiyi-41">周是七个<a class="reference internal" href="datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal"><span class="pre">datetime.date</span></code></a>对象的列表。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.monthdays2calendar"><span class="yiyi-st" id="yiyi-42"><code class="descname">monthdays2calendar</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-43">全周在<em>一年</em>的月<em>每月</em>返回列表的几个星期。</span><span class="yiyi-st" id="yiyi-44">周是天数字以及平日七元组的列表。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.monthdayscalendar"><span class="yiyi-st" id="yiyi-45"><code class="descname">monthdayscalendar</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-46">全周在<em>一年</em>的月<em>每月</em>返回列表的几个星期。</span><span class="yiyi-st" id="yiyi-47">周有七天的数字列表。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.yeardatescalendar"><span class="yiyi-st" id="yiyi-48"><code class="descname">yeardatescalendar</code><span class="sig-paren">(</span><em>year</em>, <em>width=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-49">返回为指定年份的数据准备好格式。</span><span class="yiyi-st" id="yiyi-50">返回值是的月行的列表。</span><span class="yiyi-st" id="yiyi-51">每个月行包含到<em>宽度</em>（默认为 3） 的几个月。</span><span class="yiyi-st" id="yiyi-52">每月包含 4 至 6 个星期，每星期包含 1 — — 7 天。</span><span class="yiyi-st" id="yiyi-53">天是<a class="reference internal" href="datetime.html#datetime.date" title="datetime.date"><code class="xref py py-class docutils literal"><span class="pre">datetime.date</span></code></a>对象。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.yeardays2calendar"><span class="yiyi-st" id="yiyi-54"><code class="descname">yeardays2calendar</code><span class="sig-paren">(</span><em>year</em>, <em>width=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-55">返回指定年份的准备格式化的数据（类似于<a class="reference internal" href="#calendar.Calendar.yeardatescalendar" title="calendar.Calendar.yeardatescalendar"><code class="xref py py-meth docutils literal"><span class="pre">yeardatescalendar()</span></code></a>）。</span><span class="yiyi-st" id="yiyi-56">星期列表中的条目是天数字以及平日的元组。</span><span class="yiyi-st" id="yiyi-57">天外面这个月的数字为零。</span></p></dd></dl><dl class="method"><dt id="calendar.Calendar.yeardayscalendar"><span class="yiyi-st" id="yiyi-58"><code class="descname">yeardayscalendar</code><span class="sig-paren">(</span><em>year</em>, <em>width=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-59">返回指定年份的准备格式化的数据（类似于<a class="reference internal" href="#calendar.Calendar.yeardatescalendar" title="calendar.Calendar.yeardatescalendar"><code class="xref py py-meth docutils literal"><span class="pre">yeardatescalendar()</span></code></a>）。</span><span class="yiyi-st" id="yiyi-60">星期列表中的条目是一天的数字。</span><span class="yiyi-st" id="yiyi-61">天外面这个月的数字为零。</span></p></dd></dl></dd></dl><dl class="class"><dt id="calendar.TextCalendar"><span class="yiyi-st" id="yiyi-62"><em class="property">class </em><code class="descclassname">calendar.</code><code class="descname">TextCalendar</code><span class="sig-paren">(</span><em>firstweekday=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-63">此类可用于生成纯文本的日历。</span></p><p><span class="yiyi-st" id="yiyi-64"><a class="reference internal" href="#calendar.TextCalendar" title="calendar.TextCalendar"><code class="xref py py-class docutils literal"><span class="pre">TextCalendar</span></code></a>实例具有以下方法：</span></p><dl class="method"><dt id="calendar.TextCalendar.formatmonth"><span class="yiyi-st" id="yiyi-65"> <code class="descname">formatmonth</code><span class="sig-paren">(</span><em>theyear</em>, <em>themonth</em>, <em>w=0</em>, <em>l=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-66">在一个多行字符串返回一个月的日历。</span><span class="yiyi-st" id="yiyi-67">如果提供了<em>w</em> ，它指定的日期列，居中的宽度。</span><span class="yiyi-st" id="yiyi-68">如果给出<em>l</em> ，它指定每个星期会使用的行的数。</span><span class="yiyi-st" id="yiyi-69">取决于构造函数中指定的第一个工作日或由<a class="reference internal" href="#calendar.setfirstweekday" title="calendar.setfirstweekday"><code class="xref py py-meth docutils literal"><span class="pre">setfirstweekday()</span></code></a>方法设置的第一个工作日。</span></p></dd></dl><dl class="method"><dt id="calendar.TextCalendar.prmonth"><span class="yiyi-st" id="yiyi-70"> <code class="descname">prmonth</code><span class="sig-paren">(</span><em>theyear</em>, <em>themonth</em>, <em>w=0</em>, <em>l=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-71">打印<a class="reference internal" href="#calendar.TextCalendar.formatmonth" title="calendar.TextCalendar.formatmonth"><code class="xref py py-meth docutils literal"><span class="pre">formatmonth()</span></code></a>返回的一个月的日历。</span></p></dd></dl><dl class="method"><dt id="calendar.TextCalendar.formatyear"><span class="yiyi-st" id="yiyi-72"><code class="descname">formatyear</code><span class="sig-paren">(</span><em>theyear</em>, <em>w=2</em>, <em>l=1</em>, <em>c=6</em>, <em>m=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-73">返回一个<em>m</em>-列作为一个多行字符串的整整一年的日历。</span><span class="yiyi-st" id="yiyi-74">可选参数<em>w</em>、 <em>l</em>和<em>c</em>分别为日期列的宽度，每周和每月列之间的空格数行。</span><span class="yiyi-st" id="yiyi-75">取决于构造函数中指定的第一个工作日或由<a class="reference internal" href="#calendar.setfirstweekday" title="calendar.setfirstweekday"><code class="xref py py-meth docutils literal"><span class="pre">setfirstweekday()</span></code></a>方法设置的第一个工作日。</span><span class="yiyi-st" id="yiyi-76">最早一年可以为其生成的日历是取决于平台。</span></p></dd></dl><dl class="method"><dt id="calendar.TextCalendar.pryear"><span class="yiyi-st" id="yiyi-77"> <code class="descname">pryear</code><span class="sig-paren">(</span><em>theyear</em>, <em>w=2</em>, <em>l=1</em>, <em>c=6</em>, <em>m=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-78">打印<a class="reference internal" href="#calendar.TextCalendar.formatyear" title="calendar.TextCalendar.formatyear"><code class="xref py py-meth docutils literal"><span class="pre">formatyear()</span></code></a>返回的整年的日历。</span></p></dd></dl></dd></dl><dl class="class"><dt id="calendar.HTMLCalendar"><span class="yiyi-st" id="yiyi-79"><em class="property">class </em><code class="descclassname">calendar.</code><code class="descname">HTMLCalendar</code><span class="sig-paren">(</span><em>firstweekday=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-80">此类可用于生成 HTML 的日历。</span></p><p><span class="yiyi-st" id="yiyi-81"><a class="reference internal" href="#calendar.HTMLCalendar" title="calendar.HTMLCalendar"><code class="xref py py-class docutils literal"><span class="pre">HTMLCalendar</span></code></a>实例具有以下方法：</span></p><dl class="method"><dt id="calendar.HTMLCalendar.formatmonth"><span class="yiyi-st" id="yiyi-82"><code class="descname">formatmonth</code><span class="sig-paren">(</span><em>theyear</em>, <em>themonth</em>, <em>withyear=True</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-83">作为一个 HTML 表中返回一个月的日历。</span><span class="yiyi-st" id="yiyi-84">如果<em>withyear</em>为 true 年将包括在页眉中，否则将使用只是月份名称。</span></p></dd></dl><dl class="method"><dt id="calendar.HTMLCalendar.formatyear"><span class="yiyi-st" id="yiyi-85"><code class="descname">formatyear</code><span class="sig-paren">(</span><em>theyear</em>, <em>width=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-86">作为一个 HTML 表返回一年的日历。</span><span class="yiyi-st" id="yiyi-87"><em>width</em>（默认值为3）指定每行的月数。</span></p></dd></dl><dl class="method"><dt id="calendar.HTMLCalendar.formatyearpage"><span class="yiyi-st" id="yiyi-88"><code class="descname">formatyearpage</code><span class="sig-paren">(</span><em>theyear</em>, <em>width=3</em>, <em>css='calendar.css'</em>, <em>encoding=None</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-89">作为一个完整的 HTML 页面返回一年的日历。</span><span class="yiyi-st" id="yiyi-90"><em>width</em>（默认值为3）指定每行的月数。</span><span class="yiyi-st" id="yiyi-91"><em>css</em>是使用级联样式表的名称。</span><span class="yiyi-st" id="yiyi-92">如果不使用样式表，则可以传递<a class="reference internal" href="constants.html#None" title="None"><code class="xref py py-const docutils literal"><span class="pre">None</span></code></a>。</span><span class="yiyi-st" id="yiyi-93"><em>编码</em>指定的编码将用于输出 （默认设置为系统默认的编码）。</span></p></dd></dl></dd></dl><dl class="class"><dt id="calendar.LocaleTextCalendar"><span class="yiyi-st" id="yiyi-94"><em class="property">class </em><code class="descclassname">calendar.</code><code class="descname">LocaleTextCalendar</code><span class="sig-paren">(</span><em>firstweekday=0</em>, <em>locale=None</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-95"><a class="reference internal" href="#calendar.TextCalendar" title="calendar.TextCalendar"><code class="xref py py-class docutils literal"><span class="pre">TextCalendar</span></code></a>的这个子类可以在构造函数中传递一个语言环境名称，并且将返回指定语言环境中的月和周日名称。</span><span class="yiyi-st" id="yiyi-96">如果此区域设置包括编码所有字符串包含月份和星期几名称将作为 unicode 返回。</span></p></dd></dl><dl class="class"><dt id="calendar.LocaleHTMLCalendar"><span class="yiyi-st" id="yiyi-97"><em class="property">class </em><code class="descclassname">calendar.</code><code class="descname">LocaleHTMLCalendar</code><span class="sig-paren">(</span><em>firstweekday=0</em>, <em>locale=None</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-98"><a class="reference internal" href="#calendar.HTMLCalendar" title="calendar.HTMLCalendar"><code class="xref py py-class docutils literal"><span class="pre">HTMLCalendar</span></code></a>的此子类可在构造函数中传递一个语言环境名称，并将在指定的语言环境中返回月和周日名称。</span><span class="yiyi-st" id="yiyi-99">如果此区域设置包括编码所有字符串包含月份和星期几名称将作为 unicode 返回。</span></p></dd></dl><div class="admonition note"><p class="first admonition-title"><span class="yiyi-st" id="yiyi-100">注</span></p><p class="last"><span class="yiyi-st" id="yiyi-101">这两个类的<code class="xref py py-meth docutils literal"><span class="pre">formatweekday()</span></code>和<code class="xref py py-meth docutils literal"><span class="pre">formatmonthname()</span></code>方法将当前语言环境临时更改为给定的<em>语言环境</em>。</span><span class="yiyi-st" id="yiyi-102">因为当前的区域设置是进程范围的设置，他们不是线程安全的。</span></p></div><p><span class="yiyi-st" id="yiyi-103">对于简单的文本日历本模块提供了下列函数。</span></p><dl class="function"><dt id="calendar.setfirstweekday"><span class="yiyi-st" id="yiyi-104"><code class="descclassname">calendar.</code><code class="descname">setfirstweekday</code><span class="sig-paren">(</span><em>weekday</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-105">设置每周开始的工作日（<code class="docutils literal"><span class="pre">0</span></code>是星期一，<code class="docutils literal"><span class="pre">6</span></code>是星期日）。</span><span class="yiyi-st" id="yiyi-106"><code class="xref py py-const docutils literal"><span class="pre">MONDAY</span></code>，<code class="xref py py-const docutils literal"><span class="pre">TUESDAY</span></code>，<code class="xref py py-const docutils literal"><span class="pre">WEDNESDAY</span></code>，<code class="xref py py-const docutils literal"><span class="pre">THURSDAY</span></code>，<code class="xref py py-const docutils literal"><span class="pre">FRIDAY</span></code>，<code class="xref py py-const docutils literal"><span class="pre">SATURDAY</span></code>和<code class="xref py py-const docutils literal"><span class="pre">SUNDAY</span></code>。</span><span class="yiyi-st" id="yiyi-107">例如，若要设置的第一个工作日到星期天：</span></p><pre><code class="language-python"><span></span><span class="kn">import</span> <span class="nn">calendar</span>
<span class="n">calendar</span><span class="o">.</span><span class="n">setfirstweekday</span><span class="p">(</span><span class="n">calendar</span><span class="o">.</span><span class="n">SUNDAY</span><span class="p">)</span>
</code></pre></dd></dl><dl class="function"><dt id="calendar.firstweekday"><span class="yiyi-st" id="yiyi-108"><code class="descclassname">calendar.</code><code class="descname">firstweekday</code><span class="sig-paren">(</span><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-109">返回为平日的当前设置，每个星期开始。</span></p></dd></dl><dl class="function"><dt id="calendar.isleap"><span class="yiyi-st" id="yiyi-110"><code class="descclassname">calendar.</code><code class="descname">isleap</code><span class="sig-paren">(</span><em>year</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-111">如果<em>年</em>是闰年，则返回<a class="reference internal" href="constants.html#True" title="True"><code class="xref py py-const docutils literal"><span class="pre">True</span></code></a>，否则<a class="reference internal" href="constants.html#False" title="False"><code class="xref py py-const docutils literal"><span class="pre">False</span></code></a>。</span></p></dd></dl><dl class="function"><dt id="calendar.leapdays"><span class="yiyi-st" id="yiyi-112"><code class="descclassname">calendar.</code><code class="descname">leapdays</code><span class="sig-paren">(</span><em>y1</em>, <em>y2</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-113">返回闰年的数目范围内从<em>y1</em>到<em>y2</em> （专用）， <em>y1</em>和<em>y2</em>是几年。</span></p><p><span class="yiyi-st" id="yiyi-114">此函数适用于跨越一个世纪变化的范围。</span></p></dd></dl><dl class="function"><dt id="calendar.weekday"><span class="yiyi-st" id="yiyi-115"><code class="descclassname">calendar.</code><code class="descname">weekday</code><span class="sig-paren">(</span><em>year</em>, <em>month</em>, <em>day</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-116">返回<em>年</em>（<code class="docutils literal"><span class="pre">1970</span></code> -...），<em>月</em>的星期几（<code class="docutils literal"><span class="pre">0</span></code> （<code class="docutils literal"><span class="pre">1</span></code>  -  <code class="docutils literal"><span class="pre">12</span></code>），<em>天</em>（<code class="docutils literal"><span class="pre">1</span></code>  -  <code class="docutils literal"><span class="pre">31</span></code>）。</span></p></dd></dl><dl class="function"><dt id="calendar.weekheader"><span class="yiyi-st" id="yiyi-117"><code class="descclassname">calendar.</code><code class="descname">weekheader</code><span class="sig-paren">(</span><em>n</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-118">返回包含缩写的星期几名称的标头。</span><span class="yiyi-st" id="yiyi-119"><em>n</em>指定宽度 （以字符为一个工作日。</span></p></dd></dl><dl class="function"><dt id="calendar.monthrange"><span class="yiyi-st" id="yiyi-120"><code class="descclassname">calendar.</code><code class="descname">monthrange</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-121">返回月份，为指定的<em>年</em>、<em>月</em>中的工作日的天数，每月的第一天。</span></p></dd></dl><dl class="function"><dt id="calendar.monthcalendar"><span class="yiyi-st" id="yiyi-122"><code class="descclassname">calendar.</code><code class="descname">monthcalendar</code><span class="sig-paren">(</span><em>year</em>, <em>month</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-123">返回一个矩阵，代表一个月的日历。</span><span class="yiyi-st" id="yiyi-124">每行代表一周；日期外的月份a由零表示。</span><span class="yiyi-st" id="yiyi-125">除非由<a class="reference internal" href="#calendar.setfirstweekday" title="calendar.setfirstweekday"><code class="xref py py-func docutils literal"><span class="pre">setfirstweekday()</span></code></a>设置，否则每周开始为星期一。</span></p></dd></dl><dl class="function"><dt id="calendar.prmonth"><span class="yiyi-st" id="yiyi-126"> <code class="descclassname">calendar.</code><code class="descname">prmonth</code><span class="sig-paren">(</span><em>theyear</em>, <em>themonth</em>, <em>w=0</em>, <em>l=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-127">打印由<a class="reference internal" href="#calendar.month" title="calendar.month"><code class="xref py py-func docutils literal"><span class="pre">month()</span></code></a>返回的一个月的日历。</span></p></dd></dl><dl class="function"><dt id="calendar.month"><span class="yiyi-st" id="yiyi-128"> <code class="descclassname">calendar.</code><code class="descname">month</code><span class="sig-paren">(</span><em>theyear</em>, <em>themonth</em>, <em>w=0</em>, <em>l=0</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-129">使用<a class="reference internal" href="#calendar.TextCalendar" title="calendar.TextCalendar"><code class="xref py py-class docutils literal"><span class="pre">TextCalendar</span></code></a>类的<code class="xref py py-meth docutils literal"><span class="pre">formatmonth()</span></code>返回多行字符串中的一个月的日历。</span></p></dd></dl><dl class="function"><dt id="calendar.prcal"><span class="yiyi-st" id="yiyi-130"> <code class="descclassname">calendar.</code><code class="descname">prcal</code><span class="sig-paren">(</span><em>year</em>, <em>w=0</em>, <em>l=0</em>, <em>c=6</em>, <em>m=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-131">打印由<a class="reference internal" href="#module-calendar" title="calendar: Functions for working with calendars, including some emulation of the Unix cal program."><code class="xref py py-func docutils literal"><span class="pre">calendar()</span></code></a>返回的整年的日历。</span></p></dd></dl><dl class="function"><dt id="calendar.calendar"><span class="yiyi-st" id="yiyi-132"> <code class="descclassname">calendar.</code><code class="descname">calendar</code><span class="sig-paren">(</span><em>year</em>, <em>w=2</em>, <em>l=1</em>, <em>c=6</em>, <em>m=3</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-133">使用<a class="reference internal" href="#calendar.TextCalendar" title="calendar.TextCalendar"><code class="xref py py-class docutils literal"><span class="pre">TextCalendar</span></code></a>类的<code class="xref py py-meth docutils literal"><span class="pre">formatyear()</span></code>）作为多行字符串返回整年的3列日历。</span></p></dd></dl><dl class="function"><dt id="calendar.timegm"><span class="yiyi-st" id="yiyi-134"><code class="descclassname">calendar.</code><code class="descname">timegm</code><span class="sig-paren">(</span><em>tuple</em><span class="sig-paren">)</span></span></dt><dd><p><span class="yiyi-st" id="yiyi-135">一个不相关但方便的函数，它需要一个时间元组，例如由<a class="reference internal" href="time.html#module-time" title="time: Time access and conversions."><code class="xref py py-mod docutils literal"><span class="pre">time</span></code></a>模块中的<a class="reference internal" href="time.html#time.gmtime" title="time.gmtime"><code class="xref py py-func docutils literal"><span class="pre">gmtime()</span></code></a>函数返回，并返回相应的Unix时间戳值， 1970，和POSIX编码。</span><span class="yiyi-st" id="yiyi-136">事实上，<a class="reference internal" href="time.html#time.gmtime" title="time.gmtime"><code class="xref py py-func docutils literal"><span class="pre">time.gmtime()</span></code></a>和<a class="reference internal" href="#calendar.timegm" title="calendar.timegm"><code class="xref py py-func docutils literal"><span class="pre">timegm()</span></code></a>彼此相反。</span></p></dd></dl><p><span class="yiyi-st" id="yiyi-137"><a class="reference internal" href="#module-calendar" title="calendar: Functions for working with calendars, including some emulation of the Unix cal program."><code class="xref py py-mod docutils literal"><span class="pre">calendar</span></code></a>模块导出以下数据属性：</span></p><dl class="data"><dt id="calendar.day_name"><span class="yiyi-st" id="yiyi-138"><code class="descclassname">calendar.</code><code class="descname">day_name</code></span></dt><dd><p><span class="yiyi-st" id="yiyi-139">一个数组，表示当前的区域设置中的星期数。</span></p></dd></dl><dl class="data"><dt id="calendar.day_abbr"><span class="yiyi-st" id="yiyi-140"><code class="descclassname">calendar.</code><code class="descname">day_abbr</code></span></dt><dd><p><span class="yiyi-st" id="yiyi-141">一个数组，表示当前的区域设置中的缩写的星期数。</span></p></dd></dl><dl class="data"><dt id="calendar.month_name"><span class="yiyi-st" id="yiyi-142"><code class="descclassname">calendar.</code><code class="descname">month_name</code></span></dt><dd><p><span class="yiyi-st" id="yiyi-143">一个数组，表示今年的几个月中的当前区域设置。</span><span class="yiyi-st" id="yiyi-144">这遵循正常惯例的1月是月份1，所以它的长度为13，<code class="docutils literal"><span class="pre">month_name[0]</span></code>是空字符串。</span></p></dd></dl><dl class="data"><dt id="calendar.month_abbr"><span class="yiyi-st" id="yiyi-145"><code class="descclassname">calendar.</code><code class="descname">month_abbr</code></span></dt><dd><p><span class="yiyi-st" id="yiyi-146">一个数组，表示今年的缩写个月中的当前区域设置。</span><span class="yiyi-st" id="yiyi-147">这遵循1月的月份1的正常惯例，因此它的长度为13，而<code class="docutils literal"><span class="pre">month_abbr[0]</span></code>是空字符串。</span></p></dd></dl><div class="admonition seealso"><p class="first admonition-title"><span class="yiyi-st" id="yiyi-148">请参见</span></p><dl class="last docutils"><dt><span class="yiyi-st" id="yiyi-149">模块<a class="reference internal" href="datetime.html#module-datetime" title="datetime: Basic date and time types."><code class="xref py py-mod docutils literal"><span class="pre">datetime</span></code></a></span></dt><dd><span class="yiyi-st" id="yiyi-150">面向对象的日期和时间接口，具有与<a class="reference internal" href="time.html#module-time" title="time: Time access and conversions."><code class="xref py py-mod docutils literal"><span class="pre">time</span></code></a>模块类似的功能。</span></dd><dt><span class="yiyi-st" id="yiyi-151">模块<a class="reference internal" href="time.html#module-time" title="time: Time access and conversions."><code class="xref py py-mod docutils literal"><span class="pre">time</span></code></a></span></dt><dd><span class="yiyi-st" id="yiyi-152">低级时间相关功能。</span></dd></dl></div></div></div>