_ftime_s, _ftime32_s, _ftime64_s

Makale
03/27/2013

Geçerli zaman alır.Bunlar sürümleridir _ftime, _ftime32, _ftime64 açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

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

Sıfır başarılı olursa, hata durumunda bir hata kodu.If timeptr is NULL, the return value is EINVAL.

Notlar

_ftime_s İşlevi geçerli yerel saattir alır ve göre sıralanmasını yapısında saklar 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 olmayan.(Bkz: _tzset için bir açıklama günışığından yararlanma saati nasıl belirlenir.)
millitm
Saniyenin milisaniye olarak verin.
time
Gece yarısından itibaren saniye (00: 00), 1 Ocak 1970'den itibaren Eşgüdümlü Evrensel Saat (utc).
timezone
utc ve yerel saat westward, taşıma dakika cinsinden fark.Değeri timezone genel değişken değeri ayarlamak _timezone (bkz: _tzset).

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

_ftime_seşittir _ftime64_s ve _timeb 64-bit saati içerir.Bu doğrudur sürece _USE_32BIT_TIME_T , bu durumda eski davranışı; yürürlükte tanımlanır _ftime_s bir 32-bit kullanır ve _timeb 32-bit saati içerir.

_ftime_sparametrelerinin geçerliliğini denetler.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.Yürütülmesine devam etmek için izin verilirse, işlevi ayarlar errno için EINVAL.

Gereksinimler

İşlev	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 bilgileri için bkz: Uyumluluk giriş.

Kitaplıkları

Tüm sürümleri c çalışma zamanı kitaplıkları.

Ö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] );
}