# std::chrono::abs(std::chrono::duration)

> C++ Atlas: `cppatlas.com/w/cpp/chrono/duration/abs` | Source: https://en.cppreference.com/w/cpp/chrono/duration/abs | Domain: Date and time utilities | Standards: C++11, C++17

Returns the absolute value of the duration d. Specifically, if d >= d.zero(), return d, otherwise return -d.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <chrono>

template< class Rep, class Period >
constexpr std::chrono::duration<Rep, Period> abs( std::chrono::duration<Rep, Period> d ); // (since C++17)
```

Returns the absolute value of the duration `d`. Specifically, if `d >= d.zero()`, return `d`, otherwise return `-d`.

The function does not participate in the overload resolution unless `std::numeric_limits<Rep>::is_signed` is `true`.

### Parameters

- `d` - duration

### Return value

Absolute value of `d`.

### Possible implementation

```cpp
template<class Rep, class Period,
    class = std::enable_if_t<std::numeric_limits<Rep>::is_signed>>
constexpr std::chrono::duration<Rep, Period> abs(std::chrono::duration<Rep, Period> d)
{
    return d >= d.zero() ? +d : -d;
}
```

### Example

```cpp
#include <chrono>
#include <iostream>

int main()
{
    using namespace std::chrono;

    static_assert(abs(-42s) == std::chrono::abs(42s));

    std::cout << "abs(+3min) = " << abs(3min).count() << '\n'
              << "abs(-3min) = " << abs(-3min).count() << '\n';
}
```

Output:

```text
abs(+3min) = 3
abs(-3min) = 3
```

### See also

- [`operator+`](https://en.cppreference.com/w/cpp/chrono/duration/operator_arith), [`operator-`](https://en.cppreference.com/w/cpp/chrono/duration/operator_arith): implements unary + and unary - (public member function)
- [`abs(int)`](https://en.cppreference.com/w/cpp/numeric/math/abs), [`labs`](https://en.cppreference.com/w/cpp/numeric/math/abs), [`llabs`](https://en.cppreference.com/w/cpp/numeric/math/abs) (C++11): computes absolute value of an integral value (|x|) (function)

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