Bildirim
time_t time(time_t *timer);
Açıklama
Mevcut takvim zamanını time_t değişkeni olarak saniye cinsinden geri döndürür. Aynı değeri, eğer timer parametresi NULL bir işaretçi değilse, timer parametresi ile gösterilen time_t değişkenine atar.
Parametreler
timer: Zaman değerinin yükleneceği time_t değişkenini gösteren bir işaretçidir. NULL bir değer içerdiğinde zaman değeri fonksiyon tarafından sadece geri döndürülür.
Dönüş değeri
Mevcut takvim zamanını gösteren time_t değişken değeri geri döndürülür. Eğer timer parametre değeri NULL değilse, geri döndürülen değerin aynısı timer parametresine yüklenir.
Takvim zamanı alınamadığında, -1 değeri geri döndürülür.
Örnek
#include <stdio.h>
#include <time.h>
int main(void)
{
time_t time_1970;
time_1970 = time(NULL);
/* Yerel zamanı doğrudan ctime() fonksiyonu ile ekrana yazma */
/* ctime() = localtime() + asctime() */
printf("Yerel zaman: %s", ctime(&time_1970));
return 0;
}
Yukarıdaki örnekte, program aşağıdaki satırları ekrana yazar.
Yerel zaman: Tue Oct 15 07:06:21 2019
Program time() fonksiyonu ile 1 Ocak 1970'den bugüne geçen zamanı saniye olarak alır. Bu değeri ctime() fonksiyonu ile yerel zamana çevirerek bir karakter dizisi olarak ekrana yazar.