timegm(3)

الاسم
timegm, timelocal - معكوسات gmtime و localtime

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <time.h>

[[مهمل]] time_t timelocal(struct tm *tm);
time_t timegm(struct tm *tm);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

timelocal()، timegm():
    منذ glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE || _SVID_SOURCE

الوصف
الدالتان timelocal() و timegm() هما معكوسا localtime(3) و gmtime(3). تأخذ كلتا الدالتين وقتًا محللًا وتحوله إلى وقت تقويمي (ثوانٍ منذ الحقبة، 1970-01-01 00:00:00 +0000، UTC). الفرق بين الدالتين هو أن timelocal() تأخذ المنطقة الزمنية المحلية في الاعتبار عند إجراء التحويل، بينما timegm() تعتبر قيمة الإدخال هي التوقيت العالمي المنسق (UTC).

قيمة الإرجاع
عند النجاح، تُرجع هاتان الدالتان الوقت التقويمي (ثوانٍ منذ الحقبة)، معبرًا عنه بقيمة من النوع time_t. عند الخطأ، تُرجعان القيمة (time_t) -1 وتضبطان errno للإشارة إلى الخطأ.

الأخطاء

EOVERFLOW
    لا يمكن تمثيل النتيجة.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
timelocal()، timegm() | سلامة الخيوط | بيئة محلية آمنة لتعدد الخيوط (MT-Safe)

المعايير
BSD.

التاريخ
جنو، بي إس دي (BSD).

الدالة timelocal() مكافئة للدالة القياسية POSIX mktime(3). لا يوجد سبب لاستخدامها مطلقًا.

انظر أيضًا
gmtime(3)، localtime(3)، mktime(3)، tzset(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.