# timespec_getres

> C++ Atlas: `cppatlas.com/w/c/chrono/timespec_getres` | Source: https://en.cppreference.com/w/c/chrono/timespec_getres | Domain: Date and time utilities | Standards: C11, C23

If ts is non-null and base is supported by timespec_get, modifies *ts to hold the resolution of time provided by timespec_get for base.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <time.h>
int timespec_getres( struct timespec *ts, int base ); // (since C23)
```

If `ts` is non-null and `base` is supported by `timespec_get`, modifies `*ts` to hold the resolution of time provided by `timespec_get` for `base`. For each supported `base`, multiple calls to `timespec_getres` during the same program execution have identical results.

### Parameters

- `ts` - pointer to an object of type `struct timespec`
- `base` - `TIME_UTC` or another nonzero integer value indicating the time base

### Return value

The value of `base` if `base` is supported, zero otherwise.

### Notes

The POSIX function `clock_getres(clock_id, ts)` may also be used to populate a `timespec` with the resolution of time identified by `clock_id`.

### Example

```c
#include <stdio.h>
#include <time.h>

int main(void)
{
    char buff[128];
    struct timespec ts;
    const int res = timespec_getres(&ts, TIME_UTC);
    if (res == TIME_UTC) {
        struct tm timer;
        strftime(buff, sizeof buff, "%D %T", gmtime_r(&ts.tv_sec, &timer));
        printf("Time resolution info: %s.%09ld UTC\n", buff, ts.tv_nsec);
    } else {
        printf("TIME_UTC base is not supported.");
    }
}
```

Possible output:

```text
Time resolution info: 01/01/70 00:00:00.000000001 UTC
```

### See also

- [`timespec`](https://en.cppreference.com/w/c/chrono/timespec) (C11): time in seconds and nanoseconds (struct)
- [`timespec_get`](https://en.cppreference.com/w/c/chrono/timespec_get) (C11): returns the calendar time in seconds and nanoseconds based on a given time base (function)
- [`time`](https://en.cppreference.com/w/c/chrono/time): returns the current calendar time of the system as time since epoch (function)

---
Attribution: content from https://en.cppreference.com/w/c/chrono/timespec_getres (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.