STRFTIME wcsftime, _strftime_l, _wcsftime_l

Makale
02/26/2013

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
Denetim biçim dizesi.
timeptr
tmveri yapı.
locale
Kullanılacak yerel ayar .

Dönüş Değeri

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

Dahil Sonlandırıcı boş karakter sayısı ise çok maxsize, hem strftime ve wcsftime 0 ve içeriğini dönmek strDest belirsiz olan.

Karakter sayısı strDest değişmez karakter sayısı eşittir format yanı sıra eklenebilir herhangi bir karakter format biçimlendirme kodları aracılığıyla.Dönüş değeri, bir dize Sonlandırıcı boş sayılmaz.

Notlar

strftime Ve wcsftime işlevleri biçimi tm zaman değeri timeptr uyarınca sağlanan format bağımsız değişken ve depolama arabellek sonucu strDest*.* En maxsize karakter dizesindeki yerleştirilir.Alanları açıklaması için timeptr yapıgörmek asctime. wcsftimegeniş karakter eşdeğerdir strftime; bağımsız değişken dizesini -işaretçibir geniş karakter dizesine işaret eder. Bu işlevler aynı şekilde aksi davranırlar.

[!NOT]

Önce sürümlerinde Visual C++ 2005, açıklanan belgelerine format parametre wcsftime veri türüolarakconst wchar_t *, ancak gerçek uygulaması, format veri türü const char *. Uygulaması, format veri türü , önceki ve geçerli belgelere, yani yansıtacak biçimde güncelleştirilmiştir const wchar_t *.

Bu işlev parametreleri doğrular.strDest, format, Veyatimeptr boş işaretçiveya tm tarafından gönderilen veri yapı timeptr geçersiz (örneğin saat veya tarih aralığı değerlerini içeriyorsa), veya format kod biçimlendirme bir geçersiz dize içerir, geçersizparametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulama. Yürütülmesine devam etmek için ayarlar ve işlev döndüðünde 0 veriliyorsa, errno için EINVAL.

Genel metin yordamı eşlemeleri

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tcsftime	strftime	strftime	wcsftime

format bağımsız değişken oluşan bir veya daha fazla kodları; gibi printf, biçimlendirme kodları bir yüzde işareti konur (%).İle başlamaz karakter % için değişmeden kopyalanır ve strDest*.*LC_TIMEGeçerli yerel ayar kategori 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şlevler ile sürümlerini _l son parametre olarak yerel ayar olması ve şu anda ayarlanmış yerine kullanmak dışında aynı yerel ayar.Daha fazla bilgi için bkz. Yerel ayar.

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

%a
Kısaltılmış hafta içi 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) olarak 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
Ay olarak ondalık sayı (01-12)
%M
ondalık sayı olarak dakika (00-59)
%p
yerel ayardakikaları.12 saat göstergesi
%S
İkinci ondalık sayı olarak (00-59)
%U
Pazar haftanın ilk günü olarak kabül edildiğinde, 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 kabül edildiğinde, ondalık sayı olarak Yılın haftası (00-53)
%x
Geçerli yerel ayar tarih gösterimi
%X
Geçerli yerel ayar 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
Saatbölge adı veya zaman kayıt defteri ayarları; bağlı bölge kısaltma saat bölge bilinmiyorsa karakter
%%
Yüzde işareti

Gibi printf işlev, # bayrak biçimlendirme herhangi bir kod öneki. Bu durumda, biçim kodu ne anlama geldiğini aşağıdaki gibi değiştirildi.

Biçim kodu	Anlam
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%	# bayrak yoksayıldı.
%#c	Uzun tarih ve saat gösterimi, geçerli yerel ayariçin uygun.Örneğin: "Salı, 14 Mart 1995, 12: 41: 29".
%#x	Uzun tarih gösterimi, geçerli yerel ayariç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.