strftime() fonksiyonu

Bildirim

Açıklama

Tmptr parametresi ile gösterilen tm zaman yapısı içindeki değerleri, yerel zamana ve format parametresi ile gösterilen yapıya uygun olarak, en fazla bufsz parametre değeri kadar boyutta olmak üzere, buf parametresi ile gösterilen boş bir karakterle sonlandırılmış çok byte'lı bir karakter dizisine çevirir.

Parametreler

buf: Elde edilen karakter dizisinin kopyalanacağı karakter dizisini gösteren bir işaretçidir.

bufsz: Buf parametresine kopyalanacak maksimum karakter sayısıdır.

format: Normal karakterler ve format tanımlayıcılarının yer aldığı bir karakter dizisidir. Buf karakter dizisi içindeki her bir format tanımlayıcı yerine tmptr yapı değişkeni içinde yer alan ilgili değişkenler yerleştirilir.Zaman tanımlamada kullanılan format tanımlayıcıları aşağıdadır:

tmptr: Zaman değerlerini içeren tm yapı değişkenini gösteren bir işaretçidir.

struct tm
{
  int tm_sec;	/* Saniye: 0-59 */
  int tm_min;	/* Dakika: 0-59 */
  int tm_hour;	/* Saat : 0-23 */
  int tm_mday;	/* Ayın günü: 1-31 */
  int tm_mon;	/* Aylar Ocak'tan itibaren: 0-11 */
  int tm_year;	/* Yıllar 1900'den itibaren */
  int tm_wday;	/* Hafta gün sayısı Pazar'dan itibaren (0-6) */
  int tm_yday;	/* Yıl gün sayısı 1 Ocak'tan itibaren : 0-365 */
  int tm_isdst;	/* +1 Günışığından Faydalanma Zamanı, 0 GFZ yok, -1 Bilgi yok */
};

Dönüş değeri

Başarı durumunda, buf karakter dizisinin boyutu bufsz değerinden büyük olmazsa, buf parametresi ile gösterilen karakter dizisine yazılan byte sayısını (sondaki boş karakter hariç) geri döndürür. Aksi takdirde, 0 değeri döndürülür ve içerik tanımsız olur.

Örnek

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t time_1970;
    struct tm *time_detay;
    char cdizi[100];

    time_1970 = time(NULL);

    /* Yerel zaman */
    time_detay = localtime(&time_1970);
    printf("Yerel zaman: %s", asctime(time_detay));

    strftime (cdizi, 100, "Bugün: %d %B %Y %A Saat: %X", time_detay);

    printf("%s", cdizi);

    return 0;
}

Yukarıdaki örnekte, program aşağıdaki satırları ekrana yazar.

Yerel zaman: Tue Oct 15 11:48:29 2019
Bugün: 15 October 2019 Tuesday Saat: 11:48:29

Program time() fonksiyonu ile 1 Ocak 1970'den bugüne geçen zamanı saniye olarak alır. Bu değeri localtime() fonksiyonu ile yerel zamana çevirerek, asctime() fonksiyonu ile ekrana yazar. Sonra, strftime() fonksiyonu ile zamanı gösteren farklı bir yapı oluşturup ekrana yazar.