ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Makale
03/26/2013

Bir zaman değeri bir string öğesine dönüştürmeniz ve yerel saat dilimi ayarlarını yapabilirsiniz.Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; see ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

Parametreler

timer
Saklı bir süre için işaretçi.

Dönüş Değeri

Karakter dizesi sonucu için bir işaretçi.NULLise döndürülür:

timegece yarısı, 1 Ocak 1970, utc önceki bir tarihi temsil eder.
Kullanırsanız, _ctime32 veya _wctime32 ve time 03: 14: 07 19 Ocak 2038 tarihi temsil eder.
Kullanırsanız, _ctime64 veya _wctime64 ve time 23: 59: 59, 31 Aralık 3000 utc tarihi temsil eder.

ctimedeğerlendiren bir satır içi işlevi _ctime64 ve time_t eşdeğeri olan __time64_t.Yorumlamak için derleyici zorlamak gerekirse time_t eski 32-bit olarak time_t, sizin tanımladığınız _USE_32BIT_TIME_T.Bunu neden olur ctime için değerlendirmek için _ctime32.Bu, uygulamanızı 18 Ocak 2038 sonra başarısız olabilir ve 64-bit platformlarda izin verilmez çünkü önerilmez.

Notlar

ctime İşlevi olarak depolanan bir zaman değeri dönüştürür bir time_t değer bir karakter dizesi içinde.timer Değer bir çağrıya elde genellikle zaman, gece yarısından itibaren saniye cinsinden geçen hangi verir (00: 00), 1 Ocak 1970'den itibaren Eşgüdümlü Evrensel Saat (utc).Dönüş değeri dize tam olarak 26 karakter içerir ve formu vardır:

Wed Jan 02 02:03:55 1980\n\0

24 Saatlik zaman biçimi kullanılır.Tüm alanları bir sabit genişliğe sahip olur.Yeni satır karakteri ('\n') ve boş karakter ('\0') dizenin son iki pozisyon kaplar.

Dönüştürülen karakter dizesi de yerel saat dilimi ayarlara göre ayarlanır.Bkz: time, _ftime, ve localtime yerel saat yapılandırma hakkında bilgi için İşlevler ve _tzset işlevi genel değişkenleri ve saat dilimi ortamı tanımlama hakkında ayrıntılı bilgi için.

Çağrı ctime tarafından kullanılan tek bir statik olarak ayrılan arabelleğe değiştirir gmtime ve localtime fonksiyonlar.Bu yordamlar için her arama sonucu önceki çağrı bozar.ctimestatik bir arabellek ile paylaşan asctime işlevi.Bu nedenle, çağrı ctime önceki herhangi bir çağrının sonuçlarını kaynaklarýný asctime, localtime, veya gmtime.

_wctimeve _wctime64 geniş karakter sürümü olan ctime ve _ctime64; geniş karakter dizesi için bir işaretçi döndürülüyor.Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

Bu işlevler, kendi parametreleri doğrulayın.timer Bir null işaretçi veya süreölçer değeri negatif ise, bu işlevler geçersiz parametre işleyicisi açıklandığı şekilde harekete Parametre doğrulama.İşlevler dönüş yürütülmesine devam etmek için izin verilip verilmediğini, NULL ve 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
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Gereksinimler

Yordamı	Gerekli başlık
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> veya <wchar.h>
_wctime32	<time.h> veya <wchar.h>
_wctime64	<time.h> veya <wchar.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

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

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}