calendar.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-14 07:47+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

msgid ":mod:`!calendar` --- General calendar-related functions"
msgstr ":mod:`!calendar` --- توابع عمومی مرتبط با گاه‌شماری"

msgid "**Source code:** :source:`Lib/calendar.py`"
msgstr "**کد منبع:** :source:`Lib/calendar.py`"

msgid "This module allows you to output calendars like the Unix :program:`cal` program, and provides additional useful functions related to the calendar. By default, these calendars have Monday as the first day of the week, and Sunday as the last (the European convention). Use :func:`setfirstweekday` to set the first day of the week to Sunday (6) or to any other weekday.  Parameters that specify dates are given as integers. For related functionality, see also the :mod:`datetime` and :mod:`time` modules."
msgstr "این ماژول به شما امکان می‌دهد گاه‌شماری‌هایی مانند برنامه‌ی :program:`cal` یونیکس را خروجی دهید و توابع مفید دیگری مرتبط با گاه‌شماری ارائه می‌کند. به‌طور پیش‌فرض، در این گاه‌شماری‌ها دوشنبه اولین روز هفته و یکشنبه آخرین روز هفته است (بر اساس قرارداد اروپایی). برای تنظیم اولین روز هفته روی یکشنبه (۶) یا هر روز دیگری از هفته، از :func:`setfirstweekday` استفاده کنید. پارامترهایی که تاریخ‌ها را مشخص می‌کنند، به‌صورت عدد صحیح داده می‌شوند. برای قابلیت‌های مرتبط، ماژول‌های :mod:`datetime` و :mod:`time` را نیز ببینید."

msgid "The functions and classes defined in this module use an idealized calendar, the current Gregorian calendar extended indefinitely in both directions.  This matches the definition of the \"proleptic Gregorian\" calendar in Dershowitz and Reingold's book \"Calendrical Calculations\", where it's the base calendar for all computations.  Zero and negative years are interpreted as prescribed by the ISO 8601 standard.  Year 0 is 1 BC, year -1 is 2 BC, and so on."
msgstr "توابع و کلاس‌های تعریف‌شده در این ماژول از یک گاه‌شماری آرمانی استفاده می‌کنند، یعنی گاه‌شماری میلادی کنونی که به‌طور نامحدود در هر دو جهت گسترش‌یافته است. این با تعریف گاه‌شماری «میلادی تعمیم‌یافته» (proleptic Gregorian) در کتاب «Calendrical Calculations» نوشته‌ی Dershowitz و Reingold مطابقت دارد، که در آن این گاه‌شماری، گاه‌شماری پایه برای همه‌ی محاسبات است. سال‌های صفر و منفی مطابق تجویز استاندارد ISO 8601 تفسیر می‌شوند. سال ۰ برابر با ۱ قبل از میلاد است، سال منفی ۱ برابر با ۲ قبل از میلاد است، و به همین ترتیب."

msgid "Creates a :class:`Calendar` object. *firstweekday* is an integer specifying the first day of the week. :const:`MONDAY` is ``0`` (the default), :const:`SUNDAY` is ``6``."
msgstr "یک شیء :class:`Calendar` ایجاد می‌کند. *firstweekday* یک عدد صحیح است که اولین روز هفته را مشخص می‌کند. :const:`MONDAY` برابر ``0`` است (پیش‌فرض)، :const:`SUNDAY` برابر ``6`` است."

msgid "A :class:`Calendar` object provides several methods that can be used for preparing the calendar data for formatting. This class doesn't do any formatting itself. This is the job of subclasses."
msgstr "یک شیء :class:`Calendar` چندین متد ارائه می‌دهد که می‌توان از آن‌ها برای آماده‌سازی داده‌های گاه‌شماری برای قالب‌بندی استفاده کرد. این کلاس به‌خودی‌خود هیچ قالب‌بندی‌ای انجام نمی‌دهد. این وظیفه‌ی زیرکلاس‌ها است."

msgid ":class:`Calendar` instances have the following methods and attributes:"
msgstr "نمونه‌های :class:`Calendar` دارای متدها و ویژگی‌های زیر هستند:"

msgid "The first weekday as an integer (0--6)."
msgstr "نخستین روز هفته به‌صورت عدد صحیح (۰--۶)."

msgid "This property can also be set and read using :meth:`~Calendar.setfirstweekday` and :meth:`~Calendar.getfirstweekday` respectively."
msgstr "این ویژگی را همچنین می‌توان به‌ترتیب با :meth:`~Calendar.setfirstweekday` و :meth:`~Calendar.getfirstweekday` تنظیم و خواند."

msgid "Return an :class:`int` for the current first weekday (0--6)."
msgstr "یک :class:`int` برای اولین روز هفته‌ی کنونی (0--6) برمی‌گرداند."

msgid "Identical to reading the :attr:`~Calendar.firstweekday` property."
msgstr "معادل خواندن ویژگی :attr:`~Calendar.firstweekday` است."

msgid "Set the first weekday to *firstweekday*, passed as an :class:`int` (0--6)."
msgstr "اولین روز هفته را روی *firstweekday*، که به‌صورت یک :class:`int` (۰--۶) ارسال می‌شود، تنظیم می‌کند."

msgid "Identical to setting the :attr:`~Calendar.firstweekday` property."
msgstr "دقیقاً معادل تنظیم ویژگی :attr:`~Calendar.firstweekday` است."

msgid "Return an iterator for the weekday numbers that will be used for one week.  The first value from the iterator will be the same as the value of the :attr:`~Calendar.firstweekday` property."
msgstr "یک پیمایش‌گر برای شماره‌های روز هفته که برای یک هفته استفاده خواهد شد، برمی‌گرداند. اولین مقدار این پیمایش‌گر با مقدار ویژگی :attr:`~Calendar.firstweekday` یکسان خواهد بود."

msgid "Return an iterator for the month *month* (1--12) in the year *year*. This iterator will return all days (as :class:`datetime.date` objects) for the month and all days before the start of the month or after the end of the month that are required to get a complete week."
msgstr "یک پیمایش‌گر برای ماه *month* (۱ تا ۱۲) در سال *year* برمی‌گرداند. این پیمایش‌گر تمام روزهای ماه (به‌صورت اشیای :class:`datetime.date`) و تمام روزهای پیش از شروع ماه یا پس از پایان ماه را که برای داشتن یک هفته کامل لازم هستند برمی‌گرداند."

msgid "Return an iterator for the month *month* in the year *year* similar to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` range. Days returned will simply be day of the month numbers.  For the days outside of the specified month, the day number is ``0``."
msgstr "یک پیمایش‌گر برای ماه *month* در سال *year* برمی‌گرداند، مشابه :meth:`itermonthdates`، اما به بازه‌ی :class:`datetime.date` محدود نیست. روزهای برگردانده‌شده صرفاً شماره‌های روز ماه خواهند بود. برای روزهای خارج از ماه مشخص‌شده، شماره‌ی روز ``0`` است."

msgid "Return an iterator for the month *month* in the year *year* similar to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` range. Days returned will be tuples consisting of a day of the month number and a weekday number."
msgstr "یک پیمایش‌گر مشابه :meth:`itermonthdates` برای ماه *month* در سال *year* برمی‌گرداند، اما محدود به محدوده‌ی :class:`datetime.date` نیست. روزهای برگردانده‌شده تاپل‌هایی شامل شماره‌ی روز ماه و شماره‌ی روز هفته خواهند بود."

msgid "Return an iterator for the month *month* in the year *year* similar to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` range. Days returned will be tuples consisting of a year, a month and a day of the month numbers."
msgstr "یک پیمایش‌گر برای ماه *month* در سال *year* برمی‌گرداند، مشابه :meth:`itermonthdates`، اما به بازه‌ی :class:`datetime.date` محدود نیست. روزهای برگردانده‌شده تاپل‌هایی شامل شماره‌ی سال، شماره‌ی ماه و شماره‌ی روز ماه خواهند بود."

msgid "Return an iterator for the month *month* in the year *year* similar to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` range. Days returned will be tuples consisting of a year, a month, a day of the month, and a day of the week numbers."
msgstr "یک پیمایش‌گر برای ماه *month* در سال *year* مشابه :meth:`itermonthdates` برمی‌گرداند، اما به محدوده‌ی :class:`datetime.date` محدود نیست. روزهای برگردانده‌شده تاپل‌هایی شامل شماره‌های سال، ماه، روز ماه و روز هفته خواهند بود."

msgid "Return a list of the weeks in the month *month* of the *year* as full weeks.  Weeks are lists of seven :class:`datetime.date` objects."
msgstr "فهرستی از هفته‌های ماه *month* از سال *year* را به‌صورت هفته‌های کامل برمی‌گرداند. هفته‌ها فهرست‌هایی از هفت شیء :class:`datetime.date` هستند."

msgid "Return a list of the weeks in the month *month* of the *year* as full weeks.  Weeks are lists of seven tuples of day numbers and weekday numbers."
msgstr "فهرستی از هفته‌های ماه *month* از سال *year* را به‌صورت هفته‌های کامل برمی‌گرداند. هفته‌ها فهرست‌هایی از هفت تاپل از شماره‌های روز و شماره‌های روز هفته هستند."

msgid "Return a list of the weeks in the month *month* of the *year* as full weeks.  Weeks are lists of seven day numbers."
msgstr "فهرستی از هفته‌های ماه *month* از سال *year* را به‌صورت هفته‌های کامل برمی‌گرداند. هفته‌ها فهرست‌هایی از هفت شماره‌ی روز هستند."

msgid "Return the data for the specified year ready for formatting. The return value is a list of month rows. Each month row contains up to *width* months (defaulting to 3). Each month contains between 4 and 6 weeks and each week contains 1--7 days. Days are :class:`datetime.date` objects."
msgstr "داده‌های سال مشخص‌شده را به‌صورت آماده برای قالب‌بندی برمی‌گرداند. مقدار بازگشتی، فهرستی از ردیف‌های ماه است. هر ردیف ماه شامل حداکثر *width* ماه است (پیش‌فرض ۳). هر ماه شامل بین ۴ تا ۶ هفته است و هر هفته شامل ۱ تا ۷ روز است. روزها اشیای :class:`datetime.date` هستند."

msgid "Return the data for the specified year ready for formatting (similar to :meth:`yeardatescalendar`). Entries in the week lists are tuples of day numbers and weekday numbers. Day numbers outside this month are zero."
msgstr "داده‌های سال مشخص‌شده را که برای قالب‌بندی آماده است برمی‌گرداند (مشابه :meth:`yeardatescalendar`). ورودی‌های فهرست‌های هفته، تاپل‌هایی از شماره‌های روز و شماره‌های روز هفته هستند. شماره‌های روز خارج از این ماه صفر هستند."

msgid "Return the data for the specified year ready for formatting (similar to :meth:`yeardatescalendar`). Entries in the week lists are day numbers. Day numbers outside this month are zero."
msgstr "داده‌های سال مشخص‌شده را به‌صورت آماده برای قالب‌بندی برمی‌گرداند (مشابه :meth:`yeardatescalendar`). ورودی‌های فهرست‌های هفته، شماره‌های روز هستند. شماره‌های روز خارج از این ماه صفر هستند."

msgid "This class can be used to generate plain text calendars."
msgstr "این کلاس می‌تواند برای تولید گاه‌شماری‌های متنی ساده استفاده شود."

msgid ":class:`TextCalendar` instances have the following methods:"
msgstr "نمونه‌های :class:`TextCalendar` متدهای زیر را دارند:"

msgid "Return a string representing a single day formatted with the given *width*. If *theday* is ``0``, return a string of spaces of the specified width, representing an empty day. The *weekday* parameter is unused."
msgstr "رشته‌ای را برمی‌گرداند که نمایانگر یک روز واحد است و با *width* داده‌شده قالب‌بندی شده است. اگر *theday* برابر ``0`` باشد، رشته‌ای از فاصله‌ها با عرض مشخص‌شده برمی‌گرداند که نمایانگر یک روز خالی است. پارامتر *weekday* استفاده نمی‌شود."

msgid "Return a single week in a string with no newline. If *w* is provided, it specifies the width of the date columns, which are centered. Depends on the first weekday as specified in the constructor or set by the :meth:`setfirstweekday` method."
msgstr "یک هفته واحد را به‌صورت یک رشته بدون خط جدید برمی‌گرداند. اگر *w* داده شود، عرض ستون‌های تاریخ را مشخص می‌کند؛ این ستون‌ها وسط‌چین هستند. به اولین روز هفته بستگی دارد، همان‌گونه که در سازنده تعیین‌شده است یا با متد :meth:`setfirstweekday` تنظیم‌شده است."

msgid "Return a string representing the name of a single weekday formatted to the specified *width*. The *weekday* parameter is an integer representing the day of the week, where ``0`` is Monday and ``6`` is Sunday."
msgstr "رشته‌ای را برمی‌گرداند که نشان‌دهنده نام یک روز هفته است و با عرض مشخص‌شده *width* قالب‌بندی‌شده است. پارامتر *weekday* یک عدد صحیح است که روز هفته را نشان می‌دهد، به‌طوری‌که ``0`` دوشنبه و ``6`` یکشنبه است."

msgid "Return a string containing the header row of weekday names, formatted with the given *width* for each column. The names depend on the locale settings and are padded to the specified width."
msgstr "رشته‌ای حاوی ردیف سرآیند نام روزهای هفته را برمی‌گرداند که با *width* داده‌شده برای هر ستون قالب‌بندی شده است. این نام‌ها به تنظیمات locale بستگی دارند و تا عرض مشخص‌شده پر می‌شوند."

msgid "Return a month's calendar in a multi-line string. If *w* is provided, it specifies the width of the date columns, which are centered. If *l* is given, it specifies the number of lines that each week will use. Depends on the first weekday as specified in the constructor or set by the :meth:`setfirstweekday` method."
msgstr "گاه‌شماری یک ماه را در یک رشته چندخطی برمی‌گرداند. اگر *w* ارائه شود، عرض ستون‌های تاریخ را مشخص می‌کند؛ این ستون‌ها وسط‌چین هستند. اگر *l* داده شود، تعداد سطرهایی را که هر هفته استفاده خواهد کرد مشخص می‌کند. به اولین روز هفته بستگی دارد، همان‌طور که در سازنده مشخص شده یا توسط متد :meth:`setfirstweekday` تنظیم می‌شود."

msgid "Return a string representing the month's name centered within the specified *width*. If *withyear* is ``True``, include the year in the output. The *theyear* and *themonth* parameters specify the year and month for the name to be formatted respectively."
msgstr "رشته‌ای برمی‌گرداند که نام ماه را به‌صورت وسط‌چین در عرض مشخص‌شده با *width* نشان می‌دهد. اگر *withyear* برابر ``True`` باشد، سال در خروجی گنجانده می‌شود. پارامترهای *theyear* و *themonth* به‌ترتیب سال و ماهِ نامی را که باید قالب‌بندی شود مشخص می‌کنند."

msgid "Print a month's calendar as returned by :meth:`formatmonth`."
msgstr "گاه‌شماری یک ماه را همان‌طور که توسط :meth:`formatmonth` برگردانده می‌شود، چاپ کنید."

msgid "Return a *m*-column calendar for an entire year as a multi-line string. Optional parameters *w*, *l*, and *c* are for date column width, lines per week, and number of spaces between month columns, respectively. Depends on the first weekday as specified in the constructor or set by the :meth:`setfirstweekday` method.  The earliest year for which a calendar can be generated is platform-dependent."
msgstr "گاه‌شماریی با *m* ستون برای یک سال کامل را به‌عنوان یک رشته‌ی چندخطی برمی‌گرداند. پارامترهای اختیاری *w*، *l* و *c* به‌ترتیب برای عرض ستون تاریخ، تعداد سطرهای هر هفته و تعداد فاصله‌های بین ستون‌های ماه هستند. به اولین روز هفته بستگی دارد، همان‌طور که در سازنده مشخص شده یا با متد :meth:`setfirstweekday` تنظیم شده است. اولین سالی که می‌توان برای آن گاه‌شماری تولید کرد، وابسته به پلتفرم است."

msgid "Print the calendar for an entire year as returned by :meth:`formatyear`."
msgstr "گاه‌شماری یک سال کامل را همان‌طور که توسط :meth:`formatyear` برگردانده می‌شود، چاپ کنید."

msgid "This class can be used to generate HTML calendars."
msgstr "این کلاس می‌تواند برای تولید گاه‌شماری‌های HTML استفاده شود."

msgid ":class:`!HTMLCalendar` instances have the following methods:"
msgstr "نمونه‌های :class:`!HTMLCalendar` متدهای زیر را دارند:"

msgid "Return a month's calendar as an HTML table. If *withyear* is true the year will be included in the header, otherwise just the month name will be used."
msgstr "گاه‌شماری یک ماه را به‌صورت یک جدول HTML برمی‌گرداند. اگر *withyear* درست باشد، سال در سرآیند گنجانده می‌شود؛ در غیر این صورت، فقط از نام ماه استفاده می‌شود."

msgid "Return a year's calendar as an HTML table. *width* (defaulting to 3) specifies the number of months per row."
msgstr "گاه‌شماری یک سال را به‌صورت یک جدول HTML برمی‌گرداند. *width* (با پیش‌فرض ۳) تعداد ماه‌ها در هر ردیف را مشخص می‌کند."

msgid "Return a year's calendar as a complete HTML page. *width* (defaulting to 3) specifies the number of months per row. *css* is the name for the cascading style sheet to be used. :const:`None` can be passed if no style sheet should be used. *encoding* specifies the encoding to be used for the output (defaulting to the system default encoding)."
msgstr "گاه‌شماری یک سال را به‌عنوان یک صفحه HTML کامل بازمی‌گرداند. *width* (که پیش‌فرض آن ۳ است) تعداد ماه‌ها در هر ردیف را مشخص می‌کند. *css* نام شیوه‌نامه آبشاری مورد استفاده است. اگر نباید از شیوه‌نامه استفاده شود، می‌توان :const:`None` را ارسال کرد. *encoding* کدگذاری مورد استفاده برای خروجی را مشخص می‌کند (که پیش‌فرض آن کدگذاری پیش‌فرض سیستم است)."

msgid "Return a month name as an HTML table row. If *withyear* is true the year will be included in the row, otherwise just the month name will be used."
msgstr "نام یک ماه را به‌عنوان یک ردیف جدول HTML برمی‌گرداند. اگر *withyear* درست باشد، سال در ردیف گنجانده خواهد شد، در غیر این صورت فقط از نام ماه استفاده خواهد شد."

msgid ":class:`!HTMLCalendar` has the following attributes you can override to customize the CSS classes used by the calendar:"
msgstr ":class:`!HTMLCalendar` دارای ویژگی‌های زیر است که می‌توانید آن‌ها را بازنویسی کنید تا کلاس‌های CSS استفاده‌شده توسط گاه‌شماری را سفارشی‌سازی کنید:"

msgid "A list of CSS classes used for each weekday. The default class list is::"
msgstr "فهرستی از کلاس‌های CSS که برای هر روز هفته استفاده می‌شوند. فهرست پیش‌فرض کلاس‌ها به صورت زیر است::"

msgid "cssclasses = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"]"
msgstr "cssclasses = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"]"

msgid "more styles can be added for each day::"
msgstr "می‌توان سبک‌های بیشتری را برای هر روز اضافه کرد::"

msgid "cssclasses = [\"mon text-bold\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun red\"]"
msgstr "cssclasses = [\"mon text-bold\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun red\"]"

msgid "Note that the length of this list must be seven items."
msgstr "توجه داشته باشید که طول این فهرست باید ۷ آیتم باشد."

msgid "The CSS class for a weekday occurring in the previous or coming month."
msgstr "کلاس CSS برای روز هفته‌ای که در ماه گذشته یا آینده قرار دارد."

msgid "A list of CSS classes used for weekday names in the header row. The default is the same as :attr:`cssclasses`."
msgstr "فهرستی از کلاس‌های CSS که برای نام روزهای هفته در ردیف سرآیند استفاده می‌شوند. مقدار پیش‌فرض همان :attr:`cssclasses` است."

msgid "The month's head CSS class (used by :meth:`formatmonthname`). The default value is ``\"month\"``."
msgstr "کلاس CSS سرآیند‌ی ماه (که توسط :meth:`formatmonthname` استفاده می‌شود). مقدار پیش‌فرض ``\"month\"`` است."

msgid "The CSS class for the whole month's table (used by :meth:`formatmonth`). The default value is ``\"month\"``."
msgstr "کلاس CSS برای جدول کل ماه (که توسط :meth:`formatmonth` استفاده می‌شود). مقدار پیش‌فرض ``\"month\"`` است."

msgid "The CSS class for the whole year's table of tables (used by :meth:`formatyear`). The default value is ``\"year\"``."
msgstr "کلاس CSS برای جدولِ جدول‌های کل سال (که توسط :meth:`formatyear` استفاده می‌شود). مقدار پیش‌فرض ``\"year\"`` است."

msgid "The CSS class for the table head for the whole year (used by :meth:`formatyear`). The default value is ``\"year\"``."
msgstr "کلاس CSS برای سرآیند جدولِ کل سال (که توسط :meth:`formatyear` استفاده می‌شود). مقدار پیش‌فرض ``\"year\"`` است."

msgid "Note that although the naming for the above described class attributes is singular (e.g. ``cssclass_month`` ``cssclass_noday``), one can replace the single CSS class with a space separated list of CSS classes, for example::"
msgstr "توجه داشته باشید که اگرچه نام‌گذاری ویژگی‌های کلاس توصیف‌شده در بالا به‌صورت مفرد است (مثلاً ``cssclass_month`` ``cssclass_noday``)، می‌توانید کلاس CSS تکی را با فهرستی از کلاس‌های CSS جداشده با فاصله جایگزین کنید، برای مثال::"

msgid "\"text-bold text-red\""
msgstr "text-bold text-red"

msgid "Here is an example how :class:`!HTMLCalendar` can be customized::"
msgstr "در اینجا مثالی از نحوه‌ی سفارشی‌سازی :class:`!HTMLCalendar` آمده است::"

msgid ""
"class CustomHTMLCal(calendar.HTMLCalendar):\n"
"    cssclasses = [style + \" text-nowrap\" for style in\n"
"                  calendar.HTMLCalendar.cssclasses]\n"
"    cssclass_month_head = \"text-center month-head\"\n"
"    cssclass_month = \"text-center month\"\n"
"    cssclass_year = \"text-italic lead\""
msgstr ""
"class CustomHTMLCal(calendar.HTMLCalendar):\n"
"    cssclasses = [style + \" text-nowrap\" for style in\n"
"                  calendar.HTMLCalendar.cssclasses]\n"
"    cssclass_month_head = \"text-center month-head\"\n"
"    cssclass_month = \"text-center month\"\n"
"    cssclass_year = \"text-italic lead\""

msgid "This subclass of :class:`TextCalendar` can be passed a locale name in the constructor and will return month and weekday names in the specified locale."
msgstr "این زیرکلاس از :class:`TextCalendar` می‌تواند یک نام locale را در سازنده دریافت کند و نام ماه‌ها و روزهای هفته را در locale مشخص‌شده برمی‌گرداند."

msgid "This subclass of :class:`HTMLCalendar` can be passed a locale name in the constructor and will return month and weekday names in the specified locale."
msgstr "این زیرکلاسِ :class:`HTMLCalendar` می‌تواند در سازنده یک نام locale  را بپذیرد و نام ماه‌ها و روزهای هفته را در locale مشخص‌شده برگرداند."

msgid "The constructor, :meth:`!formatweekday` and :meth:`!formatmonthname` methods of these two classes temporarily change the ``LC_TIME`` locale to the given *locale*. Because the current locale is a process-wide setting, they are not thread-safe."
msgstr "سازنده و متدهای :meth:`!formatweekday` و :meth:`!formatmonthname` این دو کلاس، تنظیم locale (locale) مربوط به ``LC_TIME`` را به‌طور موقت به *locale* داده‌شده تغییر می‌دهند. از آن‌جا که تنظیم locale فعلی یک تنظیم در سطح کل فرایند است، آن‌ها نخ‌ایمن نیستند."

msgid "For simple text calendars this module provides the following functions."
msgstr "برای گاه‌شماری‌های متنی ساده، این ماژول توابع زیر را فراهم می‌کند."

msgid "Sets the weekday (``0`` is Monday, ``6`` is Sunday) to start each week. The values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:`THURSDAY`, :const:`FRIDAY`, :const:`SATURDAY`, and :const:`SUNDAY` are provided for convenience. For example, to set the first weekday to Sunday::"
msgstr "روز هفته را برای آغاز هر هفته تنظیم می‌کند (``0`` دوشنبه است، ``6`` یکشنبه است). مقادیر :const:`MONDAY`، :const:`TUESDAY`، :const:`WEDNESDAY`، :const:`THURSDAY`، :const:`FRIDAY`، :const:`SATURDAY` و :const:`SUNDAY` برای سهولت ارائه شده‌اند. برای مثال، برای تنظیم اولین روز هفته به یکشنبه::"

msgid ""
"import calendar\n"
"calendar.setfirstweekday(calendar.SUNDAY)"
msgstr ""
"import calendar\n"
"calendar.setfirstweekday(calendar.SUNDAY)"

msgid "Returns the current setting for the weekday to start each week."
msgstr "تنظیم فعلی برای روز هفته‌ای که هر هفته با آن آغاز می‌شود را برمی‌گرداند."

msgid "Returns :const:`True` if *year* is a leap year, otherwise :const:`False`."
msgstr "اگر *year* یک سال کبیسه باشد، :const:`True` را برمی‌گرداند، در غیر این صورت :const:`False` را برمی‌گرداند."

msgid "Returns the number of leap years in the range from *y1* to *y2* (exclusive), where *y1* and *y2* are years."
msgstr "تعداد سال‌های کبیسه در بازه‌ای از *y1* تا *y2* (غیرشامل) را برمی‌گرداند، که در آن *y1* و *y2* سال هستند."

msgid "This function works for ranges spanning a century change."
msgstr "این تابع برای بازه‌هایی که تغییر قرن را دربرمی‌گیرند، کار می‌کند."

msgid "Returns the day of the week (``0`` is Monday) for *year* (``1970``--...), *month* (``1``--``12``), *day* (``1``--``31``)."
msgstr "روز هفته (``0`` دوشنبه است) را برای *year* (``1970``--...)، *month* (``1``--``12``)، *day* (``1``--``31``) برمی‌گرداند."

msgid "Return a header containing abbreviated weekday names. *width* specifies the width in characters for one weekday."
msgstr "یک سرآیند شامل نام‌های کوتاه‌شده روزهای هفته برمی‌گرداند. *width* عرض یک روز هفته را بر حسب تعداد نویسه‌ها مشخص می‌کند."

msgid "Returns weekday of first day of the month and number of days in month, for the specified *year* and *month*."
msgstr "روز هفته‌ی اولین روز ماه و تعداد روزهای ماه را برای *year* و *month* مشخص‌شده برمی‌گرداند."

msgid "Returns a matrix representing a month's calendar.  Each row represents a week; days outside of the month are represented by zeros. Each week begins with Monday unless set by :func:`setfirstweekday`."
msgstr "ماتریسی را برمی‌گرداند که گاه‌شماری یک ماه را نشان می‌دهد. هر ردیف نشان‌دهنده یک هفته است؛ روزهای خارج از ماه با صفر نشان داده می‌شوند. هر هفته با دوشنبه آغاز می‌شود، مگر آنکه توسط :func:`setfirstweekday` تنظیم شده باشد."

msgid "Prints a month's calendar as returned by :func:`month`."
msgstr "گاه‌شماری یک ماه را همان‌طور که توسط :func:`month` برگردانده می‌شود، چاپ می‌کند."

msgid "Returns a month's calendar in a multi-line string using the :meth:`~TextCalendar.formatmonth` of the :class:`TextCalendar` class."
msgstr "گاه‌شماری یک ماه را به‌صورت یک رشته‌ی چندخطی با استفاده از :meth:`~TextCalendar.formatmonth` از کلاس :class:`TextCalendar` برمی‌گرداند."

msgid "Prints the calendar for an entire year as returned by  :func:`calendar`."
msgstr "گاه‌شماری یک سال کامل را به‌همان‌صورتی که :func:`calendar` برمی‌گرداند، چاپ می‌کند."

msgid "Returns a 3-column calendar for an entire year as a multi-line string using the :meth:`~TextCalendar.formatyear` of the :class:`TextCalendar` class."
msgstr "یک گاه‌شماری سه‌ستونه برای کل سال را به‌عنوان یک رشته چندخطی با استفاده از :meth:`~TextCalendar.formatyear` از کلاس :class:`TextCalendar` برمی‌گرداند."

msgid "An unrelated but handy function that takes a time tuple such as returned by the :func:`~time.gmtime` function in the :mod:`time` module, and returns the corresponding Unix timestamp value, assuming an epoch of 1970, and the POSIX encoding.  In fact, :func:`time.gmtime` and :func:`timegm` are each other's inverse."
msgstr "تابعی نامرتبط اما کاربردی که یک تاپل زمانی مانند آنچه توسط تابع :func:`~time.gmtime` در ماژول :mod:`time` برگردانده می‌شود را دریافت می‌کند و مقدار برچسب زمانی یونیکس متناظر را، با فرض مبدأ زمانی سال ۱۹۷۰ و کدگذاری POSIX، برمی‌گرداند. در واقع، :func:`time.gmtime` و :func:`timegm` معکوس یکدیگرند."

msgid "The :mod:`!calendar` module exports the following data attributes:"
msgstr "ماژول :mod:`!calendar` ویژگی‌های داده زیر را اکسپورت می‌کند:"

msgid "A sequence that represents the days of the week in the current locale, where Monday is day number 0."
msgstr "دنباله‌ای که روزهای هفته را در locale نشان می‌دهد، به‌طوری که دوشنبه روز شماره ۰ است."

msgid "A sequence that represents the abbreviated days of the week in the current locale, where Mon is day number 0."
msgstr "دنباله‌ای که روزهای هفته را به‌صورت مخفف در locale فعلی نشان می‌دهد، که در آن Mon روز شماره ۰ است."

msgid "Aliases for the days of the week, where ``MONDAY`` is ``0`` and ``SUNDAY`` is ``6``."
msgstr "نام‌های مستعار روزهای هفته، که در آن‌ها ``MONDAY`` برابر با ``0`` و ``SUNDAY`` برابر با ``6`` است."

msgid "Enumeration defining days of the week as integer constants. The members of this enumeration are exported to the module scope as :data:`MONDAY` through :data:`SUNDAY`."
msgstr "شمارشی که روزهای هفته را به‌عنوان ثابت‌های عدد صحیح تعریف می‌کند. اعضای این شمارش به محدوده ماژول اکسپورت می‌شوند، به‌صورت :data:`MONDAY` تا :data:`SUNDAY`."

msgid "A sequence that represents the months of the year in the current locale.  This follows normal convention of January being month number 1, so it has a length of 13 and ``month_name[0]`` is the empty string."
msgstr "یک دنباله که ماه‌های سال را در locale فعلی نشان می‌دهد. این دنباله از قرارداد معمول پیروی می‌کند که بر اساس آن ژانویه ماه شماره‌ی ۱ است، بنابراین طول آن ۱۳ است و ``month_name[0]`` رشته‌ی خالی است."

msgid "A sequence that represents the abbreviated months of the year in the current locale.  This follows normal convention of January being month number 1, so it has a length of 13 and  ``month_abbr[0]`` is the empty string."
msgstr "دنباله‌ای که نام‌های مخفف ماه‌های سال را در locale فعلی نشان می‌دهد. این از قرارداد معمول پیروی می‌کند که ژانویه ماه شماره‌ی ۱ است، بنابراین طول آن ۱۳ است و ``month_abbr[0]`` رشته‌ی خالی است."

msgid "Aliases for the months of the year, where ``JANUARY`` is ``1`` and ``DECEMBER`` is ``12``."
msgstr "نام‌های مستعار برای ماه‌های سال، که در آن‌ها ``JANUARY`` برابر ``1`` و ``DECEMBER`` برابر ``12`` است."

msgid "Enumeration defining months of the year as integer constants. The members of this enumeration are exported to the module scope as :data:`JANUARY` through :data:`DECEMBER`."
msgstr "شمارشی که ماه‌های سال را به‌عنوان ثابت‌های عدد صحیح تعریف می‌کند. اعضای این شمارش با نام‌های :data:`JANUARY` تا :data:`DECEMBER` به محدوده ماژول اکسپورت شده‌اند."

msgid "The :mod:`!calendar` module defines the following exceptions:"
msgstr "ماژول :mod:`!calendar` استثناهای زیر را تعریف می‌کند:"

msgid "A subclass of :exc:`ValueError` and :exc:`IndexError`, raised when the given month number is outside of the range 1-12 (inclusive)."
msgstr "زیرکلاسی از :exc:`ValueError` و :exc:`IndexError`، زمانی پرتاب می‌شود که شماره ماه داده‌شده خارج از بازه‌ی ۱ تا ۱۲ (شامل هر دو) باشد."

msgid ":exc:`IllegalMonthError` is now also a subclass of :exc:`ValueError`. New code should avoid catching :exc:`IndexError`."
msgstr ":exc:`IllegalMonthError` اکنون نیز یک زیرکلاس از :exc:`ValueError` است. کد جدید باید از گرفتن :exc:`IndexError` خودداری کند."

msgid "The invalid month number."
msgstr "شماره‌ی ماه نامعتبر."

msgid "A subclass of :exc:`ValueError`, raised when the given weekday number is outside of the range 0-6 (inclusive)."
msgstr "زیرکلاسی از :exc:`ValueError` که زمانی پرتاب می‌شود که شماره‌ی روز هفته‌ی داده‌شده خارج از بازه‌ی ۰ تا ۶ (شامل هر دو) باشد."

msgid "The invalid weekday number."
msgstr "شماره‌ی نامعتبر روز هفته."

msgid "Module :mod:`datetime`"
msgstr "ماژول :mod:`datetime`"

msgid "Object-oriented interface to dates and times with similar functionality to the :mod:`time` module."
msgstr "رابط شیءگرا برای تاریخ‌ها و زمان‌ها با عملکردی مشابه ماژول :mod:`time`."

msgid "Module :mod:`time`"
msgstr "ماژول :mod:`time`"

msgid "Low-level time related functions."
msgstr "توابع سطح پایین مرتبط با زمان."

msgid "Command-line usage"
msgstr "استفاده از خط فرمان"

msgid "The :mod:`!calendar` module can be executed as a script from the command line to interactively print a calendar."
msgstr "ماژول :mod:`!calendar` را می‌توان به‌عنوان یک اسکریپت از خط فرمان اجرا کرد تا یک گاه‌شماری به‌صورت تعاملی چاپ شود."

msgid ""
"python -m calendar [-h] [-L LOCALE] [-e ENCODING] [-t {text,html}]\n"
"                   [-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS] [-c CSS]\n"
"                   [-f FIRST_WEEKDAY] [year] [month]"
msgstr ""
"python -m calendar [-h] [-L LOCALE] [-e ENCODING] [-t {text,html}]\n"
"                   [-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS] [-c CSS]\n"
"                   [-f FIRST_WEEKDAY] [year] [month]"

msgid "For example, to print a calendar for the year 2000:"
msgstr "برای مثال، برای چاپ گاه‌شماری سال ۲۰۰۰:"

msgid ""
"$ python -m calendar 2000\n"
"                                  2000\n"
"\n"
"      January                   February                   March\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2          1  2  3  4  5  6             1  2  3  4  5\n"
" 3  4  5  6  7  8  9       7  8  9 10 11 12 13       6  7  8  9 10 11 12\n"
"10 11 12 13 14 15 16      14 15 16 17 18 19 20      13 14 15 16 17 18 19\n"
"17 18 19 20 21 22 23      21 22 23 24 25 26 27      20 21 22 23 24 25 26\n"
"24 25 26 27 28 29 30      28 29                     27 28 29 30 31\n"
"31\n"
"\n"
"       April                      May                       June\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2       1  2  3  4  5  6  7                1  2  3  4\n"
" 3  4  5  6  7  8  9       8  9 10 11 12 13 14       5  6  7  8  9 10 11\n"
"10 11 12 13 14 15 16      15 16 17 18 19 20 21      12 13 14 15 16 17 18\n"
"17 18 19 20 21 22 23      22 23 24 25 26 27 28      19 20 21 22 23 24 25\n"
"24 25 26 27 28 29 30      29 30 31                  26 27 28 29 30\n"
"\n"
"        July                     August                  September\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2          1  2  3  4  5  6                   1  2  3\n"
" 3  4  5  6  7  8  9       7  8  9 10 11 12 13       4  5  6  7  8  9 10\n"
"10 11 12 13 14 15 16      14 15 16 17 18 19 20      11 12 13 14 15 16 17\n"
"17 18 19 20 21 22 23      21 22 23 24 25 26 27      18 19 20 21 22 23 24\n"
"24 25 26 27 28 29 30      28 29 30 31               25 26 27 28 29 30\n"
"31\n"
"\n"
"      October                   November                  December\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                   1             1  2  3  4  5                   1  2  3\n"
" 2  3  4  5  6  7  8       6  7  8  9 10 11 12       4  5  6  7  8  9 10\n"
" 9 10 11 12 13 14 15      13 14 15 16 17 18 19      11 12 13 14 15 16 17\n"
"16 17 18 19 20 21 22      20 21 22 23 24 25 26      18 19 20 21 22 23 24\n"
"23 24 25 26 27 28 29      27 28 29 30               25 26 27 28 29 30 31\n"
"30 31"
msgstr ""
"$ python -m calendar 2000\n"
"                                  2000\n"
"\n"
"      January                   February                   March\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2          1  2  3  4  5  6             1  2  3  4  5\n"
" 3  4  5  6  7  8  9       7  8  9 10 11 12 13       6  7  8  9 10 11 12\n"
"10 11 12 13 14 15 16      14 15 16 17 18 19 20      13 14 15 16 17 18 19\n"
"17 18 19 20 21 22 23      21 22 23 24 25 26 27      20 21 22 23 24 25 26\n"
"24 25 26 27 28 29 30      28 29                     27 28 29 30 31\n"
"31\n"
"\n"
"       April                      May                       June\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2       1  2  3  4  5  6  7                1  2  3  4\n"
" 3  4  5  6  7  8  9       8  9 10 11 12 13 14       5  6  7  8  9 10 11\n"
"10 11 12 13 14 15 16      15 16 17 18 19 20 21      12 13 14 15 16 17 18\n"
"17 18 19 20 21 22 23      22 23 24 25 26 27 28      19 20 21 22 23 24 25\n"
"24 25 26 27 28 29 30      29 30 31                  26 27 28 29 30\n"
"\n"
"        July                     August                  September\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                1  2          1  2  3  4  5  6                   1  2  3\n"
" 3  4  5  6  7  8  9       7  8  9 10 11 12 13       4  5  6  7  8  9 10\n"
"10 11 12 13 14 15 16      14 15 16 17 18 19 20      11 12 13 14 15 16 17\n"
"17 18 19 20 21 22 23      21 22 23 24 25 26 27      18 19 20 21 22 23 24\n"
"24 25 26 27 28 29 30      28 29 30 31               25 26 27 28 29 30\n"
"31\n"
"\n"
"      October                   November                  December\n"
"Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n"
"                   1             1  2  3  4  5                   1  2  3\n"
" 2  3  4  5  6  7  8       6  7  8  9 10 11 12       4  5  6  7  8  9 10\n"
" 9 10 11 12 13 14 15      13 14 15 16 17 18 19      11 12 13 14 15 16 17\n"
"16 17 18 19 20 21 22      20 21 22 23 24 25 26      18 19 20 21 22 23 24\n"
"23 24 25 26 27 28 29      27 28 29 30               25 26 27 28 29 30 31\n"
"30 31"

msgid "The following options are accepted:"
msgstr "گزینه‌های زیر پذیرفته می‌شوند:"

msgid "Show the help message and exit."
msgstr "پیام راهنما را نمایش می‌دهد و خارج می‌شود."

msgid "The locale to use for month and weekday names. Defaults to English."
msgstr "locale مورد استفاده برای نام ماه‌ها و روزهای هفته. پیش‌فرض آن انگلیسی است."

msgid "The encoding to use for output. :option:`--encoding` is required if :option:`--locale` is set."
msgstr "کدگذاری مورد استفاده برای خروجی. اگر :option:`--locale` تنظیم شده باشد، :option:`--encoding` الزامی است."

msgid "Print the calendar to the terminal as text, or as an HTML document."
msgstr "گاه‌شماری را به‌صورت متن یا به‌عنوان یک سند HTML در پایانه چاپ کنید."

msgid "The weekday to start each week. Must be a number between 0 (Monday) and 6 (Sunday). Defaults to 0."
msgstr "روز هفته برای شروع هر هفته. باید عددی بین ۰ (دوشنبه) و ۶ (یکشنبه) باشد. پیش‌فرض ۰ است."

msgid "The year to print the calendar for. Defaults to the current year."
msgstr "سالی که گاه‌شماری برای آن چاپ می‌شود. پیش‌فرض آن سال جاری است."

msgid "The month of the specified :option:`year` to print the calendar for. Must be a number between 1 and 12, and may only be used in text mode. Defaults to printing a calendar for the full year."
msgstr "ماه از :option:`year` مشخص‌شده برای چاپ گاه‌شماری. باید عددی بین ۱ تا ۱۲ باشد و فقط می‌تواند در حالت متنی استفاده شود. به‌طور پیش‌فرض، گاه‌شماریی برای تمام سال چاپ می‌شود."

msgid "*Text-mode options:*"
msgstr "*گزینه‌های حالت متنی:*"

msgid "The width of the date column in terminal columns. The date is printed centred in the column. Any value lower than 2 is ignored. Defaults to 2."
msgstr "عرض ستون تاریخ بر حسب ستون‌های پایانه. تاریخ به‌صورت وسط‌چین در ستون چاپ می‌شود. هر مقدار کمتر از ۲ نادیده گرفته می‌شود. مقدار پیش‌فرض ۲ است."

msgid "The number of lines for each week in terminal rows. The date is printed top-aligned. Any value lower than 1 is ignored. Defaults to 1."
msgstr "تعداد سطرهای هر هفته در ردیف‌های پایانه. تاریخ با تراز از بالا چاپ می‌شود. هر مقداری کمتر از ۱ باشد نادیده گرفته می‌شود. مقدار پیش‌فرض ۱ است."

msgid "The space between months in columns. Any value lower than 2 is ignored. Defaults to 6."
msgstr "فاصله‌ی میان ماه‌ها در ستون‌ها. هر مقداری کمتر از ۲ باشد، در نظر گرفته نمی‌شود. مقدار پیش‌فرض آن ۶ است."

msgid "The number of months printed per row. Defaults to 3."
msgstr "تعداد ماه‌های چاپ‌شده در هر ردیف. مقدار پیش‌فرض ۳ است."

msgid "By default, today's date is highlighted in color and can be :ref:`controlled using environment variables <using-on-controlling-color>`."
msgstr "به‌طور پیش‌فرض، تاریخ امروز با رنگ برجسته می‌شود و می‌توان آن را :ref:`با استفاده از متغیرهای محیطی کنترل کرد <using-on-controlling-color>`."

msgid "*HTML-mode options:*"
msgstr "*گزینه‌های حالت HTML:*"

msgid "The path of a CSS stylesheet to use for the calendar. This must either be relative to the generated HTML, or an absolute HTTP or ``file:///`` URL."
msgstr "مسیر شیوه‌نامه CSS برای استفاده در گاه‌شماری. این مسیر باید یا نسبت به HTML تولیدشده نسبی باشد، یا یک URL مطلق HTTP یا ``file:///``."