ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Konversikan nilai waktu menjadi string dan sesuaikan untuk pengaturan zona waktu lokal. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat ctime_s, , _ctime64_s_ctime32_s, _wctime_s, , . _wctime64_s_wctime32_s

Sintaks

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 );

Parameter

sourceTime
Penunjuk ke waktu tersimpan untuk dikonversi.

Nilai hasil

Penunjuk ke hasil string karakter. NULL dikembalikan ketika:

• sourceTime menunjukkan tanggal sebelum tengah malam, 1 Januari 1970, UTC.

• Anda menggunakan _ctime32 atau _wctime32, dan sourceTime mewakili tanggal setelah 23:59:59 18 Januari 2038, UTC.

• Anda menggunakan _ctime64 atau _wctime64, dan sourceTime mewakili tanggal setelah 23:59:59, 31 Desember 3000, UTC.

ctime adalah fungsi sebaris yang mengevaluasi ke _ctime64, dan time_t setara dengan __time64_t. Jika Anda perlu memaksa pengkompilasi untuk menafsirkan time_t sebagai 32-bit time_tlama, Anda dapat menentukan _USE_32BIT_TIME_T. Makro ini menyebabkan ctime evaluasi ke _ctime32. Kami tidak menyarankan Anda menggunakannya, karena aplikasi Anda mungkin gagal setelah 18 Januari 2038, dan tidak diizinkan pada platform 64-bit.

Keterangan

Fungsi ini ctime mengonversi nilai waktu yang time_t disimpan sebagai nilai menjadi string karakter. Nilai sourceTime biasanya diperoleh dari panggilan ke time, yang mengembalikan jumlah detik yang berlalu sejak tengah malam (00:00:00), 1 Januari 1970, waktu universal terkoordinasi (UTC). String nilai yang dikembalikan berisi tepat 26 karakter dan memiliki formulir:

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

Jam 24 jam digunakan. Semua bidang memiliki lebar konstanta. Karakter baris baru ('\n') dan karakter null ('\0') menempati dua posisi terakhir string.

String karakter yang dikonversi juga disesuaikan sesuai dengan pengaturan zona waktu lokal. Untuk informasi tentang mengonfigurasi waktu lokal, lihat timefungsi , _ftime, dan localtime . Untuk detail tentang menentukan lingkungan zona waktu dan variabel global, lihat fungsinya _tzset .

Panggilan untuk ctime memodifikasi buffer yang dialokasikan secara statis tunggal yang gmtime digunakan oleh fungsi dan localtime . Setiap panggilan ke salah satu rutinitas ini menghancurkan hasil panggilan sebelumnya. ctime berbagi buffer statis dengan asctime fungsi . Dengan demikian, panggilan untuk ctime menghancurkan hasil panggilan sebelumnya ke asctime, localtime, atau gmtime.

_wctime dan _wctime64 merupakan versi karakter lebar dari ctime dan _ctime64; mengembalikan penunjuk ke string karakter lebar. Jika tidak, _ctime64, , dan _wctime64 berulah identik dengan ctime_wctime.

Fungsi-fungsi ini memvalidasi parameternya. Jika sourceTime adalah penunjuk null, atau jika sourceTime nilainya negatif, fungsi-fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi kembali NULL dan diatur errno ke EINVAL.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR. Rutinitas H	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Persyaratan

Rutin	Header yang diperlukan
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> atau <wchar.h>
_wctime32	<time.h> atau <wchar.h>
_wctime64	<time.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// 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

Baca juga

Manajemen waktu
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