Введение в Zend Framework

 Learning Zend Framework

appendix

 Zend Framework Reference


  • Zend_Gdata
  • Zend_Http
  • Zend_InfoCard
  • Zend_Json
  • Zend_Layout
  • Zend_Ldap
  • Zend_Loader
  • Zend_Locale
  • Zend_Log
  • Zend_Mail
  • Zend_Markup
  • Zend_Measure
  • Zend_Memory
  • Zend_Mime
  • Zend_Navigation
  • Zend_Oauth
  • Zend_OpenId
  • Zend_Paginator
  • Zend_Pdf
  • Zend_ProgressBar
  • Zend_Queue
  • Zend_Reflection
  • Zend_Registry
  • Zend_Rest

  • Zend_Search_Lucene
  • Zend_Serializer
  • Zend_Server
  • Zend_Service
  • Zend_Session
  • Zend_Soap
  • Zend_Tag
  • Zend_Test
  • Zend_Text
  • Zend_TimeSync
  • Zend_Tool
  • Zend_Tool_Framework
  • Zend_Tool_Project
  • Zend_Translate
  • Zend_Uri
  • Zend_Validate
  • Zend_Version
  • Zend_View
  • Zend_Wildfire
  • Zend_XmlRpc
  • ZendX_Console_Process_Unix
  • ZendX_JQuery
  • Ttranslation 27.4% Update 2010-11-28 - Revision 23238 - Version ZF 1.11.x

    43.3. Normalization and Localization

    Zend_Locale_Format is a internal component used by Zend_Locale. All locale aware classes use Zend_Locale_Format for normalization and localization of numbers and dates. Normalization involves parsing input from a variety of data representations, like dates, into a standardized, structured representation, such as a PHP array with year, month, and day elements.

    The exact same string containing a number or a date might mean different things to people with different customs and conventions. Disambiguation of numbers and dates requires rules about how to interpret these strings and normalize the values into a standardized data structure. Thus, all methods in Zend_Locale_Format require a locale in order to parse the input data.

    [Замечание] Default "root" Locale

    If no locale is specified, then normalization and localization will use the standard "root" locale, which might yield unexpected behavior, if the input originated in a different locale, or output for a specific locale was expected.

    43.3.1. Number normalization: getNumber($input, Array $options)

    There are many number systems different from the common decimal system (e.g. "3.14"). Numbers can be normalized with the getNumber() function to obtain the standard decimal representation. for all number-related discussions in this manual, Arabic/European numerals (0,1,2,3,4,5,6,7,8,9) are implied, unless explicitly stated otherwise. The options array may contain a 'locale' to define grouping and decimal characters. The array may also have a 'precision' to truncate excess digits from the result.

    Пример 43.28. Number normalization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::getNumber('13.524,678',
                                            array(
    'locale' => $locale,
                                                  
    'precision' => 3)
                                           );

    print 
    $number// will return 13524.678

    43.3.1.1. Precision and Calculations

    Since getNumber($value, array $options = array()) can normalize extremely large numbers, check the result carefully before using finite precision calculations, such as ordinary PHP math operations. For example, if ((string)int_val($number) != $number) { use BCMath or GMP. Most PHP installations support the BCMath extension.

    Also, the precision of the resulting decimal representation can be rounded to a desired length with getNumber() with the option 'precision'. If no precision is given, no rounding occurs. Use only PHP integers to specify the precision.

    If the resulting decimal representation should be truncated to a desired length instead of rounded the option 'number_format' can be used instead. Define the length of the decimal representation with the desired length of zeros. The result will then not be rounded. So if the defined precision within number_format is zero the value "1.6" will return "1", not "2. See the example nearby:

    Пример 43.29. Number normalization with precision

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::getNumber('13.524,678',
                                            array(
    'precision' => 1,
                                                  
    'locale' => $locale)
                                           );
    print 
    $number// will return 13524.7

    $number Zend_Locale_Format::getNumber('13.524,678',
                                            array(
    'number_format' => '#.00',
                                                  
    'locale' => $locale)
                                           );
    print 
    $number// will return 13524.67

    43.3.2. Number localization

    toNumber($value, array $options = array()) can localize numbers to the following supported locales. This function will return a localized string of the given number in a conventional format for a specific locale. The 'number_format' option explicitly specifies a non-default number format for use with toNumber().

    Пример 43.30. Number localization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::toNumber(13547.36,
                                           array(
    'locale' => $locale));

    // will return 13.547,36
    print $number;

    [Замечание] Unlimited length

    toNumber() can localize numbers with unlimited length. It is not related to integer or float limitations.

    The same way as within getNumber(), toNumber() handles precision. If no precision is given, the complete localized number will be returned.

    Пример 43.31. Number localization with precision

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::toNumber(13547.3678,
                                           array(
    'precision' => 2,
                                                 
    'locale' => $locale));

    // will return 13.547,37
    print $number;

    Using the option 'number_format' a self defined format for generating a number can be defined. The format itself has to be given in CLDR format as described below. The locale is used to get separation, precision and other number formatting signs from it. German for example defines ',' as precision separation and in English the '.' sign is used.

    Таблица 43.4. Format tokens for self generated number formats

    Token Description Example format Generated output
    #0 Generates a number without precision and separation #0 1234567
    , Generates a separation with the length from separation to next separation or to 0 #,##0 1,234,567
    #,##,##0 Generates a standard separation of 3 and all following separations with 2 #,##,##0 12,34,567
    . Generates a precision #0.# 1234567.1234
    0 Generates a precision with a defined length #0.00 1234567.12

    Пример 43.32. Using a self defined number format

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::toNumber(13547.3678,
                                           array(
    'number_format' => '#,#0.00',
                                                 
    'locale' => 'de')
                                          );

    // will return 1.35.47,36
    print $number;

    $number Zend_Locale_Format::toNumber(13547.3,
                                           array(
    'number_format' => '#,##0.00',
                                                 
    'locale' => 'de')
                                           );

    // will return 13.547,30
    print $number;

    43.3.3. Number testing

    isNumber($value, array $options = array()) checks if a given string is a number and returns TRUE or FALSE.

    Пример 43.33. Number testing

    $locale = new Zend_Locale();
    if (
    Zend_Locale_Format::isNumber('13.445,36', array('locale' => 'de_AT')) {
        print 
    "Number";
    } else {
        print 
    "not a Number";
    }

    43.3.4. Float value normalization

    Floating point values can be parsed with the getFloat($value, array $options = array()) function. A floating point value will be returned.

    Пример 43.34. Floating point value normalization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::getFloat('13.524,678',
                                           array(
    'precision' => 2,
                                                 
    'locale' => $locale)
                                          );

    // will return 13524.68
    print $number;

    43.3.5. Floating point value localization

    toFloat() can localize floating point values. This function will return a localized string of the given number.

    Пример 43.35. Floating point value localization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::toFloat(13547.3655,
                                          array(
    'precision' => 1,
                                                
    'locale' => $locale)
                                         );

    // will return 13.547,4
    print $number;

    43.3.6. Floating point value testing

    isFloat($value, array $options = array()) checks if a given string is a floating point value and returns TRUE or FALSE.

    Пример 43.36. Floating point value testing

    $locale = new Zend_Locale('de_AT');
    if (
    Zend_Locale_Format::isFloat('13.445,36', array('locale' => $locale)) {
        print 
    "float";
    } else {
        print 
    "not a float";
    }

    43.3.7. Integer value normalization

    Integer values can be parsed with the getInteger() function. A integer value will be returned.

    Пример 43.37. Integer value normalization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::getInteger('13.524,678',
                                             array(
    'locale' => $locale));

    // will return 13524
    print $number;

    43.3.8. Integer point value localization

    toInteger($value, array $options = array()) can localize integer values. This function will return a localized string of the given number.

    Пример 43.38. Integer value localization

    $locale = new Zend_Locale('de_AT');
    $number Zend_Locale_Format::toInteger(13547.3655,
                                            array(
    'locale' => $locale));

    // will return 13.547
    print $number;

    43.3.9. Integer value testing

    isInteger($value, array $options = array()) checks if a given string is a integer value and returns TRUE or FALSE.

    Пример 43.39. Integer value testing

    $locale = new Zend_Locale('de_AT');
    if (
    Zend_Locale_Format::isInteger('13.445', array('locale' => $locale)) {
        print 
    "integer";
    } else {
        print 
    "not a integer";
    }

    43.3.10. Numeral System Conversion

    Zend_Locale_Format::convertNumerals() converts digits between different numeral systems, including the standard Arabic/European/Latin numeral system (0,1,2,3,4,5,6,7,8,9), not to be confused with Eastern Arabic numerals sometimes used with the Arabic language to express numerals. Attempts to use an unsupported numeral system will result in an exception, to avoid accidentally performing an incorrect conversion due to a spelling error. All characters in the input, which are not numerals for the selected numeral system, are copied to the output with no conversion provided for unit separator characters. Zend_Locale* components rely on the data provided by CLDR (see their list of scripts grouped by language).

    In CLDR and hereafter, the Europena/Latin numerals will be referred to as "Latin" or by the assigned 4-letter code "Latn". Also, the CLDR refers to this numeral systems as "scripts".

    Suppose a web form collected a numeric input expressed using Eastern Arabic digits "١‎٠٠". Most software and PHP functions expect input using Arabic numerals. Fortunately, converting this input to its equivalent Latin numerals "100" requires little effort using convertNumerals($inputNumeralString, $sourceNumeralSystem, $destNumeralSystem), which returns the $input with numerals in the script $sourceNumeralSystem converted to the script $destNumeralSystem.

    Пример 43.40. Converting numerals from Eastern Arabic scripts to European/Latin scripts

    $arabicScript "١‎٠٠";   // Arabic for "100" (one hundred)
    $latinScript Zend_Locale_Format::convertNumerals($arabicScript,
                                                       
    'Arab',
                                                       
    'Latn');

    print 
    "\nOriginal:   " $arabicScript;
    print 
    "\nNormalized: " $latinScript;

    Similarly, any of the supported numeral systems may be converted to any other supported numeral system.

    Пример 43.41. Converting numerals from Latin script to Eastern Arabic script

    $latinScript '123';
    $arabicScript Zend_Locale_Format::convertNumerals($latinScript,
                                                        
    'Latn',
                                                        
    'Arab');

    print 
    "\nOriginal:  " $latinScript;
    print 
    "\nLocalized: " $arabicScript;

    Пример 43.42. Getting 4 letter CLDR script code using a native-language name of the script

    function getScriptCode($scriptName$locale)
    {
        
    $scripts2names Zend_Locale_Data::getList($locale'script');
        
    $names2scripts array_flip($scripts2names);
        return 
    $names2scripts[$scriptName];
    }
    echo 
    getScriptCode('Latin''en'); // outputs "Latn"
    echo getScriptCode('Tamil''en'); // outputs "Taml"
    echo getScriptCode('tamoul''fr'); // outputs "Taml"

    For a list of supported numeral systems call Zend_Locale::getTranslationList('numberingsystem', 'en').

    digg delicious meneame google twitter technorati facebook

    Comments

    Loading...