tentwofour/formatter

Provides formatters for phone numbers, postal codes, etc.

Maintainers

Details

github.com/tentwofour/formatter

Homepage

Source

Issues

Installs: 1 372

Dependents: 2

Suggesters: 1

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

1.1.3 2022-01-24 15:44 UTC

Requires

  • php: ^7.0|^8.0

Requires (Dev)

MIT 71f69648e9b5da45a0d20b68c64b2d8a4ecf0e90

ten24tentwofourdata-transformations

This package is auto-updated.

Last update: 2024-04-24 20:16:37 UTC

README

MoneyFormatter

Formats from cents => dollars, and vice-versa. Useful for database storage of monetary values, without needing a decimal column.

PHP's Type Juggling deals with string arguments, which may lead to unexpected results.

MoneyFormatter::dollarsToCents(12.00);
// => 1200

MoneyFormatter::dollarsToCents(1200);
// => 12.00

PhoneNumberFormatter

Formats a phone number to a flattened string (eg. no separators of any kind), and back to a human-readable style again.

Current human-readable formats are N/A style (+%d (%d) %d-%d).

Useful for normalizing database stored values and allowing application-varied formatting.

$f = new PhoneNumberFormatter('+14239170989');

$formatted = $f->format()
// => +1 (423) 917-0989

$f->setPhoneNumber($formatted);
$reverse = $f->reverseFormat();
// => +14239170989

PostalCodeFormatter

Formats a postal code to a flattened representation, and back again. Supports US & Canadian postal codes.

Useful for normalizing database stored values and allowing application-varied formatting.

$f = new PostalCodeFormatter('H0H 0H0');

$formatted = $f->format()
// => h0h0h0 

$f->setPostalCode($formatted);
$reverse = $f->reverseFormat();
// => H0H 0H0