pacely/pronto

Smart time parser

Simple time converter

, _(*1)

• Installation
• Registering the Package
• Formatters
• Helper methods

Installation

Add pronto to your composer.json file:, _(*2)

"require": {
  "pacely/pronto": "dev-master"
}

Use composer to install this package., _(*3)

$ composer update

Registering the Package

If you are using Laravel Framework, we've made a Service Provider and Facade for you., _(*4)

Register the service provider within the providers array found in app/config/app.php:, _(*5)

'providers' => array(
    // ...

    'Pacely\Pronto\ProntoServiceProvider'
)

Add an alias within the aliases array found in app/config/app.php:, _(*6)

'aliases' => array(
    // ...

    'Pronto' => 'Pacely\Pronto\Facades\Pronto',
)

Formatters

Integer

Matches integers only. <=9 converts to hours, >9 converts to minutes., _(*7)

echo Pronto::parse(10)->toTime(); // 09:00
echo Pronto::parse(9)->toTime(); // 00:10

Decimal

Matches decimal values (float, double). Comma and period characters allowed., _(*8)

echo Pronto::parse('0,5')->toTime(); // 00:30
echo Pronto::parse(1.5)->toTime(); // 01:30

Range

Matches time range., _(*9)

echo Pronto::parse('09-10')->toTime(); // 01:00
echo Pronto::parse('09:00 - 10:00')->toTime(); // 01:00
echo Pronto::parse('09:00-')->toTime(); // Time between 09:00 and NOW

Short

Matches short-time from m(minutes) to w(week). 1 day equals 7.5 hours. 1 week equals 5 days., _(*10)

echo Pronto::parse('1d 2h 30m')->toTime(); // 10:00
echo Pronto::parse('2 h 2 m')->toTime(); // 02:02
echo Pronto::parse('1w 2d 20m')->toTime(); // 52:50

Helper methods

(int) parse(string)

Returns converted time in seconds, _(*11)

$pronto = new Pronto;

echo $pronto->parse('0.5'); // 1800

(int) toMinutes()

Converts seconds to minutes, _(*12)

echo $pronto->parse('0.5')->toMinutes(); // 30

(double) toDecimal()

Converts seconds to decimal hours, _(*13)

echo $pronto->parse('2h 30m')->toDecimal(); // 2.5

(string) toTime()

Returns converted time the format HH:mm, _(*14)

echo $pronto->parse('0.5')->toTime(); // 00:30