timespec_get、_timespec32_get、_timespec64_get

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

使用第一個引數，依據指定的時間基礎，將間隔設定成指向目前的月曆時間。

語法

int timespec_get(  
    struct timespec* const time_spec,  
    int const base  
);  
int _timespec32_get(  
    struct _timespec32* const time_spec,  
    int const base  
);  
int _timespec64_get(  
    struct _timespec64* const time_spec,  
    int const base  
);  
  

參數

time_spec
設定為自 Epoch 啟動後所經歷之時間 (以秒及奈秒為單位) 的結構指標。

base
非零實作的專用值，會指定時間依據。

傳回值

若成功，會傳回 base 的值，否則會傳回零。

備註

timespec_get 函式會透過 time_spec 引數，將指向的結構設為目前的時間。 此結構的所有版本皆具有 tv_sec 與 tv_nsec兩個成員。 tv_sec 值會設為自 tv_nsec 指定之 Epoch 啟動之後所經歷的秒數 (整數)，而 base值則會設為奈秒數 (整數)，並四捨五入到系統時鐘的解析度。

Microsoft 特定的

這些函式只可以 TIME_UTC 的 base 值提供支援。 這會將 time_spec 值設定為自 Epoch 啟動之後 (國際標準時間 (UTC) 1970 年 1 月 1 日的午夜) 所經歷的秒數與奈秒數。 在 struct _timespec32中， tv_sec 為 __time32_t 值。 在 struct _timespec64中， tv_sec 為 __time64_t 值。 在 struct timespec, ， tv_sec 為 time_t 類型，其長度為 32 位元或 64 位元，取決於有無定義前置處理器巨集 _USE_32BIT_TIME_T。 timespec_get 函式是內嵌函式。如有定義 _USE_32BIT_TIME_T，將會呼叫 _timespec32_get ，否則會呼叫 _timespec64_get。

End Microsoft 特定的

需求

如需其他相容性資訊，請參閱 相容性。

另請參閱

時間管理
asctime、 _wasctime
asctime_s、 _wasctime_s
_ftime、 _ftime32、 _ftime64
gmtime、 _gmtime32、 _gmtime64
gmtime_s、 _gmtime32_s、 _gmtime64_s
localtime、 _localtime32、 _localtime64
localtime_s、 _localtime32_s、 _localtime64_s
time、 _time32、 _time64
_utime、 _utime32、 _utime64、 _wutime、 _wutime32、 _wutime64