strftime, wcsftime, _strftime_l, _wcsftime_l

Makale
06/09/2015

Bir kez dize biçimi.

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr 
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr 
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Parametreler

strDest
Çıkış dizesi.
maxsize
Boyutunu strDest ölçülen karakter arabelleği (char veya wchart_t).
format
Biçim denetimi dizesi.
timeptr
tmveri yapısı.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

strftimeyerleştirilen karakter sayısını verir strDest ve wcsftime ilgili geniş karakter sayısını verir.

Sonunda boş gibi karakterler toplam sayısı ise, birden fazla maxsize, her iki strftime ve wcsftime 0 ve içeriğini dönmek strDest belirsiz olduğundan.

Karakter sayısı strDest değişmez karakter sayısına eşit olan format yanı sıra eklenebilir herhangi bir karakter format biçimlendirme kodları aracılığıyla.Dönüş değerinde bir dizenin sonunda boş sayılmaz.

Notlar

strftime Ve wcsftime işlevler biçimi tm zaman içinde değer timeptr sağlanan göre format bağımsız değişkeni ve arabellekteki sonuç deposu strDest*.* En çok maxsize karakter dizesi içinde yerleştirilir.Alanları bir açıklaması için timeptr yapısı için bkz: asctime.wcsftimegeniş karakter eşdeğerdir strftime; dize işaretçisi argüman bir geniş karakter dizesine işaret eder.Bu işlevler, aksi halde aynı şekilde davranır.

[!NOT]

Önce Visual C++ 2005 sürümlerinde belgelerinde açıklanan format parametresi wcsftime veri türüne sahip olarak const wchar_t *, ancak gerçek uygulaması format veri türü const char *.Uygulaması format veri türü, geçerli ve önceki belgelerine, yani yansıtmak üzere güncelleştirilmiştir const wchar_t *.

Bu işlev, parametrelerini doğrular.Yoksa strDest, format, veya timeptr bir null işaretçi veya tm veri yapısı tarafından ele timeptr (örneğin, tarih veya saat aralık dışı değerleri içeriyorsa), geçersiz veya format dizesi geçersiz biçimlendirme kodu içeriyorsa, açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre Doğrulama.Yürütmenin devam etmesine izin verilirse işlev 0 döndürür ve errno öğesini EINVAL olarak ayarlar.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcsftime	strftime	strftime	wcsftime

format Bağımsız değişkeni oluşur bir veya daha fazla kod; olarak printf, biçimlendirme kodları bir yüzde işareti konur (%).İle başlamayan karakter % için değiştirilmemiş olarak kopyalanır strDest*.*LC_TIME Geçerli yerel ayarları kategorisini etkiler çıktı biçimini strftime. (Daha fazla bilgi için LC_TIME, bkz: setlocale.) İşlevleri olmadan _l şu anda ayarlanmış soneki kullanan yerel ayarı.Bu işlevleri sürümlerini _l yerel parametre olarak alır ve şu anda ayarlanmış kullanan dışında sonek aynı yerel ayarı.Daha fazla bilgi için bkz. Yerel Ayar.

Biçimlendirme kodları strftime aşağıda listelenmiştir:

%a
Kısaltılmış haftanın günü adı
%A
Tam hafta içi adı
%b
Kısaltılmış ay adı
%B
Tam ay adı
%c
Yerel ayar için uygun tarih ve saat gösterimi
%d
Ondalık sayı (01-31) ayın günü
%H
24 saatlik biçimde saat (00-23)
%I
Saati 12 saat biçiminde (01-12)
%j
Ondalık sayı (001-366) yılın günü
%m
(01-12) ondalık sayı olarak ay
%M
Ondalık sayı olarak dakika (00-59)
%p
Yerel dakikaları. 12 saat göstergesi
%S
Ondalık sayı olarak ikinci (00-59)
%U
Haftanın ilk günü olarak Pazar ile ondalık sayı olarak yılın haftası (00-53)
%w
Haftanın günü olarak ondalık sayı (0-6; Pazar 0'dır)
%W
Pazartesi haftanın ilk günü olarak ile ondalık sayı olarak yılın haftası (00-53)
%x
Geçerli yerel tarih gösterimi
%X
Geçerli yerel zaman gösterimi
%y
Olmadan yüzyıl, ondalık sayı olarak yıl (00-99)
%Y
Yüzyıl, ondalık sayı olarak yıl
%z, %Z
Saat dilimi adı veya kayıt defteri ayarlarına bağlı olarak saat dilimi kısaltması; saat dilimi bilinmiyorsa karakter
%%
Yüzde işareti

Olarak printf işlevi, # bayrağı biçimlendirme herhangi bir kod öneki.Bu durumda, anlamını biçim kodu aşağıdaki gibi değişir.

Biçim Kodu	Anlam
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%	#bayrak yok sayılır.
%#c	Uzun tarih ve saat gösterimi, geçerli yerel ayar için uygun.Örneğin: "Salı, 14 Mart 1995, 12:41:29".
%#x	Uzun tarih gösterimi, geçerli yerel ayar için uygun.Örneğin: "Salı, 14 Mart 1995".
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y	Baştaki sıfırlar (varsa) kaldırın.