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 timefungsi , _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 aclockpanjang , 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