Zend Framework 1.9.9 Manual

Es gibt viele » Ziffernsysteme welche siche vom üblichen » Dezimalsystem unterscheiden (z.B. "3.14"). Nummern können mit der Funktion getNumber() normalisiert werden um ein gleichwertiges Ergebnis in einer Schreibweise des Standard Dezimalsystems zu erhalten. Für alle Ziffern-Relevanten Diskussionen in diesem Handbuch werden die » Arabisch/Europäischen Ziffern (0,1,2,3,4,5,6,7,8,9) verwendet, ausser es ist anders definiert. Das Options Array kann ein 'locale' Gebietsschema enthalten, um eine Gruppierung und Kommazeichen zu definieren. Das Array kann auch eine Genauigkeit 'precision' enthalten um überschüssige Ziffern vom Ergebnis abzuschneiden.

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

print $number; // wird 13524.678 zurückgeben

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

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

toNumber($value, array $options = array()) kann, mit Hilfe der folgenden unterstützten Gebietsschemata, Nummern lokalisieren. Diese Funktion gibt eine lokalisierte Zeichenkette der angegebenen Nummer in dem konventionellen Format für ein definiertes Gebietsschema aus. Die Option 'number_format' definiert ein explizit angegebenes nicht standardmäßiges Nummernformat für die Verwendung mit toNumber().

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

// gibt 13.547,36 zurück
print $number;

Note: Unlimitierte Länge

toNumber() kann Nummern mit unendlicher Länge lokalisieren. Hierbei gibt es keine Abhängigkeiten mit Integer oder Float Limits.

Auf dem selben Web wie unter getNumber() verwendet toNumber() die Genauigkeit. Wenn keine Genauigkeit angegeben wurde, wird die komplette lokalisierte Nummer zurückgegeben.

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

// gibt 13.547,37 zurück
print $number;

Wird die Option 'number_format' benutzt, kann ein selbst definiertes Format für das erstellen der Nummer definiert werden. Das Format selbst muß im CLDR Format wie anbei beschrieben angegeben werden. Das Gebietsschema wird hierbei benutzt um das Trennzeichen, die Genauigkeit und andere Formatierungszeichen für Zahlen zu erhalten. Deutsch definiert zum Beispiel ',' als Kommazeichen und im Englischen wird das '.' Zeichen benutzt.

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

// gibt 1.35.47,36 zurück
print $number;

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

// gibt 13.547,30 zurück
print $number;

isNumber($value, array $options = array()) prüft ob eine gegebene Zeichenkette eine Zahl enthält und gibt wahr oder falsch zurück.

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

Lokalisierte Gleitkommazahlen können mit getFloat($value, array $options = array()) analysiert werden. Es wird eine Gleitkommazahl zurückgegeben.

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

// gibt 13524.68 zurück
print $number;

toFloat() kann Gleitkommazahlen lokalisieren. Diese Funktion gibt eine lokalisierte Zeichenkette mit der gegebenen Zahl zurück.

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

// gibt 13.547,4 zurück
print $number;

isFloat($value, array $options = array()) prüft ob eine gegebene Zeichenkette eine Gleitkommazahl enthält und gibt wahr oder falsch zurück.

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

Integer Zahlen können mit der Funktion getInteger() analysiert werden. Es wird ein Integer Wert zurückgegeben.

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

// gibt 13524 zurück
print $number;

toInteger($value, array $options = array()) kann Integer Zahlen lokalisieren. Diese Funktion gibt eine lokalisierte Zeichenkette anhand der gegebenen Nummer zurück.

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

// gibt 13.547 zurück
print $number;

isInteger($value, array $options = array()) prüft ob eine gegebene Zeichenkette eine Integer Zahl enthält und gibt wahr oder falsch zurück.

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

Zend_Locale_Format::convertNumerals() kann die Ziffern zwischen den unterschiedlichen » Zahlensystemen umwandeln. Das inkludiert auch das Standard Arabisch/Europäisch/Lateinische Zahlensystem (0,1,2,3,4,5,6,7,8,9). Nicht zu verwechseln mit dem » Ost-arabischen Zahlensystem welches in der Arabischen Sprache benutzt wird um Zahlen zu schreiben. Der Versuch ein nicht unterstütztes Zahlensystem zu benutzen führt zu einer Ausnahme um eine irrtümliche falsche Konvertierung wegen eines Schreibfehlers zu verhindern. Alle Zeichen der Eingabe, welche keine Ziffern des angegebenen Zahlenformates sind, werden in den Ausgabestring kopiert ohne das Sie verändert werden. Das beinhaltet auch die Trennzeichen der Zahlen. Zend_Locale* Komponenten sind abhängig von den Daten welche durch die CLDR liefert (hier ist eine »  Liste von Schreibweisen gruppiert nach Sprachen).

Im CLDR und auch hier, werden die Europäisch/Lateinischen Zahlen als "Latin" bezeichnet und mit dem zugeordneten 4-Zeichen-Code "Latn" referriert. Im CLDR werden Zahlensysteme auch als "Schreibweisen" (Scripts) bezeichnet.

Nehmen wir an eine Web Form erhält eine nummerische Eingabe welche Ost-Arabische Ziffern enthält "١‎٠٠". Die meisten Programme und PHP Funktionen erwarten Eingaben aber als Lateinische Ziffern. Glücklicherweise wird für die Konvertierung dieser Eingabe in gleichwertige Lateinische Ziffern "100" sehr wenig Aufwand. Es muß nur convertNumerals($inputNumeralString, $sourceNumeralSystem, $destNumeralSystem) benutzt werden werden welches $input zurückgibt und hierbei die Ziffern der Schreibweise $sourceNumeralSystem in die Schreibweise $destNumeralSystem konvertiert.

$arabicScript = "١‎٠٠";   // Arabisch für "100" (ein Hundert)
$latinScript = Zend_Locale_Format::convertNumerals($arabicScript,
                                                   'Arab',
                                                   'Latn');

print "\nOriginal:   " . $arabicScript;
print "\nNormalisiert: " . $latinScript;

Genauso kann jedes unterstützte Zahlensystem in jedes andere unterstützte Zahlensystem konvertiert werden.

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

print "\nOriginal:  " . $latinScript;
print "\nLokalisiert: " . $arabicScript;

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

Für eine Liste der unterstützten Zahlensysteme kann man Zend_Locale::getTranslationList('numberingsystem', 'en') aufrufen.