asctime
, _wasctime
tm
Mengonversi struktur waktu menjadi string karakter. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat asctime_s
, _wasctime_s
.
Sintaks
char *asctime(
const struct tm *timeptr
);
wchar_t *_wasctime(
const struct tm *timeptr
);
Parameter
timeptr
Struktur waktu/tanggal.
Nilai hasil
asctime
mengembalikan penunjuk ke hasil string karakter; _wasctime
mengembalikan penunjuk ke hasil string karakter lebar. Tidak ada nilai pengembalian kesalahan.
Keterangan
Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat asctime_s
, _wasctime_s
.
Fungsi ini asctime
mengonversi waktu yang disimpan sebagai struktur menjadi string karakter. Nilai timeptr
biasanya diperoleh dari panggilan ke gmtime
atau localtime
, yang keduanya mengembalikan pointer ke tm
struktur, yang ditentukan dalam TIME.H.
timeptr anggota |
Nilai |
---|---|
tm_hour |
Jam sejak tengah malam (0-23) |
tm_isdst |
Positif jika waktu musim panas berlaku; 0 jika waktu musim panas tidak berlaku; negatif jika status waktu musim panas tidak diketahui. Pustaka run-time C mengasumsikan aturan Amerika Serikat untuk menerapkan perhitungan Daylight Saving Time (DST). |
tm_mday |
Hari dalam sebulan (1-31) |
tm_min |
Menit demi jam (0-59) |
tm_mon |
Bulan (0-11; Januari = 0) |
tm_sec |
Detik demi menit (0-59) |
tm_wday |
Hari dalam seminggu (0-6; Minggu = 0) |
tm_yday |
Hari dalam setahun (0-365; 1 Januari = 0) |
tm_year |
Tahun (tahun berjalan minus 1900) |
Untuk informasi tentang mengonfigurasi waktu lokal, lihat time
fungsi , _ftime
, dan localtime
. Untuk informasi tentang menentukan lingkungan zona waktu dan variabel global, lihat fungsinya _tzset
.
Hasil string yang dihasilkan dengan asctime
berisi tepat 26 karakter dan memiliki formulir Wed Jan 2 02:03:55 1980\n\0
. Jam 24 jam digunakan. Semua bidang memiliki lebar konstanta. Karakter baris baru dan karakter null menempati dua posisi terakhir string. asctime
menggunakan buffer tunggal yang dialokasikan secara statis untuk menahan string pengembalian. Setiap panggilan ke fungsi ini menghancurkan hasil panggilan sebelumnya.
_wasctime
adalah versi karakter luas dari asctime
, dan sebaliknya bersifat identik dengan asctime
.
Fungsi-fungsi ini memvalidasi parameternya. Jika timeptr
adalah penunjuk null, atau jika berisi nilai di luar rentang, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi mengembalikan NULL
dan mengatur 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.H Rutin |
_UNICODE dan _MBCS tidak ditentukan |
_MBCS Didefinisikan |
_UNICODE Didefinisikan |
---|---|---|---|
_tasctime |
asctime |
asctime |
_wasctime |
Persyaratan
Rutin | Header yang diperlukan |
---|---|
asctime |
<time.h> |
_wasctime |
<time.h> atau <wchar.h> |
Contoh
Program ini menempatkan waktu sistem dalam bilangan bulat aclock
panjang , menerjemahkannya ke dalam struktur newtime
, lalu mengonversinya menjadi bentuk string untuk output menggunakan asctime
fungsi .
// crt_asctime.c
// compile with: /W3
#include <time.h>
#include <stdio.h>
int main( void )
{
struct tm *newTime;
time_t szClock;
// Get time in seconds
time( &szClock );
// Convert time to struct tm form
newTime = localtime( &szClock );
// Print local time as a string.
printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
// Note: asctime is deprecated; consider using asctime_s instead
}
Current date and time: Sun Feb 3 11:38:58 2002
Baca juga
Manajemen waktu
ctime
, _ctime32
, _ctime64
, _wctime
, _wctime32
, _wctime64
_ftime
, _ftime32
, _ftime64
gmtime
, _gmtime32
, _gmtime64
localtime
, _localtime32
, _localtime64
time
, _time32
, _time64
_tzset
asctime_s
, _wasctime_s
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk