PHP code example of utecca / number

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

utecca / number example snippets

// Init via constructor
new Number(123.456);

// Init via static method
Number::of('123.45');

// Force a certain number of decimals
Number::of('123.45', 1); // Will return 123.5

// Init from a value in cents
Number::fromCents(12345); // Will return 123.45

protected $casts = [
    // Amount with two decimals (usually used for monetary values) 
    'amount' => Utecca\Number\Casts\NumberFromDecimal::class,
    // Amount with a custom number of decimals
    'quantity' => Utecca\Number\Casts\NumberFromDecimal::class . ':4'),
];

// Addition
$number->add(100);

// Subtraction
$number->sub(100);

// Multiplication
$number->mul(100);

// Division
$number->div(100);

// Percentage
$number->percent(50);

// Round
$number->round(2);

// Floor
$number->floor();

// Ceil
$number->ceil();

// Absolute
$number->abs();

// Extracts and returns the absolute decimal part of the number, eg. 123.45 wil return 0.45
Number::of(123.45)->decimalFraction(); // Returns 0.45

// Conditional negation
Number::of(123.45)->negate(); // Returns -123.45
Number::of(123.45)->negate(false); // Returns 123.45

// Exchange rate conversion
Number::of(123.45)->exchangeWithRate(745.5); // Returns 920.31

// Min
Number::min([
    Number::of(123.45),
    Number::of(100),
]); // Returns 100.00

// Max
Number::max([
    Number::of(123.45),
    Number::of(100),
]); // Returns 123.45

// Various getters
$number->isZero();
$number->isPositive();
$number->isPositiveOrZero();
$number->isNegative();
$number->isNegativeOrZero();
$number->lt(100);
$number->lte(100);
$number->gt(100);
$number->gte(100);
$number->eq(100);

// Various formatters
$number->toString();
$number->toInt();
$number->inCents(); // Only works if the number has two decimals or less