_ftime_s, _ftime32_s, _ftime64_s

Makale
06/09/2015

Geçerli zamanı alır.Bu _ftime, _ftime32, _ftime64 sürümlerinde CRT'deki Güvenlik Özellikleri içinde açıklandığı gibi güvenlik geliştirmeleri mevcut olabilir.

errno_t _ftime_s( 
   struct _timeb *timeptr 
);
errno_t _ftime32_s( 
   struct __timeb32 *timeptr 
);
errno_t _ftime64_s( 
   struct __timeb64 *timeptr 
);

Parametreler

timeptr
Pointer to a _timeb,__timeb32, or __timeb64 structure.

Dönüş Değeri

Başarılıysa sıfır; hata halinde bir hata kodu.If timeptr is NULL, the return value is EINVAL.

Notlar

_ftime_s İşlevi tarafından işaret yapısında saklar ve geçerli yerel saattir alır timeptr*.* The _timeb,__timeb32,and__timeb64 structures are defined in SYS\Timeb.h.Bunlar aşağıdaki tabloda listelenen dört alan içerir.

dstflag
Günışığından yararlanma saati şu an için yerel saat dilimi etkinse, sıfır. (Bkz: _tzset için bir açıklama günışığından yararlanma saati nasıl belirlenir.)
millitm
Kesirli saniye milisaniye cinsinden.
time
Gece yarısından itibaren saniye (00:00), 1 Ocak 1970, Eşgüdümlü Evrensel Saat (UTC).
timezone
Dakika cinsinden UTC ve yerel saat westward, taşıma fark.Değeri timezone genel değişkeni değerini ayarla _timezone (bkz: _tzset).

_ftime64_s, kullanan __timeb64 yapısı, dosya oluşturma tarihlerinin 23:59:59 31 Aralık 3000 UTC; yukarı ifade verir Oysa _ftime32_s yalnızca aracılığıyla 03:14:07 19 Ocak 2038 UTC tarih temsil eder.Gece yarısı, 1 Ocak 1970 tarih aralığı bu işlevler için alt sınırdır.

_ftime_seşdeğer olan _ftime64_s ve _timeb 64-bit saati içerir.Böyle sürece _USE_32BIT_TIME_T , bu durumda eski davranışı; etkindir tanımlıdır _ftime_s bir 32-bit kullanır ve _timeb 32-bit saati içerir.

_ftime_s parametrelerini doğrular.Bir null işaretçi olarak aktarılırsa timeptr, açıklandığı gibi geçersiz bir parametre işleyici işlevi çağırır Parametre Doğrulama.İşlev yürütülmesine devam etmek için izin verilirse, ayarlar errno için EINVAL.

Gereksinimler

Function	Gerekli başlık
_ftime_s	<sys/Types.h> ve <sys/timeb.h>
_ftime32_s	<sys/Types.h> ve <sys/timeb.h>
_ftime64_s	<sys/Types.h> ve <sys/timeb.h>

Daha fazla uyumluluk bilgisi için Giriş altındaki Uyumluluk bölümüne bakın.

Kitaplıklar

C çalışma zamanı kitaplıklarının çoklu iş parçacığının tüm sürümleri.

Örnek

// crt_ftime64_s.c
// This program uses _ftime64_s to obtain the current
// time and then stores this time in timebuffer.

#include <stdio.h>
#include <sys/timeb.h>
#include <time.h>

int main( void )
{
   struct _timeb timebuffer;
   char timeline[26];
   errno_t err;
   time_t time1;
   unsigned short millitm1;
   short timezone1;
   short dstflag1;

   _ftime64_s( &timebuffer );

    time1 = timebuffer.time;
    millitm1 = timebuffer.millitm;
    timezone1 = timebuffer.timezone;
    dstflag1 = timebuffer.dstflag;

   printf( "Seconds since midnight, January 1, 1970 (UTC): %I64d\n", 
   time1);
   printf( "Milliseconds: %d\n", millitm1);
   printf( "Minutes between UTC and local time: %d\n", timezone1);
   printf( "Daylight savings time flag (1 means Daylight time is in "
           "effect): %d\n", dstflag1); 
   
   err = ctime_s( timeline, 26, & ( timebuffer.time ) );
   if (err)
   {
       printf("Invalid argument to ctime_s. ");
   }
   printf( "The time is %.19s.%hu %s", timeline, timebuffer.millitm,
           &timeline[20] );
}