.\" -*- coding: UTF-8 -*- .\" Copyright 1992, Drew Eckhardt .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH time 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم time \- الحصول على الوقت بالثواني .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBtime_t time(time_t *_Nullable \fP\fItloc\fP\fB);\fP .fi .SH الوصف تُرجع \fBtime\fP() الوقت كعدد الثواني منذ الحقبة (Epoch)، 1970\-01\-01 00:00:00 +0000 (UTC). .P إذا كان \fItloc\fP غير NULL، تُخزَّن القيمة المُرجعة أيضًا في الذاكرة المُشار إليها بواسطة \fItloc\fP. .SH "قيمة الإرجاع" عند النجاح، تُرجع قيمة الوقت بالثواني منذ الحقبة. عند الخطأ، تُرجع \fI((time_t)\ \-1)\fP، ويُعيَّن \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEOVERFLOW\fP لا يمكن تمثيل الوقت كقيمة \fItime_t\fP. قد يحدث هذا إذا شُغِّل ملف تنفيذي ذو \fItime_t\fP 32\-بت على نواة 64\-بت عندما يكون الوقت 2038\-01\-19 03:14:08 UTC أو لاحقًا. ومع ذلك، عندما يكون وقت النظام خارج نطاق \fItime_t\fP في حالات أخرى، يكون السلوك غير مُحدَّد. .TP \fBEFAULT\fP يشير \fItloc\fP إلى خارج مساحة العناوين القابلة للوصول (لكن انظر الأخطاء). .IP على الأنظمة حيث تستدعي دالة الغلاف \fBtime\fP() في مكتبة C تطبيقًا مُقدمًا من \fBvdso\fP(7) (بحيث لا يوجد فخ إلى النواة)، قد يُؤدي عنوان غير صالح بدلاً من ذلك إلى إشارة \fBSIGSEGV\fP. .SH الإصدارات يُعرِّف POSIX.1 \fIالثواني منذ الحقبة\fP باستخدام صيغة تُقرِّب عدد الثواني بين وقت مُحدَّد والحقبة. تأخذ هذه الصيغة في الاعتبار أن جميع السنوات القابلة للقسمة على 4 هي سنوات كبيسة، لكن السنوات القابلة للقسمة على 100 ليست سنوات كبيسة إلا إذا كانت أيضًا قابلة للقسمة على 400، وفي هذه الحالة تكون سنوات كبيسة. هذه القيمة ليست نفس العدد الفعلي للثواني بين الوقت والحقبة، بسبب الثواني الكبيسة ولأن الساعات النظامية ليست مطلوبة لتكون متزامنة مع مرجع قياسي. تتبع أنظمة Linux عادةً متطلب POSIX بأن تتجاهل هذه القيمة الثواني الكبيسة، بحيث تُفسرها الأنظمة المتوافقة بشكل متسق؛ انظر POSIX.1\-2018 Rationale A.4.16. .P يجب على التطبيقات المُعدة للتشغيل بعد 2038 استخدام واجهات ثنائية التطبيق (ABIs) مع \fItime_t\fP أعرض من 32 بت؛ انظر \fBtime_t\fP(3type). .SS "الاختلافات بين مكتبة C والنواة" على بعض البنى، يُقدم تطبيق لـ \fBtime\fP() في \fBvdso\fP(7). .SH المعايير C11، ‏POSIX.1\-2024. .SH التاريخ SVr4, 4.3BSD, C89, POSIX.1\-2001, V7. .SH العلل لا يمكن تمييز إرجاعات الخطأ من استدعاء النظام هذا عن التقارير الناجحة بأن الوقت قبل الحقبة ببضع ثوانٍ، لذا لا تُعيِّن دالة الغلاف في مكتبة C \fIerrno\fP أبدًا نتيجة لهذا الاستدعاء. .P الوسيط \fItloc\fP قديم ويجب أن يكون دائمًا NULL في الكود الجديد. عندما يكون \fItloc\fP NULL، لا يمكن أن يفشل الاستدعاء. .SH "انظر أيضًا" \fBdate\fP(1), \fBgettimeofday\fP(2), \fBctime\fP(3), \fBftime\fP(3), \fBtime\fP(7), \fBvdso\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .