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
, dansourceTime
mewakili tanggal setelah 23:59:59 18 Januari 2038, UTC.Anda menggunakan
_ctime64
atau_wctime64
, dansourceTime
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_t
lama, 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 time
fungsi , _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( <ime );
printf( "The time is %s\n", _ctime64( <ime ) ); // C4996
// Note: _ctime64 is deprecated; consider using _ctime64_s
}
The time is Wed Feb 13 16:04:43 2002
Lihat 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