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_t
lama, 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 tm
yang 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( <ime );
// Obtain coordinated universal time:
newtime = _gmtime64( <ime ); // 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