digitalrevolution / intl
Digital Revolution Internationalization library
Installs: 20 044
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 0
Forks: 4
Open Issues: 2
Requires
- php: >=8.1
- ext-intl: *
- giggsey/libphonenumber-for-php-lite: ^8.13.11
- moneyphp/money: ^3.3 || ^4.0
Requires (Dev)
- digitalrevolution/accessorpair-constraint: 2.1.7
- digitalrevolution/phpunit-file-coverage-inspection: ^v1.0
- phpmd/phpmd: @stable
- phpstan/extension-installer: ^1.1
- phpstan/phpstan: ^1.4
- phpstan/phpstan-phpunit: ^1.0
- phpstan/phpstan-strict-rules: ^1.1
- phpunit/phpunit: ^9.5
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.6
This package is auto-updated.
Last update: 2024-11-11 07:59:06 UTC
README
Digital Revolution Internationalization
Library to format Numbers, Dates, \Money\Money objects and currencies to string according to the locale.
Getting Started
composer require digitalrevolution/intl
Usage
NumberFormatService
Format number and currencies
use DR\Internationalization\Currency\CurrencyFormatOptions; use DR\Internationalization\Number\NumberFormatOptions; use DR\Internationalization\NumberFormatService; use Money\Money; // set default configuration $currencyOptions = (new CurrencyFormatOptions()) ->setLocale('nl_NL') ->setCurrencyCode('EUR') ->setGrouping(false); $numberOptions = (new NumberFormatOptions()) ->setLocale('nl_NL') ->setDecimals(2) ->setTrimDecimals(true); $service = new NumberFormatService($currencyOptions, $numberOptions);
Format currencies:
$service->currency(1500.5); // output: € 1500,50 $service->currency(new Money('150050', new Currency('EUR'))); // output: € 1500,50 $service->currency(1500.5, (new CurrencyFormatOptions())->setGrouping(true)); // output: € 1.500,50
Format numbers:
$service->number(1500.5); // output: 1500,50 $service->number(1500.5, (new NumberFormatOptions())->setGrouping(true)); // output: 1.500,50 $service->number(1500.0, (new NumberFormatOptions())->setTrimDecimals(NumberFormatOptions::TRIM_DECIMAL_ALL_OR_NOTHING)); // output: 1500 $service->number(1500.5, (new NumberFormatOptions())->setTrimDecimals(NumberFormatOptions::TRIM_DECIMAL_ALL_OR_NOTHING)); // output: 1500.50 $service->number(1500.5, (new NumberFormatOptions())->setTrimDecimals(NumberFormatOptions::TRIM_DECIMAL_ANY)); // output: 1500.5
NumberParser
Parse float number from string determining the user's input for thousands and decimals separator.
NumberParser::parseFloat('1050'); // output: 1050.0 NumberParser::parseFloat('1050.5'); // output: 1050.5 NumberParser::parseFloat('1050,5'); // output: 1050.5 NumberParser::parseFloat('1.050,5'); // output: 1050.5 NumberParser::parseFloat('1,050.5'); // output: 1050.5 NumberParser::parseFloat('1,000,050.5'); // output: 1000050.5
DateFormatService
Formats dates and times. Input can be timestamps, strings (compatible with strtotime) and DateTimeInterface objects
$dateFormatter = new DateFormatService('nl_NL', date_default_timezone_get()); $dateFormatter->format(time(), 'eeee dd LLLL Y - HH:mm:ss'); // example output: zaterdag 02 juni 2040 - 05:57:02 $dateFormatter->format('next saturday', 'eeee dd LLLL Y - HH:mm:ss'); // example output: zaterdag 02 juni 2040 - 05:57:02 $dateFormatter->format(new DateTime(), 'eeee dd LLLL Y - HH:mm:ss'); // example output: zaterdag 02 juni 2040 - 05:57:02
DayOfTheWeekFormatter
Format the PHP Date day of the week to string
$formatter = new DayOfTheWeekFormatter('nl_NL'); $formatter->format(DayOfTheWeekFormatter::MONDAY); // output: maandag $formatter->format(DayOfTheWeekFormatter::MONDAY, 'en_US'); // output: Monday
PhoneNumberFormatService
Format phoneNumbers
use DR\Internationalization\PhoneNumber\PhoneNumberFormatOptions; use DR\Internationalization\PhoneNumberFormatService; // set default configuration $phoneNumberOptions = (new PhoneNumberFormatOptions()) ->setDefaultCountryCode('NL') ->setFormat(PhoneNumberFormatOptions::FORMAT_INTERNATIONAL_DIAL); $service = new PhoneNumberFormatService($phoneNumberOptions); $service->format("+31612345678"); // output: 0031612345678 $service->format("0612345678"); // output: 0031612345678
PhoneNumberParseService
use DR\Internationalization\PhoneNumberParseService; $parseService = new PhoneNumberParseService("NL"); $parsedPhoneNumber = $parseService->parse("+31612345678");
Project structure
Development
Run code quality checks:
composer run check
Run unit tests:
composer run test
About us
At 123inkt (Part of Digital Revolution B.V.), every day more than 50 development professionals are working on improving our internal ERP and our several shops. Do you want to join us? We are looking for developers.