gmtime, , _gmtime32_gmtime64

time_t Mengonversi nilai waktu menjadi tm struktur. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat gmtime_s, _gmtime32_s, _gmtime64_s.

Sintaks

struct tm *gmtime( const time_t *sourceTime );
struct tm *_gmtime32( const __time32_t *sourceTime );
struct tm *_gmtime64( const __time64_t *sourceTime );

Parameter

sourceTime
Arahkan ke waktu tersimpan. Waktu dinyatakan sebagai detik yang berlalu sejak tengah malam (00:00:00), 1 Januari 1970, waktu universal terkoordinasi (UTC).

Nilai hasil

Penunjuk ke struktur jenis tm. Bidang struktur yang dikembalikan menyimpan nilai argumen yang sourceTime dievaluasi dalam UTC daripada di waktu lokal. Masing-masing bidang struktur berjenis int, sebagai berikut:

Bidang	Deskripsi
tm_sec	Detik demi menit (0 - 59).
tm_min	Menit demi jam (0 - 59).
tm_hour	Jam sejak tengah malam (0 - 23).
tm_mday	Hari dalam sebulan (1 - 31).
tm_mon	Bulan (0 - 11; Januari = 0).
tm_year	Tahun (tahun berjalan minus 1900).
tm_wday	Hari dalam seminggu (0 - 6; Minggu = 0).
tm_yday	Hari dalam setahun (0 - 365; 1 Januari = 0).
tm_isdst	Selalu 0 untuk gmtime.

Baik versi 32-bit dan 64-bit dari gmtime, mktime, mkgmtime, dan localtime semuanya menggunakan satu struktur umum tm per utas untuk konversi. Setiap panggilan ke salah satu fungsi ini menghancurkan hasil panggilan sebelumnya. Jika sourceTime menunjukkan tanggal sebelum tengah malam, 1 Januari 1970, gmtime mengembalikan NULL. Tidak ada pengembalian kesalahan.

_gmtime64, yang menggunakan __time64_t struktur, memungkinkan tanggal dinyatakan hingga 23:59:59, 31 Desember 3000, UTC. _gmtime32 hanya mewakili tanggal hingga 23:59:59 18 Januari 2038, UTC. Tengah malam, 1 Januari 1970, adalah batas bawah rentang tanggal untuk kedua fungsi.

gmtime adalah fungsi sebaris yang mengevaluasi ke _gmtime64, dan time_t setara dengan __time64_t kecuali _USE_32BIT_TIME_T didefinisikan. Jika Anda harus memaksa pengkompilasi untuk menafsirkan time_t sebagai 32-bit time_tlama, Anda dapat menentukan _USE_32BIT_TIME_T, tetapi melakukannya menyebabkannya gmtime sejajar _gmtime32 dan time_t didefinisikan sebagai __time32_t. Kami tidak merekomendasikan penggunaan _USE_32BIT_TIME_T, karena tidak diizinkan pada platform 64-bit. Bagaimanapun, aplikasi Anda mungkin gagal setelah 18 Januari 2038.

Fungsi-fungsi ini memvalidasi parameternya. Jika sourceTime adalah NULL penunjuk, atau jika sourceTime nilainya negatif, 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.

Keterangan

Fungsi _gmtime32 memecah sourceTime nilai dan menyimpannya dalam struktur jenis tmyang dialokasikan secara statis , yang ditentukan dalam TIME.H. Nilai sourceTime biasanya diperoleh dari panggilan ke time fungsi.

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

Persyaratan

Rutin	Header C yang diperlukan	Header C++ yang diperlukan
gmtime, , _gmtime32_gmtime64	<time.h>	<ctime> atau <time.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// crt_gmtime.c
// compile with: /W3
// This program uses _gmtime64 to convert a long-
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime to
// convert this structure to an output string.

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

int main(void)
{
   struct tm *newtime;
   __int64 ltime;
   char buff[80];

   _time64( &ltime );

   // Obtain coordinated universal time:
   newtime = _gmtime64( &ltime ); // C4996
   // Note: _gmtime64 is deprecated; consider using _gmtime64_s
   asctime_s( buff, sizeof(buff), newtime );
   printf( "Coordinated universal time is %s\n", buff );
}

Coordinated universal time is Tue Feb 12 23:11:31 2002

Lihat juga

Manajemen waktu
asctime, _wasctime
ctime, , _ctime32_ctime64, _wctime, , _wctime32,_wctime64
_ftime, , _ftime32_ftime64
gmtime_s, , _gmtime32_s_gmtime64_s
localtime, , _localtime32_localtime64
_mkgmtime, , _mkgmtime32_mkgmtime64
mktime, , _mktime32_mktime64
time, , _time32_time64