# 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: # Danial Behzadi , 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: 2024-05-11 01:07+0000\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" msgid "PyTime C API" msgstr "API زبان C برای PyTime" msgid "The clock C API provides access to system clocks. It is similar to the Python :mod:`time` module." msgstr "API ساعت در C دسترسی به ساعت‌های سیستمی را فراهم می‌کند. این API مشابه ماژول :mod:`time` پایتون است." msgid "For C API related to the :mod:`datetime` module, see :ref:`datetimeobjects`." msgstr "برای API زبان C مربوط به ماژول :mod:`datetime`، به :ref:`datetimeobjects` مراجعه کنید." msgid "Types" msgstr "نوع‌ها" msgid "A timestamp or duration in nanoseconds, represented as a signed 64-bit integer." msgstr "یک برچسب زمانی یا مدت‌زمان بر حسب نانوثانیه که به‌صورت یک عدد صحیح علامت‌دار ۶۴ بیتی نمایش داده می‌شود." msgid "The reference point for timestamps depends on the clock used. For example, :c:func:`PyTime_Time` returns timestamps relative to the UNIX epoch." msgstr "نقطه مرجع مهرهای زمانی به ساعت مورد استفاده بستگی دارد. برای مثال، :c:func:`PyTime_Time` مهرهای زمانی را نسبت به مبدأ زمان یونیکس برمی‌گرداند." msgid "The supported range is around [-292.3 years; +292.3 years]. Using the Unix epoch (January 1st, 1970) as reference, the supported date range is around [1677-09-21; 2262-04-11]. The exact limits are exposed as constants:" msgstr "محدوده‌ی پشتیبانی‌شده حدود [-292.3 سال؛ +292.3 سال] است. با استفاده از مبدأ زمان یونیکس (۱ ژانویه ۱۹۷۰) به عنوان مرجع، محدوده‌ی تاریخ‌های پشتیبانی‌شده حدود [1677-09-21; 2262-04-11] است. حد‌های دقیق به صورت ثابت‌ها ارائه شده‌اند:" msgid "Minimum value of :c:type:`PyTime_t`." msgstr "کمترین مقدار :c:type:`PyTime_t`." msgid "Maximum value of :c:type:`PyTime_t`." msgstr "بیشینه مقدار :c:type:`PyTime_t`." msgid "Clock Functions" msgstr "توابع ساعت" msgid "The following functions take a pointer to a :c:expr:`PyTime_t` that they set to the value of a particular clock. Details of each clock are given in the documentation of the corresponding Python function." msgstr "توابع زیر یک اشاره‌گر به :c:expr:`PyTime_t` می‌گیرند که آن را به مقدار یک ساعت خاص تنظیم می‌کنند. جزئیات هر ساعت در مستندات تابع متناظر پایتون ارائه شده است." msgid "The functions return ``0`` on success, or ``-1`` (with an exception set) on failure." msgstr "این توابع در صورت موفقیت ``0`` و در صورت شکست ``-1`` (همراه با استثنای تنظیم‌شده) برمی‌گردانند." msgid "On integer overflow, they set the :c:data:`PyExc_OverflowError` exception and set ``*result`` to the value clamped to the ``[PyTime_MIN; PyTime_MAX]`` range. (On current systems, integer overflows are likely caused by misconfigured system time.)" msgstr "در صورت سرریز عدد صحیح، استثنای :c:data:`PyExc_OverflowError` تنظیم می‌شود و ``*result`` به مقداری تنظیم می‌شود که به بازه‌ی ``[PyTime_MIN; PyTime_MAX]`` محدود شده است. (در سیستم‌های امروزی، سرریزهای عدد صحیح به احتمال زیاد ناشی از تنظیم نادرست زمان سیستم هستند.)" msgid "As any other C API (unless otherwise specified), the functions must be called with an :term:`attached thread state`." msgstr "مانند هر API زبان C دیگری (مگر این‌که خلاف آن مشخص شده باشد)، این توابع باید با یک :term:`attached thread state` فراخوانی شوند." msgid "Read the monotonic clock. See :func:`time.monotonic` for important details on this clock." msgstr "ساعت یکنواخت را بخوانید. برای جزئیات مهم درباره‌ی این ساعت به :func:`time.monotonic` مراجعه کنید." msgid "Read the performance counter. See :func:`time.perf_counter` for important details on this clock." msgstr "شمارنده‌ی عملکرد را بخوانید. برای جزئیات مهم درباره‌ی این ساعت، :func:`time.perf_counter` را ببینید." msgid "Read the “wall clock” time. See :func:`time.time` for details important on this clock." msgstr "زمان «ساعت دیواری» را می‌خواند. برای جزئیات مهم درباره‌ی این ساعت، :func:`time.time` را ببینید." msgid "Raw Clock Functions" msgstr "توابع ساعت خام" msgid "Similar to clock functions, but don't set an exception on error and don't require the caller to have an :term:`attached thread state`." msgstr "مشابه توابع ساعت، اما در صورت خطا استثنا تنظیم نمی‌کنند و نیازی ندارند که فراخواننده :term:`وضعیت نخ متصل ` داشته باشد." msgid "On success, the functions return ``0``." msgstr "در صورت موفقیت، این توابع ``0`` را برمی‌گردانند." msgid "On failure, they set ``*result`` to ``0`` and return ``-1``, *without* setting an exception. To get the cause of the error, :term:`attach ` a :term:`thread state`, and call the regular (non-``Raw``) function. Note that the regular function may succeed after the ``Raw`` one failed." msgstr "در صورت شکست، آن‌ها ``*result`` را برابر ``0`` قرار می‌دهند و ``-1`` را برمی‌گردانند، *بدون* تنظیم کردن استثنا. برای به دست آوردن علت خطا، یک :term:`وضعیت نخ ` را :term:`متصل کنید ` و تابع معمولی (غیر ``Raw``) را فراخوانی کنید. توجه داشته باشید که تابع معمولی ممکن است پس از شکست تابع ``Raw`` موفق شود." msgid "Similar to :c:func:`PyTime_Monotonic`, but don't set an exception on error and don't require an :term:`attached thread state`." msgstr "مشابه :c:func:`PyTime_Monotonic` است، اما در صورت خطا استثنایی تنظیم نمی‌کند و نیازی به :term:`attached thread state` ندارد." msgid "Similar to :c:func:`PyTime_PerfCounter`, but don't set an exception on error and don't require an :term:`attached thread state`." msgstr "مشابه :c:func:`PyTime_PerfCounter` است، اما در صورت خطا استثنایی تنظین نمی‌کند و نیازی به :term:`وضعیت نخ متصل ` ندارد." msgid "Similar to :c:func:`PyTime_Time`, but don't set an exception on error and don't require an :term:`attached thread state`." msgstr "مشابه :c:func:`PyTime_Time` است، اما در صورت خطا استثنایی تنظیم نمی‌کند و به :term:`attached thread state` نیازی ندارد." msgid "Conversion functions" msgstr "توابع تبدیل" msgid "Convert a timestamp to a number of seconds as a C :c:expr:`double`." msgstr "یک مهر زمانی را به تعدادی ثانیه به‌صورت یک :c:expr:`double` در C تبدیل می‌کند." msgid "The function cannot fail, but note that :c:expr:`double` has limited accuracy for large values." msgstr "تابع نمی‌تواند شکست بخورد، اما توجه داشته باشید که :c:expr:`double` برای مقادیر بزرگ دقت محدودی دارد."