Installation

System Requirements

PHP >= 8.4 is required but the latest stable version of PHP is recommended.

Installation

Tokei is available on Packagist and can be installed using Composer:

composer require bakame/tokei

You MAY need:

• The ext-intl extension or use a polyfill for IntlDateFormatter to be able to get the locale string version of the time.

Principles

The framework-agnostic package offers a consistent and expressive way to work with temporal values in a safe and predictable manner.

The package comes with the following Temporal classes under the Bakame\Tokei namespace:

Temporal Values

• Time
• Duration
• Interval
• IntervalSet

Annotation Values

• Identifiers

Annotated Temporal Values

• Event
• Task
• EventSet
• TaskSet

See also: Accepted Input Types for how values are converted between temporal representations.

Annotated temporal values extend the core temporal primitives by associating identifiers with them while preserving the same temporal semantics.

• Learn Time, Duration, Interval, IntervalSet first.
• Event, Task and TaskSet are enrichments, not separate models.
• Temporal logic lives in the primitives.
• Annotated values mostly add identification and context.