نطاقات
المتغيرات
أفعال

time

من cppreference.com
< c | chrono
<tbody> </tbody>
معرفة في ملف <time.h>
time_t time( time_t *time );

تُرجع الوقت المنقضي منذ بداية التأريخ الرقمي وذلك في صورة كائن من النوع time_t‎

المعطيات

time - مؤشر إلى عنصر من النوع time_t‎ ليرم تخزين الوقت فيه أو NULL‎

القيمة المُرجعة

الوقت والتاريخ الحالي ككائن من النوع time_t‎ أو (time_t)(-1) في حالة الفشل. إذا كان المعطى لا يساوي NULL‎تكون القيمة المرجعة مسوية لقمة مايشير إليه المعطى.

ملحوظات

لم يحدد معيار اللغة طريقة لتمثيل الوقت كـ time_t‎ ولكن معظم الأنظمة تتبع معيار الـPOSIX الذي ينص على أن time_t‎ عدد صحيح يكافئ عدد الثواني التي انقضت منذ بداية التأريخ الرقمي لليونيكس (أي 1 يناير عام 1970). يعني ذلك أن البيئات التي توفر time_t‎ كنوع signed int‎ حجمه 32 بت سيحدث لها طفح عام 2038.

مثال

#include <stdio.h>
#include <time.h>
#include <stdlib.h>
 
int main(void)
{
    time_t result = time(NULL);
    if (result == ((time_t)-1))
    {
       fprintf(stderr,"time() failed in file %s at line # %d\n", __FILE__,__LINE__-3);
       exit(EXIT_FAILURE);
    }
    
    printf("%s", asctime(localtime(&result)));
    printf("%d seconds since the Epoch", (int)result);
    return EXIT_SUCCESS;
}

خرج ممكن:

Wed Oct  9 10:49:31 2013
1381315771 seconds since the Epoch

أنظر أيضا

تحول كائن من النوع time_t إلى النوع tm بالتوقيت المحلي
(دالة) [edit]
تحول كائن من النوع time_t إلى النوع tm بالتوقيت العالمي المنسق (UTC)
(دالة) [edit]
(منذ C11)
تُرجع الوقت الميلادي الحالي بتوقيت محدد وذلك بالثانية والنانوثانية
(دالة) [edit]