Aracılığıyla paylaş

ctime, _ctime32, _ctime64, , _wctime, _wctime32, _wctime64

  • Makale

Bir saat değerini dizeye dönüştürün ve yerel saat dilimi ayarları için ayarlayın. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. ctime_s, _ctime32_s, _ctime64_s_wctime_s, , _wctime32_s, _wctime64_s.

Sözdizimi

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

Parametreler

sourceTime
Dönüştürülecek depolanan süre işaretçisi.

Dönüş değeri

Karakter dizesi sonucunun işaretçisi. NULL şu durumlarda döndürülür:

  • sourceTime , 1 Ocak 1970( UTC) gece yarısından önceki bir tarihi temsil eder.

  • veya _wctime32kullanırsınız _ctime32 ve sourceTime 18 Ocak 2038 UTC saat 23:59:59'dan sonraki bir tarihi temsil eder.

  • veya _wctime64kullanırsınız _ctime64 ve sourceTime 31 Aralık 3000 UTC saat 23:59:59'dan sonraki bir tarihi temsil eder.

ctime , olarak değerlendirilen _ctime64ve time_t ile eşdeğer __time64_tolan satır içi bir işlevdir. Derleyiciyi eski 32 bit time_tolarak yorumlamaya time_t zorlamanız gerekiyorsa tanımlayabilirsiniz_USE_32BIT_TIME_T. Bu makro değerinin değerlendirmesine _ctime32neden olurctime. Uygulamanız 18 Ocak 2038'in ardından başarısız olabileceği ve 64 bit platformlarda izin verilmeyebileceği için bunu kullanmanızı önermiyoruz.

Açıklamalar

işlevi, ctime değer olarak time_t depolanan bir zaman değerini karakter dizesine dönüştürür. Değer sourceTime genellikle gece yarısından (00:00:00), 1 Ocak 1970'ten (UTC) itibaren geçen saniye sayısını döndüren çağrısından timeelde edilir. Dönüş değeri dizesi tam olarak 26 karakter içerir ve şu forma sahiptir:

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

24 saat kullanılır. Tüm alanların genişliği sabit olur. Yeni satır karakteri ('\n') ve null karakter ('\0') dizenin son iki konumunda yer alır.

Dönüştürülen karakter dizesi de yerel saat dilimi ayarlarına göre ayarlanır. Yerel saati yapılandırma hakkında bilgi için bkz time. , _ftimeve localtime işlevleri. Saat dilimi ortamını ve genel değişkenleri tanımlama hakkında ayrıntılı bilgi için işleve _tzset bakın.

ve işlevleri tarafından gmtime localtime kullanılan statik olarak ayrılmış tek bir arabelleği değiştirmek için ctime bir çağrı. Bu yordamlardan birine yapılan her çağrı, önceki çağrının sonucunu yok eder. ctime işleviyle asctime statik bir arabellek paylaşır. Bu nedenle, çağrısı ctime , veya gmtimeiçin önceki çağrıların asctimelocaltimesonuçlarını yok eder.

_wctime ve _wctime64 öğesinin geniş karakterli sürümüdür ctime _ctime64; geniş karakterli dizeye bir işaretçi döndürür. Aksi takdirde , _ctime64_wctimeve _wctime64 ile aynı şekilde ctimedavranır.

Bu işlevler parametrelerini doğrular. Boş bir işaretçiyse sourceTime veya değer negatifsesourceTime, bu işlevler Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, işlevler geri döner NULL ve olarak EINVALayarlanırerrno.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı _UNICODE ve _MBCS tanımlanmadı _MBCS tanımlanan _UNICODE tanımlanan
_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>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Ö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
}

The time is Wed Feb 13 16:04:43 2002

Ayrıca bkz.

Zaman yönetimi
asctime, _wasctime
ctime_s, _ctime32_s, _ctime64_s, , _wctime_s, _wctime32_s, _wctime64_s
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64