timespec_get 子例程

用途

根据指定的时区检索当前日历时间。

库

标准 C 库 (libc.a)

语法

#include <time.h>

int timespec_get (struct timespec *ts, int base)
struct timespec *ts;
int base;

描述

timespec_get 子例程设置由 ts 参数指向的时间间隔，以根据指定的时区来保存当前日历时间。 时区由 base 参数指定。 ts 参数是一个指向 timespec 结构对象的指针，该对象包含一个时间间隔，该时间间隔细分为 tv_sec 属性指定的秒数和 tv_nsec 属性指定的纳秒。 timespec_get 子例程使用 tv_sec 属性和 tv_nsec 属性的值来设置 ts 参数。

如果 base 参数的值为 TIME_UTC (其中 TIME_UTC 指定全球标准时间基准，并且它是大于 0 的整数常量) ，那么 tv_sec 属性的值将设置为自实现定义的戳记以来的秒数，并截断为整数。 tv_nsec 属性的值设置为整数纳秒，四舍五入为系统时钟的分辨率。

参数

返回值

如果成功， timespec_get 子例程将返回 base 参数的值。 如果不成功， timespec_get 子例程将返回 0。