---
name: "Test2::Util::Times"
section: "3p"
platform: "openbsd"
package: "man"
version: "8.0-current-20261101"
release: "OpenBSD 8.0-current (2026-11-01)"
platforms: ["openbsd"]
url: "https://new.carta.tech/Test2::Util::Times"
---

# Test2::Util::Times(3p)

Format timing/benchmark information.

## NAME

Test2::Util::Times - Format timing/benchmark information.

## DESCRIPTION

This modules exports tools for rendering timing data at the end of tests.

## EXPORTS

All exports are optional. You must specify subs to import.

- $str = render\_bench($start, $end, $user, $system, $cuser, $csystem)

  - $str = render\_bench($start, **time()**, **times()**)

  This will produce a string like one of these (Note these numbers are completely made up). *Which string is used depends on the time elapsed.*

  ```
      0.12345s on wallclock (0.05 usr 0.00 sys + 0.00 cusr 0.00 csys = 0.05 CPU)
      11.1234s on wallclock (0.05 usr 0.00 sys + 0.00 cusr 0.00 csys = 0.05 CPU)
      01m:54.45s on wallclock (0.05 usr 0.00 sys + 0.00 cusr 0.00 csys = 0.05 CPU)
      18h:22m:54.45s on wallclock (0.05 usr 0.00 sys + 0.00 cusr 0.00 csys = 0.05 CPU)
      04d:18h:22m:54.45s on wallclock (0.05 usr 0.00 sys + 0.00 cusr 0.00 csys = 0.05 CPU)
  ```

  The first 2 arguments are the `$start` and `$end` times in seconds (as returned by `time()` or `Time::HiRes::time()`).

  The last 4 arguments are timing information as returned by the `times()` function.

## SOURCE

The source code repository for Test2-Suite can be found at *https://github.com/Test-More/test-more/*.

## MAINTAINERS

- Chad Granum \<exodist@cpan.org\>

  ## AUTHORS

- Chad Granum \<exodist@cpan.org\>

  ## COPYRIGHT

Copyright Chad Granum \<exodist@cpan.org\>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See *http://dev.perl.org/licenses/*