PHPackages                             iarcadia/time - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. iarcadia/time

ActiveLibrary[Utility & Helpers](/categories/utility)

iarcadia/time
=============

A PHP time/duration library... again.

1.0.1(6y ago)012MITPHP

Since Jan 2Pushed 4y ago1 watchersCompare

[ Source](https://github.com/iArcadia/time)[ Packagist](https://packagist.org/packages/iarcadia/time)[ RSS](/packages/iarcadia-time/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (2)Dependencies (1)Versions (4)Used By (0)

Time
====

[](#time)

Introduction
------------

[](#introduction)

***Time*** is A **PHP** time/duration library... again.

Currently, the library supports:

- Hours
- Minutes
- Seconds
- Milliseconds (+ Hundredth/Tenth of second)

The objective of this library is first to have something not related to dates at all, then to be light and simple.

Usage
-----

[](#usage)

### Instantiation

[](#instantiation)

With the `new` keyword:

```
$time = new Time;
```

With the static method `create`:

```
$time = Time::create();
```

The given arguments are the same for both methods:

```
// true
new Time(56400) === Time::create(56400)

// true
new Time(0, 0, 56, 400) === Time::create(0, 0, 56, 400)

// true
new Time(56400) === Time::create(0, 0, 56, 400)
```

The static method will be used for the rest of the readme.

#### Time::create($h, $i, $s, $v)

[](#timecreateh-i-s-v)

```
/**
* @param int|float $h - Hours
* @param int|float $i - Minutes
* @param int|float $s - Seconds
* @param int|float $v - Milliseconds
*
* @return iarcadia\time\Time
*/
```

##### Examples

[](#examples)

Creating a Time of 17 hours and 19 minutes:

```
$time = Time::create(17, 19, 0, 0);
```

Creating a Time of 45 minutes, 12 seconds and 476 ms:

```
$time = Time::create(0, 45, 12, 476);
```

#### Time::create($int\_or\_float)

[](#timecreateint_or_float)

```
/**
* @param int|float $int_or_float = 0 - Starting timestamp
*
* @return iarcadia\time\Time
*/
```

##### Examples

[](#examples-1)

Creating a Time of 45 minutes, 12 seconds and 476 ms:

```
$time = Time::create(2712476)
```

### Formating

[](#formating)

The `format()` method is available to format and write your Time instance:

```
/**
* @param string $format = '-h\h iim ss\s vvv'
*
* @return string
*/
```

Also, here's the characters or groups of characters which are going to be formated:

- `-` will appear if the time is negative
- `h` into hours
- `ii` into minutes with leading zero
- `i` into minutes
- `ss` into seconds with leading zero
- `s` into seconds
- `d` into tenth of seconds
- `cc` into hundredth of seconds with leading zero
- `c` into hundredth of seconds
- `vvv` into milliseconds with leading zero(s)
- `v` into milliseconds

Avoid a character to be translated by making it preceded by an antislash.

#### Examples

[](#examples-2)

```
$time = Time::create(1, 56, 4, 235);

// Write 1h 56m 04s 235
echo $time->format();
echo $time;

// Writes 1:56:04.235
echo $time->format('h:ii:ss.vvv');

// Writes 4 seconds and 235 ms
echo $time->format('s \se\con\d\s an\d vvv m\s');

// Write 04.2
echo $time->format('ss.d');
```

### Getters & Setters

[](#getters--setters)

The library proposes to you two different kinds of getters, the classic ones and the total.

The classics will give you the capped int values, but the hours. Minutes won't be over 59 and milliseconds over 999.

The total getters will give you a float value.

The getters also can all be used with magic attributes.

```
$time = Time::create(2, 12, 32, 489);

// Write 2
echo $time->getHours();
echo $time->hours;

// Write 2.20
echo $time->getTotalHours();
echo $time->total_hours;

// Write 12
echo $time->getMinutes();
echo $time->minutes;

// Write 132.54
echo $time->getTotalMinutes();
echo $time->total_minutes;

// Write 32
echo $time->getSeconds();
echo $time->seconds;

// Write 7952.48
echo $time->getTotalSeconds();
echo $time->total_seconds;

// Write 4
echo $time->getTenthOfSeconds();
echo $time->tenth_of_seconds;

// Write 79524.89
echo $time->getTotalTenthOfSeconds();
echo $time->total_tenth_of_seconds;

// Write 48
echo $time->getHundredthOfSeconds();
echo $time->hundredth_of_seconds;

// Write 795248.9
echo $time->getTotalHundredthOfSeconds();
echo $time->total_hundredth_of_seconds;

// Write 489
echo $time->getMilliseconds();
echo $time->milliseconds;

// Write 7952489
echo $time->getTotalMilliseconds();
echo $time->total_milliseconds;
```

The setters will override the current timestamp of the Time instance.

They are also available as magic attributes.

```
$time = Time::create(2, 12, 32, 489);

// Write 1h 30m 00s 000
$time->setTotalHours(1.5);
$time->total_hours = 1.5;
echo $time;

// Write 0h 30m 15s 000
$time->setTotalMinutes(30.25);
$time->total_minutes = 30.25;
echo $time;

// Write 0h 01m 15s 000
$time->setTotalSeconds(75);
$time->total_seconds = 75;
echo $time;

// Write 0h 00m 48s 600
$time->setTotalTenthOfSeconds(486);
$time->total_tenth_of_seconds = 486;
echo $time;

// Write 0h 01m 29s 610
$time->setTotalHundredthOfSeconds(8961);
$time->total_hundredth_of_seconds = 8961;
echo $time;

// Write 0h 02m 05s 658
$time->setTotalMilliseconds(125658);
$time->total_milliseconds = 125658;
echo $time;
```

### Negative times

[](#negative-times)

Time instances can be negative at creation, just instantiate it with a negative timestamp.

```
// Write -1h 35m 30s 210
$time = Time::create(-5703210);
echo $time;
```

Be aware that using `Time::create()` with 4 arguments will not work as intented for a negative time.

### Operations

[](#operations)

Additions and substractions are possible with this library by using `Time#addX()` and `Time#subX()` methods.

```
// Write 2h 49m 23s 486
$time = Time::create(60000);
$time
    ->addHours(2)
    ->addMinutes(48)
    ->addSeconds(23)
    ->addMilliseconds(486);
echo $time;
```

You can also do these operations with other Time instances thanks to `Time#addFromTime()` and `Time#subFromTime()`.

```
// Write 0h 02m 15s 000
$time1 = Time::create(60000);
$time2 = Time::create(85000);
$time1->addFromTime($time2);
echo $time;

// Write 0h 01m 00s 000
$time1->subFromTime($time2);
echo $time;
```

Finally, shortcut methods exist : `Time#add()` and `Time#sub()`. These two methods accept many arguments at once, and accept integer/float values and Time object.

If 4 arguments are given, it will add/substract the same way as the instantiation with 4 arguments.

```
// Write 0h 02m 15s 154
$time1 = Time::create(60000);
$time2 = Time::create(85000);
$time1->add($time2, 154);
echo $time;

// Write 0h 00m 00s 000
$time1->sub(0, 2, 15, 154);
echo $time;
```

The library proposes the `Time#diff()` and `Time::diffBetween()` methods to calculate difference between to times.

This feature is quite the same as `Time#sub()`, the only difference is that they return a new Time instance.

### Comparisons

[](#comparisons)

You can compare two times by using comparison methods.

```
$time1 = Time::create(1, 50, 0, 0);
$time2 = Time::create(3, 0, 24, 0);

// false
$time1->isEqualTo($time2);
$time1->eq($time2);

// true
$time1->isNotEqualTo($time2);
$time1->neq($time2);

// false
$time1->isGreaterThan($time2);
$time1->gt($time2);
$time1->isGreaterThanOrEqualTo($time2);
$time->gteq($time2);

// true
$time1->isLessThan($time2);
$time1->lt($time2);
$time1->isLessThanOrEqualTo($time2);
$time->lteq($time2);
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

3

Last Release

2323d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0cff9d129ded6d43ac69f8862744e7ed9359f39f3c2bb89c49d736c94a4b483a?d=identicon)[iArcadia](/maintainers/iArcadia)

---

Top Contributors

[![iArcadia](https://avatars.githubusercontent.com/u/25928721?v=4)](https://github.com/iArcadia "iArcadia (10 commits)")

### Embed Badge

![Health badge](/badges/iarcadia-time/health.svg)

```
[![Health](https://phpackages.com/badges/iarcadia-time/health.svg)](https://phpackages.com/packages/iarcadia-time)
```

###  Alternatives

[components/jqueryui

jQuery UI is a curated set of user interface interactions, effects, widgets, and themes built on top of the jQuery JavaScript Library. Whether you're building highly interactive web applications or you just need to add a date picker to a form control, jQuery UI is the perfect choice.

1795.8M57](/packages/components-jqueryui)[clue/graph-composer

Dependency graph visualization for composer.json

93798.0k11](/packages/clue-graph-composer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)