NumberFormatterInterface.php in Physical Fields 8

Namespace

Drupal\physical

File

src/NumberFormatterInterface.php

<?php

namespace Drupal\physical;


/**
 * Allows parsing and formatting numbers using language-specific rules.
 *
 * For example, if the current language is 'fr', then commas will be used
 * as decimal separators instead of the usual dots.
 */
interface NumberFormatterInterface {

  /**
   * Formats the given number for the current language.
   *
   * Supported options:
   * - use_grouping:            Whether to use grouping separators,
   *                            such as thousands separators.
   *                            Default: true.
   * - minimum_fraction_digits: Minimum fraction digits. Default: 0.
   * - maximum_fraction_digits: Minimum fraction digits. Default: 6.
   *
   * @param string $number
   *   The number.
   * @param array $options
   *   The formatting options.
   *
   * @return string
   *   The formatted number.
   */
  public function format($number, array $options = []);

  /**
   * Parses the given number.
   *
   * Replaces language-specific characters with the standard ones.
   *
   * @param string $number
   *   The number, formatted according to the current language.
   *
   * @return string|false
   *   The parsed number, or FALSE on error.
   */
  public function parse($number);

}

Interfaces

Name	Description
NumberFormatterInterface	Allows parsing and formatting numbers using language-specific rules.