Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kevinkhill/php-duration
Convert durations of time between colon-formatted, human-readable, and seconds
https://github.com/kevinkhill/php-duration
duration hour minutes php seconds
Last synced: 12 days ago
JSON representation
Convert durations of time between colon-formatted, human-readable, and seconds
- Host: GitHub
- URL: https://github.com/kevinkhill/php-duration
- Owner: kevinkhill
- License: mit
- Created: 2015-03-18T01:20:47.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-11-03T08:44:09.000Z (about 1 year ago)
- Last Synced: 2024-04-04T07:46:17.346Z (7 months ago)
- Topics: duration, hour, minutes, php, seconds
- Language: PHP
- Homepage:
- Size: 51.8 KB
- Stars: 154
- Watchers: 6
- Forks: 26
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PHP-Duration
#### Convert durations between colon formatted time, human-readable time and seconds
[](https://packagist.org/packages/khill/php-duration)
[](http://opensource.org/licenses/MIT)
[](https://php.net/)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FLP6MYY3PYSFQ)
[](https://github.com/kevinkhill/php-duration/releases)
[](https://travis-ci.org/kevinkhill/php-duration)
[](https://coveralls.io/r/kevinkhill/php-duration?branch=master)
This package was created with a very specific goal in mind, to enable an easy way for users to input how long something took, as a duration of time.
The library can accept either in colon separated format, like 2:43 for 2 minutes and 43 seconds
OR
written as human readable or abbreviated time, such as 6m21s for 6 minutes and 21 seconds.
Both can be converted into seconds and minutes with precision for easy storage into a database.
Seconds, colon separated, abbreviated, all three can be parsed and interchanged.
- supports hours, minutes, and seconds (with microseconds)
- humanized input supports any form of the words "hour", "minute", "seconds"
- Example, you could input 1h4m2s or 4 Hr. 32 Min.
# Install
```bash
composer require khill/php-duration:~1.0
```
# Usage
```php
use Khill\Duration\Duration;
$duration = new Duration('7:31');
echo $duration->humanize(); // 7m 31s
echo $duration->formatted(); // 7:31
echo $duration->toSeconds(); // 451
echo $duration->toMinutes(); // 7.5166
echo $duration->toMinutes(null, 0); // 8
echo $duration->toMinutes(null, 2); // 7.52
```
```php
$duration = new Duration('1h 2m 5s');
echo $duration->humanize(); // 1h 2m 5s
echo $duration->formatted(); // 1:02:05
echo $duration->toSeconds(); // 3725
echo $duration->toMinutes(); // 62.0833
echo $duration->toMinutes(null, 0); // 62
```
```php
// Configured for 6 hours per day
$duration = new Duration('1.5d 1.5h 2m 5s', 6);
echo $duration->humanize(); // 1d 4h 32m 5s
echo $duration->formatted(); // 10:32:05
echo $duration->toSeconds(); // 37925
echo $duration->toMinutes(); // 632.083333333
echo $duration->toMinutes(null, 0); // 632
```
```php
$duration = new Duration('4293');
echo $duration->humanize(); // 1h 11m 33s
echo $duration->formatted(); // 1:11:33
echo $duration->toSeconds(); // 4293
echo $duration->toMinutes(); // 71.55
echo $duration->toMinutes(null, 0); // 72
```
# Note
You do not have to create a new object for each conversion, you can also pass any of the three forms into any of the methods to get the immediate output.
```php
$duration = new Duration;
echo $duration->humanize('1h 2m 5s'); // 1h 2m 5s
echo $duration->formatted('1h 2m 5s'); // 1:02:05
echo $duration->toSeconds('1h 2m 5s'); // 3725
echo $duration->toMinutes('1h 2m 5s'); // 62.0833
echo $duration->toMinutes('1h 2m 5s', true); // 62
```