Bagikan melalui

_strtime, _wstrtime

  • Artikel

Salin waktu ke buffer. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _strtime_s, _wstrtime_s.

Sintaks

char *_strtime(
   char *timestr
);
wchar_t *_wstrtime(
   wchar_t *timestr
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

Parameter

timestr
String waktu.

Nilai hasil

Mengembalikan penunjuk ke string timestrkarakter yang dihasilkan .

Keterangan

Fungsi _strtime menyalin waktu lokal saat ini ke dalam buffer yang ditujukkan oleh timestr. Waktu diformat sebagai hh:mm:ss, di mana hh adalah dua digit yang mewakili jam dalam notasi 24 jam. mm adalah dua digit untuk menit melewati jam, dan ss dua digit selama detik. Misalnya, string 18:23:44 mewakili 23 menit dan 44 detik setelah 6 P.M. Buffer harus panjangnya minimal 9 byte.

_wstrtime adalah versi karakter yang luas dari _strtime; argumen dan nilai yang dikembalikan adalah _wstrtime string karakter lebar. Fungsi-fungsi ini berulah secara identik jika tidak. Jika timestr adalah NULL penunjuk atau jika timestr diformat dengan salah, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika pengecualian diizinkan untuk melanjutkan, fungsi-fungsi ini mengembalikan NULL, dan diatur errno ke EINVAL jika timestr adalah NULL atau diatur errno ke ERANGE jika timestr diformat dengan salah.

Di C++, fungsi-fungsi ini memiliki kelebihan beban templat yang memanggil rekan-rekan yang lebih baru dan aman dari fungsi-fungsi ini. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.

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
_tstrtime _strtime _strtime _wstrtime

Persyaratan

Rutin Header yang diperlukan
_strtime <time.h>
_wstrtime <time.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// crt_strtime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}

The current time is 14:21:44

Lihat juga

Manajemen waktu
asctime, _wasctime
ctime, , _ctime32_ctime64, _wctime, , _wctime32,_wctime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
mktime, , _mktime32_mktime64
time, , _time32_time64
_tzset