<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="calendar" lang="zh_CN">
  <info>
    <link type="guide" xref="index#dialogs"/>
    <desc>使用 <cmd>--calendar</cmd> 选项。</desc>
    <license xmlns="http://projectmallard.org/1.0/" href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">

  <p>This work is licensed under a
  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">GNU Free
  Documentation License Version 1.1</link> or any later version.</p>

	<p>
	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), Version 1.1 or any later version published
	  by the Free Software Foundation with no Invariant Sections,
	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
	  a copy of the GFDL at this
	  <link href="https://www.gnu.org/licenses/old-licenses/fdl-1.1.txt">link</link>.
         </p>
         <p>本手册是在 GFDL 许可之下分发的 GNOME 手册集合的一部分。如果想要单独分发此手册，可以在手册中添加该许可证的一份副本然后分发，如该许可证的第 6 部分所述。</p>

	<p>各个公司使用的许多用于区别它们产品和服务的名称都声明为商标。在所有的 GNOME 文档以及 GNOME 文档项目的成员中，这些名称都是以全大写字母或首字母大写显示，从而表明它们是商标。</p>

	<p>本文档以及文档的修改版本都是在遵循 GNU 自由文档许可证的条款下提供，这表示具有以下含义：</p>
	<list>
		<item>
		  <p>文档按“原样”提供，不提供任何明示或暗示的保证，包括但不限于：文档或文档的修改版本没有适销性方面的缺陷、适合特定目的的适用性，以及没有侵权行为。您将自行承担本文档以及文档修改版本的质量、准确性以及性能方面的风险。如果任何文档或文档修改版本存在缺陷，您(而不是最初的编写者、作者或撰写人)将承担所有必需的服务、维修或更正的费用。此免责声明是本许可证的重要组成部分。如果不接受此免责声明，那么您就没有权利使用任何文档或文档的修改版本；并且</p>
		</item>
		<item>
		  <p>无论在任何情况以及在任何法律理论下，本文档或文档修改版本的作者、最初的编写者、任何撰写人或任何分发者，或者任意这些方的任何提供者都不对任何人由于使用本文档或文档修改版本引起或带来的任何直接的、间接的、特殊的、偶然的或继发的损失承担任何民事(包括疏忽)、合同或其它方面的责任，这些损失包括但不限于信誉损失、工作停止、计算机失败或故障，或任何以及所有其它损失或由此引发的或与之相关的损失，即使这些方已被告知存在出现此类损失的可能性时也是如此。</p>
		</item>
	  </list>
</license>
  <credit type="translator copyright"><name>TeliuTe</name><email>teliute@163.com</email><years>2010</years></credit><credit type="translator copyright"><name>tuhaihe</name><email>1132321739qq@gmail.com</email><years>2012</years></credit></info>
  <title>日历对话框</title>
    <p>使用 <cmd>--calendar</cmd> 选项来创建日历对话框。Zenity 在标准输出中返回选定的日期。如果没有在命令行指定日期，就使用当前日期。</p>
    <p>日历对话框支持以下选项：</p>

    <terms>

      <item>
        <title><cmd>--text</cmd>=<var>文本</var></title>
	<p>指定日历对话框里显示的文本。</p>
      </item>
     	
      <item>
        <title><cmd>--day</cmd>=<var>天</var></title>
	<p>指定日历对话框中的日子。天必须是介于 1~31 之间的数字。</p>
      </item>

      <item>
        <title><cmd>--month</cmd>=<var>月份</var></title>
	<p>指定日历对话框中的月份。月份必须是介于 1~12 之间的数字。</p>
      </item>

      <item>
        <title><cmd>--year</cmd>=<var>年</var></title>
	<p>指定日历对话框中的年份。</p>
      </item>

      <item>
        <title><cmd>--date-format</cmd>=<var>格式</var></title>
	<p>指定选定的日期返回时的样式。默认的格式取决于您的区域设置。格式必须可以被 <cmd>strftime</cmd> 函数接受，例如 <var>%A %d/%m/%y</var>。</p>
      </item>

    </terms>

    <p>下面的脚本示范了如何创建一个日历对话框：</p>

<code>
#!/bin/sh


if zenity --calendar \
--title="选择日期" \
--text="通过点击选择日期。" \
--day=10 --month=8 --year=2004
  then echo $?
  else echo "没有选择日期"
fi
</code>


    <figure>
      <title>日历对话框范例</title>
      <desc>Zenity 日历对话框范例</desc>
      <media type="image" mime="image/png" src="figures/zenity-calendar-screenshot.png"/>
   </figure>
</page>
