ZF Zend Framework

Behind the Site

Programmer's Reference Guide

Optionen für Währungen
Zend_Currency
Zend Framework's Referenzhandbuch

Was macht eine Währung aus?

Eine Währung besteht aus verschiedenen Informationen. Einem Namen, einer Abkürzung und einem Zeichen. Jeder dieser Werte könnte relevant sein um dargestellt zu werden, aber immer nur einer zur selben Zeit. Es würde keine gute Praxis sein etwas wie "USD 1.000 $" anzuzeigen.

Hierfür unterstützt Zend_Currency die Definition der Währungsinformation welche dargestellt werden soll. Die folgenden Konstanten können verwendet werden:

Dargestellte Informationen für eine Währung
Konstante Beschreibung
NO_SYMBOL Es wird gar keine Darstellung einer Währung angezeigt
USE_SYMBOL Das Währungssymbol wird dargestellt. Für US Dollar wäre dies '$'
USE_SHORTNAME Die Abkürzung für diese Währung wird dargestellt. Für US Dollar wäre dies 'USD'. Die meisten Abkürzungen bestehen aus 3 Zeichen.
USE_NAME Der komplette Name für diese Währung wird dargestellt. Für US Dollar wäre der komplette Name "US Dollar"

Beispiel #1 Auswahl der Währungsbeschreibung

Angenommen unser Client setzt wieder "en_US" als Gebietsschema. Wenn keine Option verwendet wird könnte der zurückgegebene Wert wie folgt aussehen:

  1. $currency = new Zend_Currency(
  2.     array(
  3.         'value' => 100,
  4.     )
  5. );
  6.  
  7. print $currency; // Könnte '$ 100' zurückgeben

Durch Angabe der richtigen Option kann definiert werden welche Information dargestellt werden soll.

  1. $currency = new Zend_Currency(
  2.     array(
  3.         'value'   => 100,
  4.         'display' => Zend_Currency::USE_SHORTNAME,
  5.     )
  6. );
  7.  
  8. print $currency; // Könnte 'USD 100' zurückgeben

Ohne Angabe von display wird das Währungssymbol für die Darstellung des Objekts verwendet. Wen die Währung kein Symbol hat wird die Abkürzung als Ersatz verwendet.

Hinweis: Nicht alle Währungen haben Symbole
 Man sollte beachten das nicht alle Währungen standardmäßige Währungssymbole haben. Das bedeutet, wenn es kein Standardsymbol gibt, und das Symbol als dargestellt setzt, wird man überhaupt keine dargestellte Währung haben, da das Symbol ein leerer String ist.

Manchmal ist es notwendig die Standardinformationen zu ändern. Man kann jede der drei Währungsinformationen unabhängig setzen indem die richtige Option angegeben wird. Siehe das folgende Beispiel.

Beispiel #2 Verändern der Beschreibung einer Währung

Angenommen unser Client hat wieder mal "en_US" als Gebietsschema gesetzt. Aber jetzt wollen sie nicht die Standardeinstellungen verwenden sondern unsere eigene Beschreibung setzen. Das kann einfach durch Angabe der richtigen Option durchgeführt werden:

  1. $currency = new Zend_Currency(
  2.     array(
  3.         'value' => 100,
  4.         'name'  => 'Dollar',
  5.     )
  6. );
  7.  
  8. print $currency; // Könnte 'Dollar 100' zurückgeben

Man kann auch ein Symbol oder eine Abkürzung selbst setzen.

  1. $currency = new Zend_Currency(
  2.     array(
  3.         'value'    => 100,
  4.         'symbol' => '$$$',
  5.     )
  6. );
  7.  
  8. print $currency; // Könnte '$$$ 100' zurückgeben

Hinweis: Einstellungen für die automatische Anzeige
 Wenn man einen Namen, eine Abkürzung oder ein Symbol selbst setzt, dann werden diese neuen Informationen automatisch gesetzt und dargestellt. Diese Vereinfachung verhindert das man die richtige display Option angeben muss wenn eine Information gesetzt wird.
Wenn man also die Option sign verwendet kann man display unterdrücken und muss diese nicht auf 'USE_SYMBOL' setzen.

Optionen für Währungen
Zend_Currency
Zend Framework's Referenzhandbuch

Comments

+ Add A Comment

Please do not report issues via comments; use the ZF Issue Tracker.

If you have a JIRA/Crowd account, we suggest you login first before commenting.

  • BBCode is allowed in the comment markup

    • Select a Version

    Languages Available

    Components

    Search the Manual

    • Navigation