# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: # Rafael Fontenelle , 2025 # Revisto , 2025 # Sepehr Rasouli , 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-15 13:20+0330\n" "Last-Translator: Sepehr Rasouli , 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 "DateTime Objects" msgstr "شیءهای DateTime" msgid "Various date and time objects are supplied by the :mod:`datetime` module. Before using any of these functions, the header file :file:`datetime.h` must be included in your source (note that this is not included by :file:`Python.h`), and the macro :c:macro:`PyDateTime_IMPORT` must be invoked, usually as part of the module initialisation function. The macro puts a pointer to a C structure into a static variable, :c:data:`PyDateTimeAPI`, that is used by the following macros." msgstr "اشیاء مختلف تاریخ و زمان توسط ماژول :mod:`datetime` فراهم می‌شوند. پیش از استفاده از هر یک از این توابع، پرونده‌ی سرآیند :file:`datetime.h` باید در کد منبع شما گنجانده شود (توجه داشته باشید که این پرونده توسط :file:`Python.h` گنجانده نمی‌شود) و ماکروی :c:macro:`PyDateTime_IMPORT` باید فراخوانی شود، که معمولاً به عنوان بخشی از تابع مقداردهی اولیه ماژول انجام می‌شود. این ماکرو یک اشاره‌گر به یک ساختار C را در یک متغیر ایستا، :c:data:`PyDateTimeAPI`، قرار می‌دهد که توسط ماکروهای زیر استفاده می‌شود." msgid "Import the datetime C API." msgstr "ایمپورت کردن C API مربوط به datetime." msgid "On success, populate the :c:var:`PyDateTimeAPI` pointer. On failure, set :c:var:`PyDateTimeAPI` to ``NULL`` and set an exception. The caller must check if an error occurred via :c:func:`PyErr_Occurred`:" msgstr "در صورت موفقیت، اشاره‌گر :c:var:`PyDateTimeAPI` را پر می‌کند. در صورت شکست، :c:var:`PyDateTimeAPI` را برابر ``NULL`` قرار می‌دهد و یک استثنا تنظیم می‌کند. فراخوان‌کننده باید از طریق :c:func:`PyErr_Occurred` بررسی کند که آیا خطایی رخ داده است:" msgid "" "PyDateTime_IMPORT;\n" "if (PyErr_Occurred()) { /* cleanup */ }" msgstr "" "PyDateTime_IMPORT;\n" "if (PyErr_Occurred()) { /* cleanup */ }" msgid "This is not compatible with subinterpreters." msgstr "این با زیرمفسر‌ها سازگار نیست." msgid "Structure containing the fields for the datetime C API." msgstr "ساختار شامل فیلدهای C API مربوط به datetime." msgid "The fields of this structure are private and subject to change." msgstr "فیلد‌های این ساختار خصوصی هستند و ممکن است تغییر کنند." msgid "Do not use this directly; prefer ``PyDateTime_*`` APIs instead." msgstr "از این مستقیماً استفاده نکنید؛ به‌جای آن، API‌های ``PyDateTime_*`` را ترجیح دهید." msgid "Dynamically allocated object containing the datetime C API." msgstr "شیء تخصیص‌یافته به‌صورت پویا که C API مربوط به datetime را در بر می‌گیرد." msgid "This variable is only available once :c:macro:`PyDateTime_IMPORT` succeeds." msgstr "این متغیر تنها پس از موفقیت :c:macro:`PyDateTime_IMPORT` در دسترس است." msgid "This subtype of :c:type:`PyObject` represents a Python date object." msgstr "این زیرنوع از :c:type:`PyObject` یک شیء تاریخ پایتون را نمایندگی می‌کند." msgid "This subtype of :c:type:`PyObject` represents a Python datetime object." msgstr "این زیرنوع از :c:type:`PyObject` نمایانگر یک شیء datetime پایتون است." msgid "This subtype of :c:type:`PyObject` represents a Python time object." msgstr "این زیرنوع از :c:type:`PyObject` نمایانگر یک شیء زمان پایتون است." msgid "This subtype of :c:type:`PyObject` represents the difference between two datetime values." msgstr "این زیرنوع از :c:type:`PyObject` تفاوت میان دو مقدار datetime را نشان می‌دهد." msgid "This instance of :c:type:`PyTypeObject` represents the Python date type; it is the same object as :class:`datetime.date` in the Python layer." msgstr "این نمونه از :c:type:`PyTypeObject` نوع تاریخ پایتون را نمایندگی می‌کند؛ این همان شیء :class:`datetime.date` در لایه‌ی پایتون است." msgid "This instance of :c:type:`PyTypeObject` represents the Python datetime type; it is the same object as :class:`datetime.datetime` in the Python layer." msgstr "این نمونه از :c:type:`PyTypeObject` نمایانگر نوع datetime پایتون است؛ این همان شیء :class:`datetime.datetime` در لایه‌ی پایتون است." msgid "This instance of :c:type:`PyTypeObject` represents the Python time type; it is the same object as :class:`datetime.time` in the Python layer." msgstr "این نمونه از :c:type:`PyTypeObject`، نوع time پایتون را نشان می‌دهد؛ این همان شیء :class:`datetime.time` در لایه پایتون است." msgid "This instance of :c:type:`PyTypeObject` represents the Python type for the difference between two datetime values; it is the same object as :class:`datetime.timedelta` in the Python layer." msgstr "این نمونه از :c:type:`PyTypeObject` نوع پایتونی برای اختلاف بین دو مقدار datetime را نشان می‌دهد؛ این همان شیء :class:`datetime.timedelta` در لایه پایتون است." msgid "This instance of :c:type:`PyTypeObject` represents the Python time zone info type; it is the same object as :class:`datetime.tzinfo` in the Python layer." msgstr "این نمونه از :c:type:`PyTypeObject` نوع اطلاعات منطقه زمانی پایتون را نمایندگی می‌کند؛ این همان شیء :class:`datetime.tzinfo` در لایه پایتون است." msgid "Macro for access to the UTC singleton:" msgstr "ماکرو برای دسترسی به تک‌نمونه‌ی UTC:" msgid "Returns the time zone singleton representing UTC, the same object as :attr:`datetime.timezone.utc`." msgstr "تک‌نمونه‌ی منطقه‌ی زمانی UTC را برمی‌گرداند؛ این همان شیء :attr:`datetime.timezone.utc` است." msgid "Type-check macros:" msgstr "ماکروهای بررسی نوع:" msgid "Return true if *ob* is of type :c:data:`PyDateTime_DateType` or a subtype of :c:data:`!PyDateTime_DateType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DateType` یا زیرنوعی از :c:data:`!PyDateTime_DateType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_DateType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DateType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType` or a subtype of :c:data:`!PyDateTime_DateTimeType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DateTimeType` یا زیرنوعی از :c:data:`!PyDateTime_DateTimeType` باشد، true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه موفق می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DateTimeType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_TimeType` or a subtype of :c:data:`!PyDateTime_TimeType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_TimeType` یا زیرنوعی از :c:data:`!PyDateTime_TimeType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_TimeType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_TimeType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_DeltaType` or a subtype of :c:data:`!PyDateTime_DeltaType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DeltaType` یا زیرنوعی از :c:data:`!PyDateTime_DeltaType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت انجام می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_DeltaType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_DeltaType` باشد، true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType` or a subtype of :c:data:`!PyDateTime_TZInfoType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "اگر *ob* از نوع :c:data:`PyDateTime_TZInfoType` یا زیرنوعی از :c:data:`!PyDateTime_TZInfoType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه با موفقیت اجرا می‌شود." msgid "Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType`. *ob* must not be ``NULL``. This function always succeeds." msgstr "در صورتی که *ob* از نوع :c:data:`PyDateTime_TZInfoType` باشد، مقدار true را برمی‌گرداند. *ob* نباید ``NULL`` باشد. این تابع همیشه موفق می‌شود." msgid "Macros to create objects:" msgstr "ماکروهای ساخت اشیاء:" msgid "Return a :class:`datetime.date` object with the specified year, month and day." msgstr "یک شیء :class:`datetime.date` با سال، ماه و روز مشخص‌شده برمی‌گرداند." msgid "Return a :class:`datetime.datetime` object with the specified year, month, day, hour, minute, second and microsecond." msgstr "یک شیء :class:`datetime.datetime` با سال، ماه، روز، ساعت، دقیقه، ثانیه و میکروثانیه‌ی مشخص‌شده برمی‌گرداند." msgid "Return a :class:`datetime.datetime` object with the specified year, month, day, hour, minute, second, microsecond and fold." msgstr "یک شیء :class:`datetime.datetime` با سال، ماه، روز، ساعت، دقیقه، ثانیه، میکروثانیه و fold مشخص‌شده برمی‌گرداند." msgid "Return a :class:`datetime.time` object with the specified hour, minute, second and microsecond." msgstr "یک شیء :class:`datetime.time` با ساعت، دقیقه، ثانیه و میکروثانیه‌ی مشخص‌شده برمی‌گرداند." msgid "Return a :class:`datetime.time` object with the specified hour, minute, second, microsecond and fold." msgstr "یک شیء :class:`datetime.time` با ساعت، دقیقه، ثانیه، میکروثانیه و fold مشخص‌شده برمی‌گرداند." msgid "Return a :class:`datetime.timedelta` object representing the given number of days, seconds and microseconds. Normalization is performed so that the resulting number of microseconds and seconds lie in the ranges documented for :class:`datetime.timedelta` objects." msgstr "یک شیء :class:`datetime.timedelta` برمی‌گرداند که نمایانگر تعداد روزها، ثانیه‌ها و میکروثانیه‌های داده‌شده است. نرمال‌سازی انجام می‌شود تا تعداد میکروثانیه‌ها و ثانیه‌های حاصل، در محدوده‌های مستندشده برای اشیاء :class:`datetime.timedelta` قرار گیرند." msgid "Return a :class:`datetime.timezone` object with an unnamed fixed offset represented by the *offset* argument." msgstr "یک شیء :class:`datetime.timezone` با آفست ثابتِ بی‌نامی که توسط آرگومان *offset* نمایش داده می‌شود، برمی‌گرداند." msgid "Return a :class:`datetime.timezone` object with a fixed offset represented by the *offset* argument and with tzname *name*." msgstr "یک شیء :class:`datetime.timezone` با آفست ثابتی که توسط آرگومان *offset* مشخص شده و با tzname برابر *name* برمی‌گرداند." msgid "Macros to extract fields from date objects. The argument must be an instance of :c:type:`PyDateTime_Date`, including subclasses (such as :c:type:`PyDateTime_DateTime`). The argument must not be ``NULL``, and the type is not checked:" msgstr "ماکروهایی برای استخراج فیلدها از اشیاء تاریخ. آرگومان باید نمونه‌ای از :c:type:`PyDateTime_Date` باشد، از جمله زیرکلاس‌ها (مانند :c:type:`PyDateTime_DateTime`). آرگومان نباید ``NULL`` باشد و نوع آن بررسی نمی‌شود:" msgid "Return the year, as a positive int." msgstr "سال را به صورت یک عدد صحیح مثبت برمی‌گرداند." msgid "Return the month, as an int from 1 through 12." msgstr "ماه را به‌صورت یک عدد صحیح از ۱ تا ۱۲ برمی‌گرداند." msgid "Return the day, as an int from 1 through 31." msgstr "روز را به‌صورت یک عدد صحیح از ۱ تا ۳۱ برمی‌گرداند." msgid "Macros to extract fields from datetime objects. The argument must be an instance of :c:type:`PyDateTime_DateTime`, including subclasses. The argument must not be ``NULL``, and the type is not checked:" msgstr "ماکروهایی برای استخراج فیلدها از اشیاء datetime. آرگومان باید نمونه‌ای از :c:type:`PyDateTime_DateTime` باشد، شامل زیرکلاس‌ها. آرگومان نباید ``NULL`` باشد و نوع آن بررسی نمی‌شود:" msgid "Return the hour, as an int from 0 through 23." msgstr "ساعت را به‌صورت یک عدد صحیح از ۰ تا ۲۳ برمی‌گرداند." msgid "Return the minute, as an int from 0 through 59." msgstr "دقیقه را به‌صورت یک عدد صحیح از ۰ تا ۵۹ برمی‌گرداند." msgid "Return the second, as an int from 0 through 59." msgstr "ثانیه را به‌صورت یک عدد صحیح از ۰ تا ۵۹ برمی‌گرداند." msgid "Return the microsecond, as an int from 0 through 999999." msgstr "میکروثانیه را به صورت یک عدد صحیح از ۰ تا ۹۹۹۹۹۹ برمی‌گرداند." msgid "Return the fold, as an int from 0 through 1." msgstr "مقدار تاخوردگی (fold) را به‌صورت یک عدد صحیح از ۰ تا ۱ برمی‌گرداند." msgid "Return the tzinfo (which may be ``None``)." msgstr "بازگرداندن tzinfo (که ممکن است ``None`` باشد)." msgid "Macros to extract fields from time objects. The argument must be an instance of :c:type:`PyDateTime_Time`, including subclasses. The argument must not be ``NULL``, and the type is not checked:" msgstr "ماکروهایی برای استخراج فیلدها از اشیاء زمان. آرگومان باید نمونه‌ای از :c:type:`PyDateTime_Time` باشد، شامل زیرکلاس‌ها. آرگومان نباید ``NULL`` باشد و نوع آن بررسی نمی‌شود:" msgid "Macros to extract fields from time delta objects. The argument must be an instance of :c:type:`PyDateTime_Delta`, including subclasses. The argument must not be ``NULL``, and the type is not checked:" msgstr "ماکروهایی برای استخراج فیلدها از اشیاء دلتای زمانی. آرگومان باید نمونه‌ای از :c:type:`PyDateTime_Delta` باشد، از جمله زیرکلاس‌ها. آرگومان نباید ``NULL`` باشد و نوع آن بررسی نمی‌شود:" msgid "Return the number of days, as an int from -999999999 to 999999999." msgstr "تعداد روز‌ها را به صورت یک عدد صحیح از -999999999 تا 999999999 برمی‌گرداند." msgid "Return the number of seconds, as an int from 0 through 86399." msgstr "تعداد ثانیه‌ها را به‌صورت یک عدد صحیح از ۰ تا ۸۶۳۹۹ برمی‌گرداند." msgid "Return the number of microseconds, as an int from 0 through 999999." msgstr "تعداد میکروثانیه‌ها را به صورت یک عدد صحیح از ۰ تا ۹۹۹۹۹۹ برمی‌گرداند." msgid "Macros for the convenience of modules implementing the DB API:" msgstr "ماکروهایی برای سهولت کار ماژول‌هایی که DB API را پیاده‌سازی می‌کنند:" msgid "Create and return a new :class:`datetime.datetime` object given an argument tuple suitable for passing to :meth:`datetime.datetime.fromtimestamp`." msgstr "با گرفتن یک تاپل آرگومان مناسب برای ارسال به :meth:`datetime.datetime.fromtimestamp`، یک شیء جدید :class:`datetime.datetime` می‌سازد و برمی‌گرداند." msgid "Create and return a new :class:`datetime.date` object given an argument tuple suitable for passing to :meth:`datetime.date.fromtimestamp`." msgstr "با گرفتن یک تاپل آرگومان مناسب برای پاس دادن به :meth:`datetime.date.fromtimestamp`، یک شیء جدید :class:`datetime.date` ایجاد کرده و بازمی‌گرداند." msgid "Internal data" msgstr "داده‌های داخلی" msgid "The following symbols are exposed by the C API but should be considered internal-only." msgstr "نمادهای زیر توسط C API ارائه‌شده‌اند، اما باید فقط داخلی در نظر گرفته شوند." msgid "Name of the datetime capsule to pass to :c:func:`PyCapsule_Import`." msgstr "نام کپسول datetime که باید به :c:func:`PyCapsule_Import` پاس داده شود." msgid "Internal usage only. Use :c:macro:`PyDateTime_IMPORT` instead." msgstr "صرفاً برای استفاده‌ی داخلی. به‌جای آن از :c:macro:`PyDateTime_IMPORT` استفاده کنید."