CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Reporting Security Issues
    • Privacy Policy
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Get Involved
    • Issues (Github)
    • Bakery
    • Featured Resources
    • Training
    • Meetups
    • My CakePHP
    • CakeFest
    • Newsletter
    • Linkedin
    • YouTube
    • Facebook
    • Twitter
    • Mastodon
    • Help & Support
    • Forum
    • Stack Overflow
    • IRC
    • Slack
    • Paid Support
CakePHP

C CakePHP 4.0 Strawberry API

  • Project:
    • CakePHP
      • CakePHP
      • Chronos
      • Elastic Search
      • Queue
  • Version:
    • 4.0
      • 5.1
      • 5.0
      • 4.5
      • 4.4
      • 4.3
      • 4.2
      • 4.1
      • 4.0
      • 3.10
      • 3.9
      • 3.8
      • 3.7
      • 3.6
      • 3.5
      • 3.4
      • 3.3
      • 3.2
      • 3.1
      • 3.0
      • 2.10
      • 2.9
      • 2.8
      • 2.7
      • 2.6
      • 2.5
      • 2.4
      • 2.3
      • 2.2
      • 2.1
      • 2.0
      • 1.3
      • 1.2

Namespaces

  • Global
  • Cake
    • Auth
    • Cache
    • Collection
    • Command
    • Console
    • Controller
    • Core
    • Database
    • Datasource
    • Error
    • Event
    • Filesystem
    • Form
    • Http
    • I18n
      • Formatter
      • Middleware
      • Parser
    • Log
    • Mailer
    • Network
    • ORM
    • Routing
    • Shell
    • TestSuite
    • Utility
    • Validation
    • View

Class Number

Number helper library.

Methods to make numbers more readable.

Namespace: Cake\I18n
Link: https://book.cakephp.org/4/en/core-libraries/number.html

Constants

  • int
    CURRENCY_ACCOUNTING ¶ 
    12

    ICU Constant for accounting format; not yet widely supported by INTL library. This will be able to go away once CakePHP minimum PHP requirement is 7.4.1 or higher. See UNUM_CURRENCY_ACCOUNTING in https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/unum_8h.html

  • string
    DEFAULT_LOCALE ¶ 
    'en_US'

    Default locale

  • string
    FORMAT_CURRENCY ¶ 
    'currency'

    Format type to format as currency

  • string
    FORMAT_CURRENCY_ACCOUNTING ¶ 
    'currency_accounting'

    Format type to format as currency, accounting style (negative numbers in parentheses)

Property Summary

  • $_defaultCurrency protected static
    string|null

    Default currency used by Number::currency()

  • $_defaultCurrencyFormat protected static
    string

    Default currency format used by Number::currency()

  • $_formatters protected static
    array

    A list of number formatters indexed by locale and type

Method Summary

  • _setAttributes() protected static

    Set formatter attributes

  • config() public static

    Configure formatters.

  • currency() public static

    Formats a number into a currency format.

  • defaultCurrency() public static deprecated

    Getter/setter for default currency. This behavior is deprecated and will be removed in future versions of CakePHP.

  • format() public static

    Formats a number into the correct locale format

  • formatDelta() public static

    Formats a number into the correct locale format to show deltas (signed differences in value).

  • formatter() public static

    Returns a formatter object that can be reused for similar formatting task under the same locale and options. This is often a speedier alternative to using other methods in this class as only one formatter object needs to be constructed.

  • getDefaultCurrency() public static

    Getter for default currency

  • getDefaultCurrencyFormat() public static

    Getter for default currency format

  • ordinal() public static

    Returns a formatted integer as an ordinal number string (e.g. 1st, 2nd, 3rd, 4th, [...])

  • parseFloat() public static

    Parse a localized numeric string and transform it in a float point

  • precision() public static

    Formats a number with a level of precision.

  • setDefaultCurrency() public static

    Setter for default currency

  • setDefaultCurrencyFormat() public static

    Setter for default currency format

  • toPercentage() public static

    Formats a number into a percentage string.

  • toReadableSize() public static

    Returns a formatted-for-humans file size.

Method Detail

_setAttributes() ¶ protected static 

_setAttributes(NumberFormatter $formatter, array $options = []): NumberFormatter

Set formatter attributes

Parameters
NumberFormatter $formatter

Number formatter instance.

array $options optional

See Number::formatter() for possible options.

Returns
NumberFormatter

config() ¶ public static 

config(string $locale, int $type = NumberFormatter::DECIMAL, array $options = []): void

Configure formatters.

Parameters
string $locale

The locale name to use for formatting the number, e.g. fr_FR

int $type optional

The formatter type to construct. Defaults to NumberFormatter::DECIMAL.

array $options optional

See Number::formatter() for possible options.

Returns
void

currency() ¶ public static 

currency(float|string $value, string|null $currency = null, array $options = []): string

Formats a number into a currency format.

Options

  • locale - The locale name to use for formatting the number, e.g. fr_FR
  • fractionSymbol - The currency symbol to use for fractional numbers.
  • fractionPosition - The position the fraction symbol should be placed valid options are 'before' & 'after'.
  • before - Text to display before the rendered number
  • after - Text to display after the rendered number
  • zero - The text to use for zero values, can be a string or a number. e.g. 0, 'Free!'
  • places - Number of decimal places to use. e.g. 2
  • precision - Maximum Number of decimal places to use, e.g. 2
  • pattern - An ICU number pattern to use for formatting the number. e.g #,##0.00
  • useIntlCode - Whether or not to replace the currency symbol with the international currency code.
Parameters
float|string $value

Value to format.

string|null $currency optional

International currency name such as 'USD', 'EUR', 'JPY', 'CAD'

array $options optional

Options list.

Returns
string

defaultCurrency() ¶ public static 

defaultCurrency(string|false|null $currency = null): string|null

Getter/setter for default currency. This behavior is deprecated and will be removed in future versions of CakePHP.

Parameters
string|false|null $currency optional

Default currency string to be used by {@link currency()} if $currency argument is not provided. If boolean false is passed, it will clear the currently stored value

Returns
string|null

format() ¶ public static 

format(float|string $value, array $options = []): string

Formats a number into the correct locale format

Options:

  • places - Minimum number or decimals to use, e.g 0
  • precision - Maximum Number of decimal places to use, e.g. 2
  • pattern - An ICU number pattern to use for formatting the number. e.g #,##0.00
  • locale - The locale name to use for formatting the number, e.g. fr_FR
  • before - The string to place before whole numbers, e.g. '['
  • after - The string to place after decimal numbers, e.g. ']'
Parameters
float|string $value

A floating point number.

array $options optional

An array with options.

Returns
string

formatDelta() ¶ public static 

formatDelta(float|string $value, array $options = []): string

Formats a number into the correct locale format to show deltas (signed differences in value).

Options

  • places - Minimum number or decimals to use, e.g 0
  • precision - Maximum Number of decimal places to use, e.g. 2
  • locale - The locale name to use for formatting the number, e.g. fr_FR
  • before - The string to place before whole numbers, e.g. '['
  • after - The string to place after decimal numbers, e.g. ']'
Parameters
float|string $value

A floating point number

array $options optional

Options list.

Returns
string

formatter() ¶ public static 

formatter(array $options = []): NumberFormatter

Returns a formatter object that can be reused for similar formatting task under the same locale and options. This is often a speedier alternative to using other methods in this class as only one formatter object needs to be constructed.

Options

  • locale - The locale name to use for formatting the number, e.g. fr_FR
  • type - The formatter type to construct, set it to currency if you need to format numbers representing money or a NumberFormatter constant.
  • places - Number of decimal places to use. e.g. 2
  • precision - Maximum Number of decimal places to use, e.g. 2
  • pattern - An ICU number pattern to use for formatting the number. e.g #,##0.00
  • useIntlCode - Whether or not to replace the currency symbol with the international currency code.
Parameters
array $options optional

An array with options.

Returns
NumberFormatter

getDefaultCurrency() ¶ public static 

getDefaultCurrency(): string

Getter for default currency

Returns
string

getDefaultCurrencyFormat() ¶ public static 

getDefaultCurrencyFormat(): string

Getter for default currency format

Returns
string

ordinal() ¶ public static 

ordinal(int|float $value, array $options = []): string

Returns a formatted integer as an ordinal number string (e.g. 1st, 2nd, 3rd, 4th, [...])

Options

  • type - The formatter type to construct, set it to currency if you need to format numbers representing money or a NumberFormatter constant.

For all other options see formatter().

Parameters
int|float $value

An integer

array $options optional

An array with options.

Returns
string

parseFloat() ¶ public static 

parseFloat(string $value, array $options = []): float

Parse a localized numeric string and transform it in a float point

Options:

  • locale - The locale name to use for parsing the number, e.g. fr_FR
  • type - The formatter type to construct, set it to currency if you need to parse numbers representing money.
Parameters
string $value

A numeric string.

array $options optional

An array with options.

Returns
float

precision() ¶ public static 

precision(float|string $value, int $precision = 3, array $options = []): string

Formats a number with a level of precision.

Options:

  • locale: The locale name to use for formatting the number, e.g. fr_FR
Parameters
float|string $value

A floating point number.

int $precision optional

The precision of the returned number.

array $options optional

Additional options

Returns
string
Links
https://book.cakephp.org/4/en/core-libraries/number.html#formatting-floating-point-numbers

setDefaultCurrency() ¶ public static 

setDefaultCurrency(string|null $currency = null): void

Setter for default currency

Parameters
string|null $currency optional

Default currency string to be used by {@link currency()} if $currency argument is not provided. If null is passed, it will clear the currently stored value

Returns
void

setDefaultCurrencyFormat() ¶ public static 

setDefaultCurrencyFormat(string|null $currencyFormat = null): void

Setter for default currency format

Parameters
string|null $currencyFormat optional

Default currency format to be used by currency() if $currencyFormat argument is not provided. If null is passed, it will clear the currently stored value

Returns
void

toPercentage() ¶ public static 

toPercentage(float|string $value, int $precision = 2, array $options = []): string

Formats a number into a percentage string.

Options:

  • multiply: Multiply the input value by 100 for decimal percentages.
  • locale: The locale name to use for formatting the number, e.g. fr_FR
Parameters
float|string $value

A floating point number

int $precision optional

The precision of the returned number

array $options optional

Options

Returns
string
Links
https://book.cakephp.org/4/en/core-libraries/number.html#formatting-percentages

toReadableSize() ¶ public static 

toReadableSize(int|string $size): string

Returns a formatted-for-humans file size.

Parameters
int|string $size

Size in bytes

Returns
string
Links
https://book.cakephp.org/4/en/core-libraries/number.html#interacting-with-human-readable-values

Property Detail

$_defaultCurrency ¶ protected static

Default currency used by Number::currency()

Type
string|null

$_defaultCurrencyFormat ¶ protected static

Default currency format used by Number::currency()

Type
string

$_formatters ¶ protected static

A list of number formatters indexed by locale and type

Type
array
OpenHub
Pingping
Linode
  • Business Solutions
  • Showcase
  • Documentation
  • Book
  • API
  • Videos
  • Reporting Security Issues
  • Privacy Policy
  • Logos & Trademarks
  • Community
  • Get Involved
  • Issues (Github)
  • Bakery
  • Featured Resources
  • Training
  • Meetups
  • My CakePHP
  • CakeFest
  • Newsletter
  • Linkedin
  • YouTube
  • Facebook
  • Twitter
  • Mastodon
  • Help & Support
  • Forum
  • Stack Overflow
  • IRC
  • Slack
  • Paid Support

Generated using CakePHP API Docs