Zend_Locale-Functions.xml 90 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15742 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.locale.functions">
  5. <title>Zend_Locale verwenden</title>
  6. <para>
  7. <classname>Zend_Locale</classname> liefert auch lokalisierte Informationen über
  8. Gebietsschema für jedes Gebietsschema. Das beinhaltet unser anderem lokalisierte Namen für
  9. andere gebietsschema, Tage der Woche, Monatsnamen, usw.
  10. </para>
  11. <sect2 id="zend.locale.copying">
  12. <title>Kopieren, Klonen und Serialisieren von Gebietsschema Objekten</title>
  13. <para>
  14. Verwende
  15. <ulink url="http://php.net/language.oop5.cloning">Klonen von Objekten</ulink>
  16. um Gebietsschema Objekte exakt und effizient zu duplizieren. Die meisten lokalisierbaren
  17. Methoden akzeptieren auch eine Zeichenkette welche das Gebietsschema repräsentiert.
  18. Dieser entspricht dem Ergebnis von <code>$locale->toString()</code>.
  19. </para>
  20. <example id="zend.locale.copying.example-1">
  21. <title>Klonen</title>
  22. <programlisting language="php"><![CDATA[
  23. $locale = new Zend_Locale('ar');
  24. // Speichere das $locale Objekt als Serialisierung
  25. $serializedLocale = $locale->serialize();
  26. // Wiedererstellung des Original Objekts
  27. $localeObject = unserialize($serializedLocale);
  28. // Erhalte eine Zeichenkette welche das Gebietsschema identifiziert
  29. $stringLocale = $locale->toString();
  30. // Erstelle eine geklonte Kopie des $locale Objektes
  31. $copiedLocale = clone $locale;
  32. print "copied: ", $copiedLocale->toString();
  33. // PHP ruft automatisch toString() über __toString(); auf
  34. print "copied: ", $copiedLocale;
  35. ]]></programlisting>
  36. </example>
  37. </sect2>
  38. <sect2 id="zend.locale.equals">
  39. <title>Gleichheit</title>
  40. <para>
  41. <classname>Zend_Locale</classname> bietet auch eine erwartete Funktion zum Vergleichen
  42. von zwei Gebietsschema an. Alle lokalisierbaren Klassen sollten eine Vergleichbare
  43. Funktion für eine Gleichheitsprüfung anbieten.
  44. </para>
  45. <example id="zend.locale.equals.example-1">
  46. <title>Prüfung auf gleiche Gebietsschemata</title>
  47. <programlisting language="php"><![CDATA[
  48. $locale = new Zend_Locale();
  49. $mylocale = new Zend_Locale('en_US');
  50. // Prüfe ob die Gebietsschema gleich sind
  51. if ($locale->equals($mylocale)) {
  52. print "Die Gebietsschemata sind gleich";
  53. }
  54. ]]></programlisting>
  55. </example>
  56. </sect2>
  57. <sect2 id="zend.locale.getdefault">
  58. <title>Standard Gebietsschemata</title>
  59. <para>
  60. Die Methode <code>getDefault()</code> gibt ein Array mit relevanten Gebietsschemata
  61. zurück wobei Informationen vom Web Browser des Benutzers (wenn vorhanden), Informationen
  62. vom Betriebsystem des Host Servers und ZF Einstellungen benutzt werden. Wie beim
  63. Konstruktor von <classname>Zend_Locale</classname> wählt der erste Parameter die
  64. bevorzugte Umgebung von der die Informationen zuerst geholt werden sollen <link
  65. linkend="zend.locale.selection">(<code>BROWSER</code>, <code>ENVIRONMENT</code>, or
  66. <code>FRAMEWORK)</code></link>. Der zweite Parameter wechselt zwischen der Rückgabe
  67. aller gefundenen Gebietsschemata oder nur dem ersten/besten Gebietsschema.
  68. Lokalisierbare Komponenten benutzen normalerweise nur das erste Gebietsschema. Wenn
  69. vorhanden, wird eine Bewertung der Qualität mit angegeben.
  70. </para>
  71. <example id="zend.locale.getdefault.example-1">
  72. <title>Das Standard Gebietsschema erhalten</title>
  73. <programlisting language="php"><![CDATA[
  74. $locale = new Zend_Locale();
  75. // Alle Standard Gebietsschema zurückgeben
  76. $found = $locale->getDefault();
  77. print_r($found);
  78. // Nur die Gebietsschema des Browsers zurück geben
  79. $found2 = $locale->getDefault(Zend_Locale::BROWSER,TRUE);
  80. print_r($found2);
  81. ]]></programlisting>
  82. </example>
  83. <para>
  84. Um nur die Standard Gebietsschema für <link
  85. linkend="zend.locale.selection"><code>BROWSER</code>, <code>ENVIRONMENT</code>, oder
  86. <code>FRAMEWORK</code></link> zu erhalten, können die folgenden Methoden benutzt
  87. werden:
  88. <itemizedlist>
  89. <listitem>
  90. <para>
  91. <code>getEnvironment()</code>
  92. </para>
  93. </listitem>
  94. <listitem>
  95. <para>
  96. <code>getBrowser()</code>
  97. </para>
  98. </listitem>
  99. <listitem>
  100. <para>
  101. <code>getLocale()</code>
  102. </para>
  103. </listitem>
  104. </itemizedlist>
  105. </para>
  106. </sect2>
  107. <sect2 id="zend.locale.setlocale">
  108. <title>Ein neues Gebietsschema setzen</title>
  109. <para>
  110. Ein neues Gebietsschema kann mit der Funktion <code>setLocale()</code> gesetzt werden.
  111. Diese Funktion nimmt eine Gebietsschema Zeichenkette als Parameter an. Wenn kein
  112. Gebietsschema angegeben wurde, wird ein <link
  113. linkend="zend.locale.selection">automatisch gewähltes</link> Gebietsschema benutzt.
  114. Da <classname>Zend_Locale</classname> Objekte sehr "leicht" sind, existiert diese
  115. Methode hauptsächlich um Nebeneffekte auszuschließen, für Klassen die ein existierendes
  116. angelegtes Objekt referenzieren.
  117. </para>
  118. <example id="zend.locale.setlocale.example-1">
  119. <title>setLocale</title>
  120. <programlisting language="php"><![CDATA[
  121. $locale = new Zend_Locale();
  122. // Aktuelles Gebietsschema
  123. print $locale->toString();
  124. // neues Gebietsschema
  125. $locale->setLocale('aa_DJ');
  126. print $locale->toString();
  127. ]]></programlisting>
  128. </example>
  129. </sect2>
  130. <sect2 id="zend.locale.getlocale">
  131. <title>Auslesen von Sprache und Region</title>
  132. <para>
  133. <code>getLanguage()</code> gibt eine Zeichenkette zurück welche den zwei-Zeichen Code
  134. der Sprache des Gebietsschemas enthält. <code>getRegion()</code> gibt eine Zeichenkette
  135. zurück welche den Zwei-Zeichen Code der Region des Gebietsschemas enthält.
  136. </para>
  137. <example id="zend.locale.getlocale.example-1">
  138. <title>getLanguage and getRegion</title>
  139. <programlisting language="php"><![CDATA[
  140. $locale = new Zend_Locale();
  141. // Wenn das Gebietsschema 'de_AT' ist, wird 'de' als Sprache zurückgegeben
  142. print $locale->getLanguage();
  143. // Wenn das Gebietsschema 'de_AT' ist, wird 'AT' als Region zurückgegeben
  144. print $locale->getRegion();
  145. ]]></programlisting>
  146. </example>
  147. </sect2>
  148. <sect2 id="zend.locale.getdata">
  149. <title>Lokalisierte Zeichenketten beschaffen</title>
  150. <para>
  151. <code>getTranslationList()</code> gibt Zugriff auf viele Arten von lokalisierten
  152. Informationen. Diese Informationen sind sehr nützlich wenn man einem Benutzer
  153. lokalisierte Daten anzeigen will, ohne das man alles Übersetzen muß. Diese Informationen
  154. sind bereits für den Gebrauch vorhanden.
  155. </para>
  156. <para>
  157. Die angefragte Liste an Informationen wird immer als benanntes Array zurückgegeben. Wenn
  158. mehr als ein Wert zu einem expliziten Typ angegeben werden soll von dem man Werte
  159. erhalten will, muss ein Array statt mehrerer Werte übergeben werden.
  160. </para>
  161. <example id="zend.locale.getdata.example-1">
  162. <title>getTranslationList</title>
  163. <programlisting language="php"><![CDATA[
  164. $list = Zend_Locale::getTranslationList('language', 'de_AT');
  165. print_r ($list);
  166. // Beispiel Schlüssel -> Werte Paare...
  167. // [de] -> Deutsch
  168. // [en] -> Englisch
  169. // Einen der zurückgegebenen Schlüssel als Wert für die
  170. // getTranslation() Methode einer anderen Sprache verwenden
  171. print Zend_Locale::getTranslation('de', 'language', 'zh');
  172. // Gibt die Übersetzung für die Sprache 'de' in chinesisch zurück
  173. ]]></programlisting>
  174. </example>
  175. <para>
  176. Man kann diese Informationen für alle Sprachen auslesen. Aber nicht alle dieser
  177. Informationen sind komplett für alle Sprachen. Einige dieser Arten sind auch durch eine
  178. eigene Funktion erhältlich wegen der Einfachheit. Anbei eine Liste für detailierte
  179. Informationen hierüber.
  180. </para>
  181. <table id="zend.locale.getdata.table-1">
  182. <title>
  183. Details für getTranslationList($type = null, $locale = null, $value = null)
  184. </title>
  185. <tgroup cols="2">
  186. <thead>
  187. <row>
  188. <entry>Typ</entry>
  189. <entry>Beschreibung</entry>
  190. </row>
  191. </thead>
  192. <tbody>
  193. <row>
  194. <entry><emphasis>Language</emphasis></entry>
  195. <entry>
  196. Gibt eine lokalisierte Liste aller Sprachen zurück. Der Sprach-Teil des
  197. Gebietsschemas wird als Schlüssel und die Übersetzung als Wert
  198. zurückgegeben
  199. </entry>
  200. </row>
  201. <row>
  202. <entry><emphasis>Script</emphasis></entry>
  203. <entry>
  204. Gibt eine lokalisierte Liste aller Schriften zurück. Die Schrift wird
  205. als Schlüssel die Übersetzung als Wert zurückgegeben
  206. </entry>
  207. </row>
  208. <row>
  209. <entry><emphasis>Territory</emphasis></entry>
  210. <entry>
  211. Gibt eine lokalisierte Liste aller Territorien zurück. Diese enthält
  212. Länder, Kontinente und Territorien. Um nur die Territorien und
  213. Kontinente zu erhalten, muß '1' als Wert verwendet werden. Um nur die
  214. Länder zu erhalten muß '2' als Wert verwendet werden. Der Landes-Teil
  215. des Gebietsschemas wird, wo es möglich ist, als Schlüssel verwendet. In
  216. den anderen Fällen wird der offizielle ISO Code für dieses Territorium
  217. verwendet. Das übersetzte Territorium wird als Wert zurückgegeben. Wenn
  218. der Wert nicht angegeben wird erhält man eine Liste mit beidem
  219. </entry>
  220. </row>
  221. <row>
  222. <entry><emphasis>Variant</emphasis></entry>
  223. <entry>
  224. Gibt eine lokalisierte Liste von bekannten Varianten von Schriften
  225. zurück. Die Variante wird als Schlüssel und die Übersetzung als Wert
  226. zurückgegeben
  227. </entry>
  228. </row>
  229. <row>
  230. <entry><emphasis>Key</emphasis></entry>
  231. <entry>
  232. Gibt eine lokalisierte Liste von bekannten Schlüsseln zurück. Diese
  233. Schlüssel sind generische Werte die in Übersetzungen verwendet werden.
  234. Das sind normalerweise Kalendar, Sammlungen und Währungen. Der Schlüssel
  235. wird als Arrayschlüssel und die Übersetzung als Wert zurückgegeben
  236. </entry>
  237. </row>
  238. <row>
  239. <entry><emphasis>Type</emphasis></entry>
  240. <entry>
  241. Gibt eine lokalisierte Liste von bekannten Typen von Schlüssel zurück.
  242. Das sind Varianten von Typen von Kalenderrepräsentationen und Typen von
  243. Sammlungen. Wenn 'collation' als Wert verwendet wird, dann werden alle
  244. Typen von Sammlungen zurückgegeben. Wenn 'calendar' als Wert verwendet
  245. wird dann werden alle Typen von Kalender zurückgegeben. Wenn der Wert
  246. nicht angegeben wird, dann wird eine Liste mit beidem zurückgegeben. Der
  247. Typ wird als Schlüssel und die Übersetzung als Wert zurückgegeben
  248. </entry>
  249. </row>
  250. <row>
  251. <entry><emphasis>Layout</emphasis></entry>
  252. <entry>
  253. Gibt eine Liste von Regeln zurück die beschreiben wie spezielle
  254. Textabschnitte formatiert werden
  255. </entry>
  256. </row>
  257. <row>
  258. <entry><emphasis>Characters</emphasis></entry>
  259. <entry>
  260. Gibt eine Liste von in diesem Gebietsschema erlaubten Zeichen zurück
  261. </entry>
  262. </row>
  263. <row>
  264. <entry><emphasis>Delimiters</emphasis></entry>
  265. <entry>
  266. Gibt eine Liste von in diesem Gebietsschema erlaubten Anführungszeichen
  267. zurück
  268. </entry>
  269. </row>
  270. <row>
  271. <entry><emphasis>Measurement</emphasis></entry>
  272. <entry>
  273. Gibt eine Liste von bekannten Bemessungswerten zurück. Diese Liste
  274. sollte nicht mehr verwendet werden
  275. </entry>
  276. </row>
  277. <row>
  278. <entry><emphasis>Months</emphasis></entry>
  279. <entry>
  280. Gibt eine Liste aller Repräsentationen für Monate in diesem
  281. Gebietsschema zurück. Es gibt einige unterschiedliche Repräsentationen
  282. welche alle als Unterarray zurückgegeben werden. Wenn kein Wert
  283. angegeben wird, dann wird eine Liste aller Monate des 'gregorian'
  284. (gregorianischen) Kalenders zurückgegeben. Es kann jeder bekannte
  285. Kalender als Wert angegeben werden um eine Liste der Monate dieses
  286. Kalenders zu erhalten. Der Einfachheit halber sollte <link
  287. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  288. </entry>
  289. </row>
  290. <row>
  291. <entry><emphasis>Month</emphasis></entry>
  292. <entry>
  293. Gibt eine lokalisierte Liste aller Monatsnamen für dieses Gebietsschema
  294. zurück. Wenn der Wert unterdrückt wird, dann wird der normalerweise
  295. verwendete gregorianische komplette Name der Monate zurückgegeben, wobei
  296. jede Monatsnummer als Schlüssel und das übersetzte Monat als Wert
  297. zurückgegeben wird. Man kann die Monate für andere Kalender und Formate
  298. erhalten indem ein Array als Wert angegeben wird. Der erste Eintrag des
  299. Arrays muß der Kalender sein, der zweite der verwendete Kontext und der
  300. dritte die Länge die zurückgegeben werden soll. Der Einfachheit halber
  301. sollte <link linkend="zend.date.introduction">Zend_Date</link> verwendet
  302. werden
  303. </entry>
  304. </row>
  305. <row>
  306. <entry><emphasis>Days</emphasis></entry>
  307. <entry>
  308. Gibt eine Liste aller Repräsentationen für Tage in diesem Gebietsschema
  309. zurück. Es gibt einige unterschiedliche Repräsentationen welche alle als
  310. Unterarray zurückgegeben werden. Wenn kein Wert angegeben wird, dann
  311. wird eine Liste aller Tage des 'gregorian' (gregorianischen) Kalenders
  312. zurückgegeben. Es kann jeder bekannte Kalender als Wert angegeben werden
  313. um eine Liste der Tage dieses Kalenders zu erhalten. Der Einfachheit
  314. halber sollte <link linkend="zend.date.introduction">Zend_Date</link>
  315. verwendet werden
  316. </entry>
  317. </row>
  318. <row>
  319. <entry><emphasis>Day</emphasis></entry>
  320. <entry>
  321. Gibt eine lokalisierte Liste aller Tagesnamen für dieses Gebietsschema
  322. zurück. Wenn der Wert unterdrückt wird, dann wird der normalerweise
  323. verwendete gregorianische komplette Name der Tage zurückgegeben, wobei
  324. die englische Abkürzung des Tages als Schlüssel und der übersetzte Tag
  325. als Wert zurückgegeben wird. Man kann die Tage für andere Kalender und
  326. Formate erhalten indem ein Array als Wert angegeben wird. Der erste
  327. Eintrag des Arrays muß der Kalender sein, der zweite der verwendete
  328. Kontext und der dritte die Länge die zurückgegeben werden soll. Der
  329. Einfachheit halber sollte <link
  330. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  331. </entry>
  332. </row>
  333. <row>
  334. <entry><emphasis>Week</emphasis></entry>
  335. <entry>
  336. Gibt eine Liste von Werten für die korrekte Berechnung der Woche in
  337. einem Gebietsschema zurück. Der Einfachheit halber sollte
  338. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  339. </entry>
  340. </row>
  341. <row>
  342. <entry><emphasis>Quarters</emphasis></entry>
  343. <entry>
  344. Gibt eine Liste aller Repräsentationen für Quartale in diesem
  345. Gebietsschema zurück. Es gibt einige unterschiedliche Repräsentationen
  346. welche alle als Unterarray zurückgegeben werden. Wenn kein Wert
  347. angegeben wird, dann wird eine Liste aller Quartale des 'gregorian'
  348. (gregorianischen) Kalenders zurückgegeben. Es kann jeder bekannte
  349. Kalender als Wert angegeben werden um eine Liste der Quartale dieses
  350. Kalenders zu erhalten
  351. </entry>
  352. </row>
  353. <row>
  354. <entry><emphasis>Quarter</emphasis></entry>
  355. <entry>
  356. Gibt eine lokalisierte Liste aller Quartalsnamen für dieses
  357. Gebietsschema zurück. Wenn der Wert unterdrückt wird, dann wird der
  358. normalerweise verwendete gregorianische komplette Name der Quartale
  359. zurückgegeben, wobei jede Quartalsnummer als Schlüssel und das
  360. übersetzte Quartal als Wert zurückgegeben wird. Man kann die Quartale
  361. für andere Kalender und Formate erhalten indem ein Array als Wert
  362. angegeben wird. Der erste Eintrag des Arrays muß der Kalender sein, der
  363. zweite der verwendete Kontext und der dritte die Länge die zurückgegeben
  364. werden soll
  365. </entry>
  366. </row>
  367. <row>
  368. <entry><emphasis>Eras</emphasis></entry>
  369. <entry>
  370. Gibt eine Liste aller Repräsentationen für Epochen in diesem
  371. Gebietsschema zurück. Wenn kein Wert angegeben wird, dann wird eine
  372. Liste aller Epochen des 'gregorian' (gregorianischen) Kalenders
  373. zurückgegeben. Es kann jeder bekannte Kalender als Wert angegeben werden
  374. um eine Liste der Epochen dieses Kalenders zu erhalten
  375. </entry>
  376. </row>
  377. <row>
  378. <entry><emphasis>Era</emphasis></entry>
  379. <entry>
  380. Gibt eine lokalisierte Liste aller Namen von Epochen für dieses
  381. Gebietsschema zurück. Wenn der Wert unterdrückt wird, dann wird der
  382. normalerweise verwendete gregorianische komplette Name der Epoche
  383. zurückgegeben, wobei jede Epochennummer als Schlüssel und die übersetzte
  384. Epoche als Wert zurückgegeben wird. Man kann die Epochen für andere
  385. Kalender und Formate erhalten indem ein Array als Wert angegeben wird.
  386. Der erste Eintrag des Arrays muß der Kalender sein und der zweite die
  387. Länge die zurückgegeben werden soll
  388. </entry>
  389. </row>
  390. <row>
  391. <entry><emphasis>Date</emphasis></entry>
  392. <entry>
  393. Gibt eine lokalisierte Liste aller Datumsformate für dieses
  394. Gebietsschema zurück. Der Name des Datumsformats wird als Schlüssel und
  395. das Format selbst als Wert zurückgegeben. Wenn der Wert nicht angegeben
  396. wird, dann werden die Datumsformate des gregorianischen Kalenders
  397. zurückgegeben. Die Datumsformate für andere Kalender kann man erhalten
  398. indem der gewünschte Kalender als String übergeben wird. Der Einfachheit
  399. halber sollte <link linkend="zend.date.introduction">Zend_Date</link>
  400. verwendet werden
  401. </entry>
  402. </row>
  403. <row>
  404. <entry><emphasis>Time</emphasis></entry>
  405. <entry>
  406. Gibt eine lokalisierte Liste aller Zeitformate für dieses Gebietsschema
  407. zurück. Der Name des Zeitformats wird als Schlüssel und das Format
  408. selbst als Wert zurückgegeben. Wenn der Wert nicht angegeben wird, dann
  409. werden die Zeitformate des gregorianischen Kalenders zurückgegeben. Die
  410. Zeitformate für andere Kalender kann man erhalten indem der gewünschte
  411. Kalender als String übergeben wird. Der Einfachheit halber sollte
  412. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  413. </entry>
  414. </row>
  415. <row>
  416. <entry><emphasis>DateTime</emphasis></entry>
  417. <entry>
  418. Gibt eine lokalisierte Liste aller Datums-Zeitformate für dieses
  419. Gebietsschema zurück. Der Name des Datums-Zeitformats wird als Schlüssel
  420. und das Format selbst als Wert zurückgegeben. Wenn der Wert nicht
  421. angegeben wird, dann werden die Datums-Zeitformate des gregorianischen
  422. Kalenders zurückgegeben. Die Datums-Zeitformate für andere Kalender kann
  423. man erhalten indem der gewünschte Kalender als String übergeben wird.
  424. Der Einfachheit halber sollte <link
  425. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  426. </entry>
  427. </row>
  428. <row>
  429. <entry><emphasis>Field</emphasis></entry>
  430. <entry>
  431. Gibt eine lokalisierte Liste von Datumsfelder zurück die verwendet
  432. werden kann um Kalender oder Datumsstrings wie 'Monat' oder 'Jahr' in
  433. einer gewünschte Sprache darzustellen. Wenn der Wert nicht angegeben
  434. wird dann wird diese Liste für den gregorianischen Kalender
  435. zurückgegeben. Man kann diese Liste für andere Kalender erhalten indem
  436. der gewünschte Kalender als String übergeben wird
  437. </entry>
  438. </row>
  439. <row>
  440. <entry><emphasis>Relative</emphasis></entry>
  441. <entry>
  442. Gibt eine lokalisierte Liste von relativen Daten zurück die verwendet
  443. werden können um relative Daten wie 'gestern' oder 'morgen' in einer
  444. gewünschten Sprache darzustellen. Wenn der Wert nicht angegeben wird
  445. dann wird diese Liste für den gregorianischen Kalender zurückgegeben.
  446. Man kann diese Liste für andere Kalender erhalten indem der gewünschte
  447. Kalender als String übergeben wird
  448. </entry>
  449. </row>
  450. <row>
  451. <entry><emphasis>Symbols</emphasis></entry>
  452. <entry>
  453. Gibt eine lokalisierte Liste von Zeichen zurück die in Repräsentationen
  454. von Zahlen verwendet wird
  455. </entry>
  456. </row>
  457. <row>
  458. <entry><emphasis>NameToCurrency</emphasis></entry>
  459. <entry>
  460. Gibt eine lokalisierte Liste von Namen für Währungen zurück. Die Währung
  461. wird hierbei als Schlüssel und der übersetzte Name als Wert
  462. zurückgegeben. Der Einfachheit halber sollte
  463. <link linkend="zend.currency.introduction">Zend_Currency</link>
  464. verwendet werden
  465. </entry>
  466. </row>
  467. <row>
  468. <entry><emphasis>CurrencyToName</emphasis></entry>
  469. <entry>
  470. Gibt eine lokalisierte Liste von Währungen für lokalisierte Namen
  471. zurück. Der übersetzte Name wird als Schlüssel und die Währung als Wert
  472. zurückgegeben. Der Einfachheit halber sollte
  473. <link linkend="zend.currency.introduction">Zend_Currency</link>
  474. verwendet werden
  475. </entry>
  476. </row>
  477. <row>
  478. <entry><emphasis>CurrencySymbol</emphasis></entry>
  479. <entry>
  480. Gibt eine Liste von bekannten lokalisierten Symbolen für Währungen
  481. zurück. Die Währung wird als Schlüssel und das Symbol als Wert
  482. zurückgegeben. Der Einfachheit halber sollte <link
  483. linkend="zend.currency.introduction">Zend_Currency</link>
  484. verwendet werden
  485. </entry>
  486. </row>
  487. <row>
  488. <entry><emphasis>Question</emphasis></entry>
  489. <entry>
  490. Gibt eine Liste von lokalisierten Strings für die Akzeptanz ('ja') und
  491. die Verneinung ('nein') zurück. Der Einfachheit halber sollte
  492. <link linkend="zend.locale.getquestion">Zend_Locale's getQuestion
  493. Methode</link> verwendet werden
  494. </entry>
  495. </row>
  496. <row>
  497. <entry><emphasis>CurrencyFraction</emphasis></entry>
  498. <entry>
  499. Gibt eine Liste von Brüchen für Währungswerte zurück. Die Währung wird
  500. als Schlüssel und der Bruch als Integer Wert zurückgegeben. Der
  501. Einfachheit halber sollte <link
  502. linkend="zend.currency.introduction">Zend_Currency</link> verwendet
  503. werden
  504. </entry>
  505. </row>
  506. <row>
  507. <entry><emphasis>CurrencyRounding</emphasis></entry>
  508. <entry>
  509. Gibt eine Liste zurück wie welche Währung gerundet werden muß. Die
  510. Währung wird als Schlüssel und der Rundungswert als Ganzzahl
  511. zurückgegeben. Der Einfachheit halber sollte <link
  512. linkend="zend.currency.introduction">Zend_Currency</link>
  513. verwendet werden
  514. </entry>
  515. </row>
  516. <row>
  517. <entry><emphasis>CurrencyToRegion</emphasis></entry>
  518. <entry>
  519. Gibt eine Liste von Währungen zurück von denen bekannt ist das Sie in
  520. einer Region verwendet werden. Der ISO3166 Wert ('Region') wird als
  521. Arrayschlüssel und der ISO4217 Wert ('Währung') als Arraywert
  522. zurückgegeben. Der Einfachheit halber sollte <link
  523. linkend="zend.currency.introduction">Zend_Currency</link> verwendet
  524. werden
  525. </entry>
  526. </row>
  527. <row>
  528. <entry><emphasis>RegionToCurrency</emphasis></entry>
  529. <entry>
  530. Gibt eine Liste von Regionen zurück in denen eine Währung verwendet
  531. wird. Der ISO4217 Wert ('Währung') wird als Arrayschlüssel und der
  532. ISO3166 Wert ('Region') als Arraywert zurückgegeben. Wenn eine Währung
  533. in mehreren Regionen verwendet wird dann werden diese Regionen durch ein
  534. Leerzeichen getrennt. Der Einfachheit halber sollte
  535. <link linkend="zend.currency.introduction">Zend_Currency</link>
  536. verwendet werden
  537. </entry>
  538. </row>
  539. <row>
  540. <entry><emphasis>RegionToTerritory</emphasis></entry>
  541. <entry>
  542. Gibt eine Liste von Territorien mit den Ländern, oder Sub-Territorien
  543. welche in diesem Territorium enthalten sind, zurück. Der ISO Territory
  544. Code ('Territorium') wird als Arrayschlüssel und der ISO3166 Wert
  545. ('Region') als Arraywert verwendet. Wenn ein Territorium mehrere
  546. Regionen enthält werden diese Regionen mit einem Leerzeichen getrennt
  547. </entry>
  548. </row>
  549. <row>
  550. <entry><emphasis>TerritoryToRegion</emphasis></entry>
  551. <entry>
  552. Gibt eine Liste von Regionen und den Territorien in denen diese Regionen
  553. enthalten sind zurück. Der ISO3166 Code ('Region') wird als
  554. Arrayschlüssel und der ISO Territory Code ('Territorium') als Arraywert
  555. zurückgegeben. Wenn eine Region in mehreren Territorien enthalten ist
  556. werden diese Territorien mit einem Leerzeichen getrennt
  557. </entry>
  558. </row>
  559. <row>
  560. <entry><emphasis>ScriptToLanguage</emphasis></entry>
  561. <entry>
  562. Gibt eine Liste von Schriften die in einer Sprache verwendet werden
  563. zurück. Der Sprachcode wird als Arrayschlüssel und der Schriftcode als
  564. Arraywert zurückgegeben. Wenn eine Sprache mehrere Schriften enthält
  565. werden diese Schriften mit einem Leerzeichen getrennt
  566. </entry>
  567. </row>
  568. <row>
  569. <entry><emphasis>LanguageToScript</emphasis></entry>
  570. <entry>
  571. Gibt eine Liste von Sprachen und den darin geschriebenen Schriften
  572. zurück. Der Schriftcode wird als Arrayschlüssel und der Sprachcode als
  573. Arraywert zurückgegeben. Wenn eine Schrift in verschiedenen Sprachen
  574. verwendet wird werden diese Sprachen mit einem Leerzeichen getrennt
  575. </entry>
  576. </row>
  577. <row>
  578. <entry><emphasis>TerritoryToLanguage</emphasis></entry>
  579. <entry>
  580. Gibt eine Liste von Ländern zurück die eine Sprache verwenden. Der
  581. Ländercode wird als Arrayschlüssel und der Sprachcode als Arraywert
  582. zurückgegeben. Wenn eine Sprache in mehreren Ländern verwendet wird
  583. werden diese Länder mit einem Leerzeichen getrennt
  584. </entry>
  585. </row>
  586. <row>
  587. <entry><emphasis>LanguageToTerritory</emphasis></entry>
  588. <entry>
  589. Gibt eine Liste von Ländern und den in diesen Ländern gesprächenen
  590. Sprachen zurück. Der Ländercode wird als Arrayschlüssel und der
  591. Sprachcode wird als Arraywert zurückgegeben. Wenn ein Land verschiedene
  592. Sprachen verwendet werden diese Sprachen mit einem Leerzeichen getrennt
  593. </entry>
  594. </row>
  595. <row>
  596. <entry><emphasis>TimezoneToWindows</emphasis></entry>
  597. <entry>
  598. Gibt eine Liste von Windows Zeitzonen und den entsprechenden ISO
  599. Zeitzonen zurück. Die Windows Zeitzone dies als Arrayschlüssel und die
  600. ISO Zeitzone als Arraywert zurückgegeben
  601. </entry>
  602. </row>
  603. <row>
  604. <entry><emphasis>WindowsToTimezone</emphasis></entry>
  605. <entry>
  606. Gibt eine Liste von ISO Zeitzonen und die entsprechenden Windows
  607. Zeitzonen zurück. Die ISO Zeitzone wird als Arrayschlüssel und die
  608. Windows Zeitzone als Arraywert zurückgegeben
  609. </entry>
  610. </row>
  611. <row>
  612. <entry><emphasis>TerritoryToTimezone</emphasis></entry>
  613. <entry>
  614. Gibt eine Liste von Regionen oder Territorien und den entsprechenden ISO
  615. Zeitzonen zurück. Die ISO Zeitzone wird als Arrayschlüssel und der
  616. Territory Code als Arraywert zurückgegeben
  617. </entry>
  618. </row>
  619. <row>
  620. <entry><emphasis>TimezoneToTerritory</emphasis></entry>
  621. <entry>
  622. Gibt eine Liste von Zeitzonen und den entsprechenden Regionen oder
  623. Territorien zurück. Die Region oder der Territory Code wird als
  624. Arrayschlüssel und die ISO Zeitzone als Arraywert zurückgegeben
  625. </entry>
  626. </row>
  627. <row>
  628. <entry><emphasis>CityToTimezone</emphasis></entry>
  629. <entry>
  630. Gibt eine lokalisierte Liste von Städten zurück die als Übersetzung für
  631. eine entsprechende Zeitzone verwendet werden können. Nicht für alle
  632. Zeitzonen ist eine Übersetzung vorhanden, aber für einen Benutzer ist
  633. eine echte, in seiner Sprache geschriebenen, Stadt besser als der ISO
  634. Name seiner Zeitzone. Die ISO Zeitzone wird als Arrayschlüssel und die
  635. übersetzte Stadt als Arraywert zurückgegeben
  636. </entry>
  637. </row>
  638. <row>
  639. <entry><emphasis>TimezoneToCity</emphasis></entry>
  640. <entry>
  641. Gibt eine Liste von Zeitzonen für lokalisierte Städtenamen zurück. Die
  642. lokalisierte Stadt wird als Arrayschlüssel und der ISO Name der Zeitzone
  643. als Arraywert zurückgegeben
  644. </entry>
  645. </row>
  646. <row>
  647. <entry><emphasis>PhoneToTerritory</emphasis></entry>
  648. <entry>
  649. Gibt eine Liste von Telefoncodes zurück die in einem bestimmten
  650. Territorium verwendet werden. Das Territorium (Region) wird als
  651. Arrayschlüssel und der Telefoncode als Arraywert verwendet
  652. </entry>
  653. </row>
  654. <row>
  655. <entry><emphasis>TerritoryToPhone</emphasis></entry>
  656. <entry>
  657. Gibt eine Liste von Territorien zurück in denen ein Telefoncode
  658. verwendet wird. Der Telefoncode wird als Arrayschlüssel und das
  659. Territorium (Region) als Arraywert verwendet. Wenn ein Telefoncode in
  660. verschiedenen Territorien verwendet wird, sind diese mit einem
  661. Leerzeichen getrennt
  662. </entry>
  663. </row>
  664. <row>
  665. <entry><emphasis>NumericToTerritory</emphasis></entry>
  666. <entry>
  667. Gibt eine Liste von 3 stelligen Numerncodes für Territorien zurück. Das
  668. Territorium (Region) wird als Arrayschlüssel und der 3 stellige
  669. Nummerncode als Arraywert verwendet
  670. </entry>
  671. </row>
  672. <row>
  673. <entry><emphasis>TerritoryToNumeric</emphasis></entry>
  674. <entry>
  675. Gibt eine Liste von Territorien mit Ihrem 3 stellige Nummerncode zurück.
  676. Das 3 stellige Nummerncode wird als Arrayschlüssel und das Territorium
  677. (Region) als Arraywert verwendet
  678. </entry>
  679. </row>
  680. <row>
  681. <entry><emphasis>Alpha3ToTerritory</emphasis></entry>
  682. <entry>
  683. Gibt eine Liste von 3 stelligen Zeichencodes für Territorien zurück. Das
  684. Territorium (Region) wird als Arrayschlüssel und der 3 stellige
  685. Zeichencode als Arraywert verwendet
  686. </entry>
  687. </row>
  688. <row>
  689. <entry><emphasis>TerritoryToAlpha3</emphasis></entry>
  690. <entry>
  691. Gibt eine Liste von Territorien mit Ihrem 3 stelligen Zeichencode
  692. zurück. Der 3 stellige Zeichencode wird als Arrayschlüssel und das
  693. Territorium (Region) als Arraywert verwendet
  694. </entry>
  695. </row>
  696. <row>
  697. <entry><emphasis>PostalToTerritory</emphasis></entry>
  698. <entry>
  699. Gibt eine Liste von Territorien mit einem Regex für Post Codes zurück,
  700. welche in diesem Territorium enthalten sind. Der ISO Territory Code
  701. ('territory') wird als Arrayschlüssel und das Regex als Arraywert
  702. verwendet.
  703. </entry>
  704. </row>
  705. <row>
  706. <entry><emphasis>NumberingSystem</emphasis></entry>
  707. <entry>
  708. Gibt eine Liste von Skripten zurück mit die Schreibweise der
  709. Ziffern, die in diesem Skript verwendet werden
  710. </entry>
  711. </row>
  712. <row>
  713. <entry><emphasis>FallbackToChar</emphasis></entry>
  714. <entry>
  715. Gibt eine Liste von Ersatzzeichen für oft verwendete Unicode Zeichen
  716. zurück. Das kann verwendet werden um zum Beispiel "©" mit "(C)" zu
  717. ersetzen
  718. </entry>
  719. </row>
  720. <row>
  721. <entry><emphasis>CharToFallback</emphasis></entry>
  722. <entry>
  723. Gibt eine Liste von Unicode Zeichen für oft verwendete Ersatzzeichen
  724. zurück. Das kann verwendet werden um zum Beispiel "(C)" mit "©" zu
  725. ersetzen
  726. </entry>
  727. </row>
  728. </tbody>
  729. </tgroup>
  730. </table>
  731. <para>
  732. Wenn nur ein einzelner übersetzter Wert benötigt wird, kann die
  733. <code>getTranslation()</code> Methode verwendet werden. Diese gibt immer einen String
  734. zurück, akzeptiert aber einige andere Typen als die <code>getTranslationList()</code>
  735. Methode. Auch der Wert ist der gleiche wie vorher mit einem Unterschied. Das Detail das
  736. man zurückerhalten will muß als zusätzlicher Wert angegeben werden
  737. </para>
  738. <note>
  739. <para>
  740. Weil immer ein Wert als Detail angegeben werden muß, muss dieser Parameter als
  741. erster Parameter angegeben werden. Das unterscheidet sich von der
  742. <code>getTranslationList()</code> Methode.
  743. </para>
  744. </note>
  745. <para>
  746. Siehe die folgende Tabelle für detailierte Informationen:
  747. </para>
  748. <table id="zend.locale.getdata.table-2">
  749. <title>Details für getTranslation($value = null, $type = null, $locale = null)</title>
  750. <tgroup cols="2">
  751. <thead>
  752. <row>
  753. <entry>Typ</entry>
  754. <entry>Beschreibung</entry>
  755. </row>
  756. </thead>
  757. <tbody>
  758. <row>
  759. <entry><emphasis>Language</emphasis></entry>
  760. <entry>
  761. Gibt eine Übersetzung für eine Sprache zurück. Um die gewünschte
  762. Übersetzung auszuwählen muß der Sprachcode als Wert angegeben werden
  763. </entry>
  764. </row>
  765. <row>
  766. <entry><emphasis>Script</emphasis></entry>
  767. <entry>
  768. Gibt eine Übersetzung für eine Schrift zurück. Um die gewünschte
  769. Übersetzung auszuwählen muß der Schriftcode als Wert angegeben werden
  770. </entry>
  771. </row>
  772. <row>
  773. <entry>
  774. <emphasis>Territory</emphasis> oder <emphasis>Country</emphasis>
  775. </entry>
  776. <entry>
  777. Gibt eine Übersetzung für ein Territorium zurück. Das können Länder,
  778. Kontinente und Territorien sein. Um die gewünschte Variante auszuwählen
  779. muß der Territory Code als Wert angegeben werden
  780. </entry>
  781. </row>
  782. <row>
  783. <entry><emphasis>Variant</emphasis></entry>
  784. <entry>
  785. Gibt eine Übersetzung für eine Schriftvariante zurück. Um die gewünschte
  786. Variante auszuwählen muß der Code der Variante als Wert angegeben werden
  787. </entry>
  788. </row>
  789. <row>
  790. <entry><emphasis>Key</emphasis></entry>
  791. <entry>
  792. Gibt eine Übersetzung für einen bekannten Schlüssel zurück. Diese
  793. Schlüssel sind generische Werte die in Übersetzungen verwendet werden.
  794. Das sind normalerweise Kalender, Sammlung und Währung. Um den
  795. gewünschten Schlüssel auszuwählen muß der Schlüsselcode als Wert
  796. angegeben werden
  797. </entry>
  798. </row>
  799. <row>
  800. <entry><emphasis>DefaultCalendar</emphasis></entry>
  801. <entry>
  802. Gibt den Standardkalender für das angegebene Gebietsschema zurück. Für
  803. die meisten wird das 'gregorian' (gregorianisch) sein. Der Einfachheit
  804. halber sollte <link linkend="zend.date.introduction">Zend_Date</link>
  805. verwendet werden
  806. </entry>
  807. </row>
  808. <row>
  809. <entry><emphasis>MonthContext</emphasis></entry>
  810. <entry>
  811. Gibt den Standardkontext für Monate zurück der im angegebenen Kalender
  812. verwendet wird. Wenn der Wert nicht angegeben wird, wird der 'gregorian'
  813. (gregorianische) Kalender verwendet. Der Einfachheit halber sollte
  814. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  815. </entry>
  816. </row>
  817. <row>
  818. <entry><emphasis>DefaultMonth</emphasis></entry>
  819. <entry>
  820. Gibt das Standardformat für Monate zurück die im angegebene Kalender
  821. verwendet werden. Wenn der Wert nicht angegeben wird, dann wird der
  822. 'gregorian' (gregorianische) Kalender verwendet. Der Einfachheit halber
  823. sollte <link linkend="zend.date.introduction">Zend_Date</link> verwendet
  824. werden
  825. </entry>
  826. </row>
  827. <row>
  828. <entry><emphasis>Month</emphasis></entry>
  829. <entry>
  830. Gibt eine Übersetzung für ein Monat zurück. Es muß die Nummer des Monats
  831. als Ganzzahlwert angegeben werden. Er muß zwischen 1 und 12 sein. Wenn
  832. man die Daten für andere Kalender, Kontexte oder Formate empfangen will,
  833. muß ein Array statt einem Ganzzahlwert mit dem erwarteten Wert angegeben
  834. werden. Das Array muß wie folgt aussehen: <code>array('calendar',
  835. 'context', 'format', 'month number')</code>. Wenn nur ein Ganzzahlwert
  836. angegeben wird, sind die Standardwerte der 'gregorian' (Gregorianische)
  837. Kalender, der Kontext 'format' und das Format 'wide'. Der Einfachheit
  838. halber sollte <link linkend="zend.date.introduction">Zend_Date</link>
  839. verwendet werden
  840. </entry>
  841. </row>
  842. <row>
  843. <entry><emphasis>DayContext</emphasis></entry>
  844. <entry>
  845. Gibt den Standardkontext für Tage zurück der im angegebenen Kalender
  846. verwendet wird. Wenn der Wert nicht angegeben wird, wird der 'gregorian'
  847. (gregorianische) Kalender verwendet. Der Einfachheit halber sollte
  848. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  849. </entry>
  850. </row>
  851. <row>
  852. <entry><emphasis>DefaultDay</emphasis></entry>
  853. <entry>
  854. Gibt das Standardformat für Tage zurück die im angegebene Kalender
  855. verwendet werden. Wenn der Wert nicht angegeben wird, dann wird der
  856. 'gregorian' (gregorianische) Kalender verwendet. Der Einfachheit halber
  857. sollte <link linkend="zend.date.introduction">Zend_Date</link> verwendet
  858. werden
  859. </entry>
  860. </row>
  861. <row>
  862. <entry><emphasis>Day</emphasis></entry>
  863. <entry>
  864. Gibt eine Übersetzung für einen Tag zurück. Es muß die englische
  865. Abkürzung des Tages als Stringwert angegeben werden ('sun', 'mon',
  866. usw.). Wenn man die Daten für andere Kalender, Kontexte oder Formate
  867. empfangen will, muß ein Array statt einem Ganzzahlwert mit dem
  868. erwarteten Wert angegeben werden. Das Array muß wie folgt aussehen:
  869. <code>array('calendar', 'context', 'format', 'day abbreviation')</code>.
  870. Wenn nur ein String angegeben wird, sind die Standardwerte der
  871. 'gregorian' (Gregorianische) Kalender, der Kontext 'format' und das
  872. Format 'wide'. Der Einfachheit halber sollte <link
  873. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  874. </entry>
  875. </row>
  876. <row>
  877. <entry><emphasis>Quarter</emphasis></entry>
  878. <entry>
  879. Gibt eine Übersetzung für ein Quartal zurück. Es muß die Nummer des
  880. Quartals Ganzzahl angegeben werden und diese muß zwischen 1 und 4 sein.
  881. Wenn man die Daten für andere Kalender, Kontexte oder Formate empfangen
  882. will, muß ein Array statt einem Ganzzahlwert mit dem erwarteten Wert
  883. angegeben werden. Das Array muß wie folgt aussehen:
  884. <code>array('calendar', 'context', 'format', 'quarter number')</code>.
  885. Wenn nur ein String angegeben wird, sind die Standardwerte der
  886. 'gregorian' (Gregorianische) Kalender, der Kontext 'format' und das
  887. Format 'wide'
  888. </entry>
  889. </row>
  890. <row>
  891. <entry><emphasis>Am</emphasis></entry>
  892. <entry>
  893. Gibt eine Übersetzung für 'AM' in dem erwarteten Gebietsschema zurück.
  894. Wenn man die Daten für andere Kalender empfangen will, muß ein String
  895. mit dem erwarteten Kalender angegeben werden. Wenn der Wert nicht
  896. angegeben wird, dann wird der 'gregorian' (Gregorianische) Kalender
  897. verwendet. Der Einfachheit halber sollte <link
  898. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  899. </entry>
  900. </row>
  901. <row>
  902. <entry><emphasis>Pm</emphasis></entry>
  903. <entry>
  904. Gibt eine Übersetzung für 'PM' in dem erwarteten Gebietsschema zurück.
  905. Wenn man die Daten für andere Kalender empfangen will, muß ein String
  906. mit dem erwarteten Kalender angegeben werden. Wenn der Wert nicht
  907. angegeben wird, dann wird der 'gregorian' (Gregorianische) Kalender
  908. verwendet. Der Einfachheit halber sollte <link
  909. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  910. </entry>
  911. </row>
  912. <row>
  913. <entry><emphasis>Era</emphasis></entry>
  914. <entry>
  915. Gibt eine Übersetzung für eine Epoche zurück. Es muß die Nummer der
  916. Epoche als Ganzzahl oder String angegeben werden. Wenn man die Daten
  917. für andere Kalender oder Formate empfangen will, muß ein Array statt
  918. einem Ganzzahlwert mit dem erwarteten Wert angegeben werden. Das Array
  919. muß wie folgt aussehen: <code>array('calendar', 'format',
  920. 'era number')</code>. Wenn nur ein String angegeben wird, sind die
  921. Standardwerte der 'gregorian' (Gregorianische) Kalender und das Format
  922. 'abbr'
  923. </entry>
  924. </row>
  925. <row>
  926. <entry><emphasis>DefaultDate</emphasis></entry>
  927. <entry>
  928. Gibt das Standard Datumsformat zurück das im angegebenen Kalender
  929. verwendet wird. Wenn der Wert nicht angegeben wird, dann wird der
  930. 'gregorian' (Gregorianische) Kalender verwendet. Der Einfachheit halber
  931. sollte <link linkend="zend.date.introduction">Zend_Date</link> verwendet
  932. werden
  933. </entry>
  934. </row>
  935. <row>
  936. <entry><emphasis>Date</emphasis></entry>
  937. <entry>
  938. Gibt das Datumsformat für einen angegebenen Kalender oder Format in
  939. einem Gebietsschema zurück. Wenn kein Wert angegeben wird, dann wird der
  940. 'gregorian' (Gregorianische) Kalender mit dem Format 'medium' verwendet.
  941. Wenn ein String angegeben wird, dann wird der 'gregorian'
  942. (Gregorianische) Kalender mit dem angegebenen Format verwendet. Oder es
  943. kann auch ein Array angegeben welches wie folgt aussehen muß:
  944. <code>array('calendar', 'format')</code>. Der Einfachheit halber sollte
  945. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  946. </entry>
  947. </row>
  948. <row>
  949. <entry><emphasis>DefaultTime</emphasis></entry>
  950. <entry>
  951. Gibt das Standard Zeitformat zurück das im angegebenen Kalender
  952. verwendet wird. Wenn der Wert nicht angegeben wird, dann wird der
  953. 'gregorian' (Gregorianische) Kalender verwendet. Der Einfachheit halber
  954. sollte <link linkend="zend.date.introduction">Zend_Date</link> verwendet
  955. werden
  956. </entry>
  957. </row>
  958. <row>
  959. <entry><emphasis>Time</emphasis></entry>
  960. <entry>
  961. Gibt das Zeitformat für einen angegebenen Kalender oder Format in einem
  962. Gebietsschema zurück. Wenn kein Wert angegeben wird, dann wird der
  963. 'gregorian' (Gregorianische) Kalender mit dem Format 'medium' verwendet.
  964. Wenn ein String angegeben wird, dann wird der 'gregorian'
  965. (Gregorianische) Kalender mit dem angegebenen Format verwendet. Oder es
  966. kann auch ein Array angegeben welches wie folgt aussehen muß:
  967. <code>array('calendar', 'format')</code>. Der Einfachheit halber sollte
  968. <link linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  969. </entry>
  970. </row>
  971. <row>
  972. <entry><emphasis>DateTime</emphasis></entry>
  973. <entry>
  974. Gibt das Datums-Zeitformat für ein angegebenes Gebietsschema zurück
  975. welches anzeigt wie Datum und Zeit im selben String des angegebenen
  976. Kalenders angezeigt werden sollten. Wenn kein Wert angegeben wird, dann
  977. wird der 'gregorian' (Gregorianische) Kalender verwendet. Der
  978. Einfachheit halber sollte <link
  979. linkend="zend.date.introduction">Zend_Date</link> verwendet werden
  980. </entry>
  981. </row>
  982. <row>
  983. <entry><emphasis>Field</emphasis></entry>
  984. <entry>
  985. Gibt ein übersetztes Datumsfeld zurück welches verwendet werden kann um
  986. Kalender oder Datumsstrings wie 'Monat' oder 'Jahr' in der gewünschten
  987. Sprache korrekt anzuzeigen. Das Feld das als String zurückgegeben werden
  988. soll muß angegeben werden. In diesem Fall wird der 'gregorian'
  989. (Gregorianische) Kalender verwendet. Wenn man die Felder für andere
  990. Kalenderformat erhalten will muß ein Array angegeben werden das wie
  991. folgt auszusehen hat: <code>array('calendar', 'date field')</code>
  992. </entry>
  993. </row>
  994. <row>
  995. <entry><emphasis>Relative</emphasis></entry>
  996. <entry>
  997. Gibt ein übersetztes Datums zurück welches relativ zu heute ist. Dieses
  998. kann Strings wie 'Gestern' oder 'Morgen' in einer gewünschten Sprache
  999. enthalten. Es muß die Anzahl der relativen Tage zu heute angegeben
  1000. werden um den erwarteten String zu erhalten. Gestern würde '-1' sein,
  1001. morgen '1' und so weiter. Es wird hierbei der 'gregorian'
  1002. (Gregorianische) Kalender verwendet. Wenn man die relativen Daten für
  1003. andere Kalenderformat erhalten will muß ein Array angegeben werden das
  1004. wie folgt auszusehen hat: <code>array('calendar', 'date field')</code>
  1005. </entry>
  1006. </row>
  1007. <row>
  1008. <entry><emphasis>DecimalNumber</emphasis></entry>
  1009. <entry>
  1010. Gibt das Format für Dezimalzahlen in einem angegebenen Gebietsschema
  1011. zurück. Der Einfachheit halber sollte <link
  1012. linkend="zend.locale.parsing">Zend_Locale_Format</link> verwendet
  1013. werden
  1014. </entry>
  1015. </row>
  1016. <row>
  1017. <entry><emphasis>ScientificNumber</emphasis></entry>
  1018. <entry>
  1019. Gibt das Format für Wissenschaftliche Zahlen im angegebenen
  1020. Gebietsschema zurück
  1021. </entry>
  1022. </row>
  1023. <row>
  1024. <entry><emphasis>PercentNumber</emphasis></entry>
  1025. <entry>
  1026. Gibt das Format für Prozentzahlen im angegebenen Gebietsschema zurück
  1027. </entry>
  1028. </row>
  1029. <row>
  1030. <entry><emphasis>CurrencyNumber</emphasis></entry>
  1031. <entry>
  1032. Gibt das Format für die Anzeige von Währungszahlen in einem angegebenen
  1033. Gebietsschema zurück. Der Einfachheit halber sollte
  1034. <link linkend="zend.currency.introduction">Zend_Currency</link>
  1035. verwendet werden
  1036. </entry>
  1037. </row>
  1038. <row>
  1039. <entry><emphasis>NameToCurrency</emphasis></entry>
  1040. <entry>
  1041. Gibt einen übersetzten Namen für eine angegebene Währung zurück. Die
  1042. Währung muß im ISO Format angegeben werden welches zum Beispiel 'EUR'
  1043. für die Währung 'Euro' ist. Der Einfachheit halber sollte
  1044. <link linkend="zend.currency.introduction">Zend_Currency</link>
  1045. verwendet werden
  1046. </entry>
  1047. </row>
  1048. <row>
  1049. <entry><emphasis>CurrencyToName</emphasis></entry>
  1050. <entry>
  1051. Gibt eine Währung für einen angegebenen lokalisierten Namen zurück. Der
  1052. Einfachheit halber sollte
  1053. <link linkend="zend.currency.introduction">Zend_Currency</link>
  1054. verwendet werden
  1055. </entry>
  1056. </row>
  1057. <row>
  1058. <entry><emphasis>CurrencySymbol</emphasis></entry>
  1059. <entry>
  1060. Gibt das für eine Währung verwendete Symbol in einem Gebietsschema
  1061. zurück. Nicht für alle Währungen existiert ein Symbol. Der Einfachheit
  1062. halber sollte <link
  1063. linkend="zend.currency.introduction">Zend_Currency</link> verwendet
  1064. werden
  1065. </entry>
  1066. </row>
  1067. <row>
  1068. <entry><emphasis>Question</emphasis></entry>
  1069. <entry>
  1070. Gibt einen lokalisierten String für Akzeptanz ('yes') und Verneinung
  1071. ('no') zurück. Es muß entweder 'yes' oder 'no' als Wert angegeben werden
  1072. um den erwarteten String zu erhalten. Der Einfachheit halber sollte
  1073. <link linkend="zend.locale.getquestion">Zend_Locale's getQuestion
  1074. Methode</link> verwendet werden
  1075. </entry>
  1076. </row>
  1077. <row>
  1078. <entry><emphasis>CurrencyFraction</emphasis></entry>
  1079. <entry>
  1080. Gibt den Bruch der für eine angegebene Währung zu verwenden ist, zurück.
  1081. Die Währung muß als ISO Wert angegeben werden. Der Einfachheit halber
  1082. sollte <link linkend="zend.currency.introduction">Zend_Currency</link>
  1083. verwendet werden
  1084. </entry>
  1085. </row>
  1086. <row>
  1087. <entry><emphasis>CurrencyRounding</emphasis></entry>
  1088. <entry>
  1089. Gibt zurück wie eine angegebene Währung gerundet werden muß. Die Währung
  1090. muß als ISO Wert angegeben werden. Wenn die Währung nicht angegeben wird
  1091. das wird die 'DEFAULT' (Standard) Rundung zurückgegeben. Der Einfachheit
  1092. halber sollte <link
  1093. linkend="zend.currency.introduction">Zend_Currency</link> verwendet
  1094. werden
  1095. </entry>
  1096. </row>
  1097. <row>
  1098. <entry><emphasis>CurrencyToRegion</emphasis></entry>
  1099. <entry>
  1100. Gibt die Währung für eine angegebene Region zurück. Der Regionscode muß
  1101. als ISO3166 String angegeben werden zum Beispiel 'AT' für Österreich.
  1102. Der Einfachheit halber sollte <link
  1103. linkend="zend.currency.introduction">Zend_Currency</link>
  1104. verwendet werden
  1105. </entry>
  1106. </row>
  1107. <row>
  1108. <entry><emphasis>RegionToCurrency</emphasis></entry>
  1109. <entry>
  1110. Gibt die Regionen zurück in denen eine Währung verwendet wird. Die
  1111. Währung muß als ISO4217 Code angegeben werden, zum Beispiel 'EUR' für
  1112. Euro. Wenn eine Währung in mehreren Regionen verwendet wird, werden
  1113. diese Regionen mit einem Leerzeichen getrennt. Der Einfachheit halber
  1114. sollte <link linkend="zend.currency.introduction">Zend_Currency</link>
  1115. verwendet werden
  1116. </entry>
  1117. </row>
  1118. <row>
  1119. <entry><emphasis>RegionToTerritory</emphasis></entry>
  1120. <entry>
  1121. Gibt die Regionen für ein angegebenes Territorium zurück. Das
  1122. Territorium muß als ISO4217 String angegeben werden zum Beispiel '001'
  1123. für Weltweit. Die Regionen in diesem Territorium werden mit einem
  1124. Leerzeichen getrennt
  1125. </entry>
  1126. </row>
  1127. <row>
  1128. <entry><emphasis>TerritoryToRegion</emphasis></entry>
  1129. <entry>
  1130. Gibt die Territorien zurück in denen eine angegebene Region enthalten
  1131. ist. Diese Region muß als ISO3166 String angegeben werden zum Beispiel
  1132. 'AT' für Österreich. Wenn eine region in mehreren Territorien enthalten
  1133. ist, werden diese Territorien mit einem Leerzeichen getrennt
  1134. </entry>
  1135. </row>
  1136. <row>
  1137. <entry><emphasis>ScriptToLanguage</emphasis></entry>
  1138. <entry>
  1139. Gibt die Schriften zurück die in einer angegebenen Sprache verwendet
  1140. werden. Die Sprache muß als ISO Sprachcode angegeben werden zum Beispiel
  1141. 'en' für englisch. Wenn mehrere Schriften in einer Sprache verwendet
  1142. werden dann werden diese Schriften mit einem Leerzeichen getrennt
  1143. </entry>
  1144. </row>
  1145. <row>
  1146. <entry><emphasis>LanguageToScript</emphasis></entry>
  1147. <entry>
  1148. Gibt die Sprachen zurück die in einer angegebenen Schrift verwendet
  1149. werden. Die Schrift muß als ISO Schriftcode angegeben werden zum
  1150. Beispiel 'Latn' für lateinisch. Wenn eine Schrift in mehreren Sprachen
  1151. verwendet wird dann werden diese Sprachen mit einem Leerzeichen getrennt
  1152. </entry>
  1153. </row>
  1154. <row>
  1155. <entry><emphasis>TerritoryToLanguage</emphasis></entry>
  1156. <entry>
  1157. Gibt die Territorien zurück die in einer angegebenen Sprache verwendet
  1158. werden. Die Sprache muß als ISO Sprachcode angegeben werden zum Beispiel
  1159. 'en' für englisch. Wenn mehrere Sprachen in einem Territorien verwendet
  1160. werden dann werden diese Sprachen mit einem Leerzeichen getrennt
  1161. </entry>
  1162. </row>
  1163. <row>
  1164. <entry><emphasis>LanguageToTerritory</emphasis></entry>
  1165. <entry>
  1166. Gibt die Sprachen zurück die in einem angegebenen Territorium verwendet
  1167. werden. Das Territorium muß als ISO3166 Code angegeben werden zum
  1168. Beispiel 'IT' für italienisch. Wenn eine Sprache in mehreren Territorien
  1169. verwendet wird dann werden diese Territorien mit einem Leerzeichen
  1170. getrennt
  1171. </entry>
  1172. </row>
  1173. <row>
  1174. <entry><emphasis>TimezoneToWindows</emphasis></entry>
  1175. <entry>
  1176. Gibt eine ISO Zeitzone für eine angegebene Windows Zeitzone zurück
  1177. </entry>
  1178. </row>
  1179. <row>
  1180. <entry><emphasis>WindowsToTimezone</emphasis></entry>
  1181. <entry>
  1182. Gibt eine Windows Zeitzone für eine angegebene ISO Zeitzone zurück
  1183. </entry>
  1184. </row>
  1185. <row>
  1186. <entry><emphasis>TerritoryToTimezone</emphasis></entry>
  1187. <entry>Gibt ein Territorium für eine angegebene ISO Zeitzone zurück</entry>
  1188. </row>
  1189. <row>
  1190. <entry><emphasis>TimezoneToTerritory</emphasis></entry>
  1191. <entry>Gibt die ISO Zeitzone für ein angegebenes Territorium zurück</entry>
  1192. </row>
  1193. <row>
  1194. <entry><emphasis>CityToTimezone</emphasis></entry>
  1195. <entry>
  1196. Gibt eine lokalisierte Stadt für eine angegebene ISO Zeitzone zurück.
  1197. Nicht für alle Zeitzonen existiert eine Übersetzung einer Stadt
  1198. </entry>
  1199. </row>
  1200. <row>
  1201. <entry><emphasis>TimezoneToCity</emphasis></entry>
  1202. <entry>
  1203. Gibt die ISO Zeitzone für einen angegebenen lokalisierten Namen einer
  1204. Stadt zurück. Nicht für alle Städte existiert eine Zeitzone
  1205. </entry>
  1206. </row>
  1207. <row>
  1208. <entry><emphasis>PhoneToTerritory</emphasis></entry>
  1209. <entry>Gibt den Telefoncode für ein angegebenes Territorium (Region) zurück.
  1210. Der Code des Territoriums muß als ISO3166 String angegeben werden, z.B.
  1211. 'AT' für Österreich</entry>
  1212. </row>
  1213. <row>
  1214. <entry><emphasis>TerritoryToPhone</emphasis></entry>
  1215. <entry>
  1216. Gibt das Territorium (Region) zurück in dem ein Telefoncode verwendet
  1217. wird. Der Telefoncode muß als reiner Integerwert angegeben werden, z.B.
  1218. '43' für +43. Wenn ein Telefoncode verwendet wird der in mehreren
  1219. Territorien (Regionen) verwendet wird, werden diese Territorien mit
  1220. einem Leerzeichen getrennt
  1221. </entry>
  1222. </row>
  1223. <row>
  1224. <entry><emphasis>NumericToTerritory</emphasis></entry>
  1225. <entry>
  1226. Gibt den 3 stelligen Nummerncode für ein angegebenes Territorium
  1227. (Region) zurück. Der Code des Territoriums muß als ISO3166 String
  1228. angegeben werden, z.B. 'AR' für Österreich
  1229. </entry>
  1230. </row>
  1231. <row>
  1232. <entry><emphasis>TerritoryToNumeric</emphasis></entry>
  1233. <entry>
  1234. Gibt as Territorium (Region) für einen 3 stelligen Nummerncode zurück.
  1235. Der 3 stellige Nummerncode muß als reine Integerzahl angegeben werden,
  1236. zum Beispiel '43'
  1237. </entry>
  1238. </row>
  1239. <row>
  1240. <entry><emphasis>Alpha3ToTerritory</emphasis></entry>
  1241. <entry>
  1242. Gibt den 3 stelligen Zeichencode für ein angegebenes Territorium
  1243. (Region) zurück. Der Code des Territoriums (Region) muß als ISO3166
  1244. String angegeben werden, zum Beispiel 'AT' für Österreich
  1245. </entry>
  1246. </row>
  1247. <row>
  1248. <entry><emphasis>TerritoryToAlpha3</emphasis></entry>
  1249. <entry>
  1250. Gibt das Territorium (Region) für einen 3 stelligen Zeichencode zurück
  1251. </entry>
  1252. </row>
  1253. <row>
  1254. <entry><emphasis>PostalToTerritory</emphasis></entry>
  1255. <entry>
  1256. Gibt ein Regex für den Post Code eines angegebenen Territoriums zurück.
  1257. Das Territorium muss als ISO4217 String angegeben werden, zum Beispiel
  1258. '001' für Welt
  1259. </entry>
  1260. </row>
  1261. <row>
  1262. <entry><emphasis>NumberingSystem</emphasis></entry>
  1263. <entry>
  1264. Gibt ein Skript mit der Schreibweise der Ziffern zurück, die in diesem
  1265. Skript verwendet werden
  1266. </entry>
  1267. </row>
  1268. <row>
  1269. <entry><emphasis>FallbackToChar</emphasis></entry>
  1270. <entry>
  1271. Gibt ein Ersatzzeichen für ein oft verwendetes Unicode Zeichen zurück.
  1272. Das kann verwendet werden um zum Beispiel "©" mit "(C)" zu ersetzen
  1273. </entry>
  1274. </row>
  1275. <row>
  1276. <entry><emphasis>CharToFallback</emphasis></entry>
  1277. <entry>
  1278. Gibt ein Unicode Zeichen für ein oft verwendetes Ersatzzeichen zurück.
  1279. Das kann verwendet werden um zum Beispiel "(C)" mit "©" zu ersetzen
  1280. </entry>
  1281. </row>
  1282. </tbody>
  1283. </tgroup>
  1284. </table>
  1285. <note>
  1286. <para>
  1287. Mit dem Zend Framework 1.5 wurde verschiedene alte Typen umbenannt. Das wurde
  1288. notwendig durch verschiedene neue Typen, einige Schreibfehler und die Erhöhung der
  1289. Verwendbarkeit. Die folgende Tabelle zeigt eine Liste von alten und neuen Typen:
  1290. </para>
  1291. </note>
  1292. <table id="zend.locale.getdata.table-3">
  1293. <title>Unterschiede zwischen ZF 1.0 und ZF 1.5</title>
  1294. <tgroup cols="2">
  1295. <thead>
  1296. <row>
  1297. <entry>Alter Typ</entry>
  1298. <entry>Neuer Typ</entry>
  1299. </row>
  1300. </thead>
  1301. <tbody>
  1302. <row>
  1303. <entry>Country</entry>
  1304. <entry>Territory (mit dem Wert '2')</entry>
  1305. </row>
  1306. <row>
  1307. <entry>Calendar</entry>
  1308. <entry>Type (mit dem Wert 'calendar')</entry>
  1309. </row>
  1310. <row>
  1311. <entry>Month_Short</entry>
  1312. <entry>Month (mit dem Array('gregorian', 'format', 'abbreviated')</entry>
  1313. </row>
  1314. <row>
  1315. <entry>Month_Narrow</entry>
  1316. <entry>Month (mit dem Array('gregorian', 'stand-alone', 'narrow')</entry>
  1317. </row>
  1318. <row>
  1319. <entry>Month_Complete</entry>
  1320. <entry>Months</entry>
  1321. </row>
  1322. <row>
  1323. <entry>Day_Short</entry>
  1324. <entry>Day (mit dem Array('gregorian', 'format', 'abbreviated')</entry>
  1325. </row>
  1326. <row>
  1327. <entry>Day_Narrow</entry>
  1328. <entry>Day (mit dem Array('gregorian', 'stand-alone', 'narrow')</entry>
  1329. </row>
  1330. <row>
  1331. <entry>DateFormat</entry>
  1332. <entry>Date</entry>
  1333. </row>
  1334. <row>
  1335. <entry>TimeFormat</entry>
  1336. <entry>Time</entry>
  1337. </row>
  1338. <row>
  1339. <entry>Timezones</entry>
  1340. <entry>CityToTimezone</entry>
  1341. </row>
  1342. <row>
  1343. <entry>Currency</entry>
  1344. <entry>NameToCurrency</entry>
  1345. </row>
  1346. <row>
  1347. <entry>Currency_Sign</entry>
  1348. <entry>CurrencySymbol</entry>
  1349. </row>
  1350. <row>
  1351. <entry>Currency_Detail</entry>
  1352. <entry>CurrencyToRegion</entry>
  1353. </row>
  1354. <row>
  1355. <entry>Territory_Detail</entry>
  1356. <entry>TerritoryToRegion</entry>
  1357. </row>
  1358. <row>
  1359. <entry>Language_Detail</entry>
  1360. <entry>LanguageToTerritory</entry>
  1361. </row>
  1362. </tbody>
  1363. </tgroup>
  1364. </table>
  1365. <para>
  1366. Das folgende Beispiel zeigt wie man die Namen für Dinge in verschiedenen Sprachen
  1367. erhalten kann.
  1368. </para>
  1369. <example id="zend.locale.getdata.example-3">
  1370. <title>getTranslationList</title>
  1371. <programlisting language="php"><![CDATA[
  1372. $locale = new Zend_Locale('en_US');
  1373. // Gibt die Namen aller Länder in der Französischen Sprache aus
  1374. print_r(Zend_Locale::getTranslationList('country', 'fr'));
  1375. ]]></programlisting>
  1376. </example>
  1377. <para>
  1378. Das nächste Beispiel zeigt wie der Name einer Sprache in einer anderen Sprache gefunden
  1379. werden kann, wenn der zwei-Zeichen ISO Länder-Code unbekannt ist.
  1380. </para>
  1381. <example id="zend.locale.getdata.example-4">
  1382. <title>Konvertierung des Ländernamens von einer Sprache in eine andere Sprache</title>
  1383. <programlisting language="php"><![CDATA[
  1384. $locale = new Zend_Locale('en_US');
  1385. $code2name = $locale->getLanguageTranslationList();
  1386. $name2code = array_flip($code2name);
  1387. $frenchCode = $name2code['French'];
  1388. echo $locale->getLanguageTranslation($frenchCode, 'es');
  1389. // Ausgegeben wird der Spanische Name der Fransösischen Sprache
  1390. ]]></programlisting>
  1391. </example>
  1392. <para>
  1393. Um von <classname>Zend_Locale</classname> eine Liste aller bekannten Sprachen zu
  1394. bekommen wobei jede Sprache in Ihrer eigenen Sprache geschrieben wird, kann das untere
  1395. Beispiel in einer Web Seite benutzt werden. Genauso können
  1396. <code>getCountryTranslationList()</code> und <code>getCountryTranslation()</code>
  1397. benutzt werden um eine Tabelle zu erhalten die Namen für Muttersprachen einer Region und
  1398. Namen für Regionen in einer anderen Sprache zu erhalten. Man muß einen <code>try ..
  1399. catch</code> Block benutzen um Ausnahmen abzufangen die auftreten wenn ein Gebietsschema
  1400. benutzt wird das nicht existiert. Nicht alle Sprachen sind auch ein Gebietsschema. Im
  1401. Beispiel werden die Ausnahmen ignoriert um einen frühen Abbruch zu verhindern.
  1402. </para>
  1403. <example id="zend.locale.getdata.example-6">
  1404. <title>Alle Sprachen geschrieben in Ihrer Muttersprache</title>
  1405. <programlisting language="php"><![CDATA[
  1406. $list = Zend_Locale::getLanguageTranslationList('auto');
  1407. foreach($list as $language => $content) {
  1408. try {
  1409. $output = Zend_Locale::getLanguageTranslation($language, $language);
  1410. if (is_string($output)) {
  1411. print "\n<br>[".$language."] ".$output;
  1412. }
  1413. } catch (Exception $e) {
  1414. continue;
  1415. }
  1416. }
  1417. ]]></programlisting>
  1418. </example>
  1419. </sect2>
  1420. <sect2 id="zend.locale.getquestion">
  1421. <title>Übersetzungen für "Ja" und "Nein" erhalten</title>
  1422. <para>
  1423. Oft müssen Programme eine "Ja" oder "Nein" Rückmeldung eines Benutzers erkennen.
  1424. <code>getQuestion()</code> gibt ein Array zurück welches die richtigen Wörter oder Regex
  1425. Zeichenketten enthält um einem Benutzer in einer bestimmten $locale zu antworten
  1426. (Standardmäßig das aktuelle Gebietsschema des Objekts). Das zurückgegebene Array enthält
  1427. die folgenden Informationen:
  1428. </para>
  1429. <itemizedlist>
  1430. <listitem>
  1431. <para>
  1432. <emphasis>
  1433. yes und no</emphasis>: Eine generelle Stringrepräsentation für Ja und Nein
  1434. Antworten. Es enthält die erste und generellste Antwort von yesarray und
  1435. noarray.
  1436. </para>
  1437. <para>
  1438. <emphasis>yesarray und noarray</emphasis>: Ein Array mit allen bekannten
  1439. Ja und Nein Antworten. Diverse Sprachen haben mehr als nur zwei Antworten.
  1440. Normalerweise ist das der komplette String und seine Abkürzung.
  1441. </para>
  1442. <para>
  1443. <emphasis>yesexpr und noexpr</emphasis>: Ein ersteller Regex String des es
  1444. erlaubt Benutzerantworten zu behandeln und nach Ja und Nein zu suchen.
  1445. </para>
  1446. </listitem>
  1447. </itemizedlist>
  1448. <para>
  1449. Alle diese Informationen sind natürlich lokalisiert und hängen vom eingestellten
  1450. Gebietsschema ab. Das folgende Beispiel zeigt die Informationen die empfangen werden
  1451. können:
  1452. </para>
  1453. <example id="zend.locale.getquestion.example-1">
  1454. <title>getQuestion()</title>
  1455. <programlisting language="php"><![CDATA[
  1456. $locale = new Zend_Locale();
  1457. // Zeichenketten für Fragen
  1458. print_r($locale->getQuestion('de'));
  1459. - - - Output - - -
  1460. Array
  1461. (
  1462. [yes]ja[/yes]
  1463. [no]nein[/no]
  1464. [yesabbr]j[/yesabbr]
  1465. [noabbr]n[/noabbr]
  1466. [yesexpr]^([yY]([eE][sS])?)|([jJ][aA]?)[/yesexpr]
  1467. [noexpr]^([nN]([oO]|([eE][iI][nN]))?)[/noexpr]
  1468. )
  1469. ]]></programlisting>
  1470. </example>
  1471. </sect2>
  1472. <sect2 id="zend.locale.getlocalelist">
  1473. <title>Eine Liste aller bekannten Gebietsschemata erhalten</title>
  1474. <para>
  1475. Manchmal will man eine Liste aller bekannten Gebietsschemata erhalten. Das kann für die
  1476. verschiedensten Aufgaben nützlich sein, zum Beispiel für die Erstellung einer
  1477. Auswahlbox. Für diesen Zweck kann die statische <code>getLocaleList()</code> Methode
  1478. verwender werden, welche eine Liste aller bekannten Gebietsschemata zurückgibt.
  1479. </para>
  1480. <example id="zend.locale.getlocalelist.example-1">
  1481. <title>getLocaleList()</title>
  1482. <programlisting language="php"><![CDATA[
  1483. $localelist = Zend_Locale::getLocaleList();
  1484. ]]></programlisting>
  1485. </example>
  1486. <note>
  1487. <para>
  1488. Es ist zu beachten das die Gebietsschemata als Schlüssel des Arrays das man erhält
  1489. zurück gegeben werden. Der Wert ist immer ein Boolsches True.
  1490. </para>
  1491. </note>
  1492. </sect2>
  1493. <sect2 id="zend.locale.detection">
  1494. <title>Erkennen von Gebietsschemata</title>
  1495. <para>
  1496. Wenn man erkennen will ob eine vorhandene Eingabe. unabhängig von Ihrer Quelle, ein
  1497. Gebietsschema ist, sollte man die statische <code>isLocale()</code> Methode verwenden.
  1498. Der erste Parameter dieser Methode ist der String den man prüfen will.
  1499. </para>
  1500. <example id="zend.locale.detection.example-1">
  1501. <title>Einfache Erkennung des Gebietsschemas</title>
  1502. <programlisting language="php"><![CDATA[
  1503. $input = 'to_RU';
  1504. if (Zend_Locale::isLocale($input)) {
  1505. print "'{$input}' ist ein Gebietsschema";
  1506. } else {
  1507. print "Sorry... die vorhandene Eingabe ist kein Gebietsschema";
  1508. }
  1509. ]]></programlisting>
  1510. </example>
  1511. <para>
  1512. Wie man sieht ist die Ausgabe dieser Methode immer ein boolscher Wert. Es gibt nur einen
  1513. Grund warum man eine Ausnahme erhält wenn diese Methode aufgerufen wird. Wenn das eigene
  1514. System kein Gebietsschema anbietet und Zend Framework nicht in der Lage ist dieses
  1515. automatisch zu erkennen. Normalerweise zeigt dieses, das ein Problem mit dem eigenen OS
  1516. in Kombination mit PHP's <code>setlocale()</code> vorhanden ist.
  1517. </para>
  1518. <para>
  1519. Man sollte auch beachten das jeder angegebene Gebietsschema String automatisch
  1520. degradiert wird wenn der Regionsabschnitt für dieses Gebietsschema nicht existiert. In
  1521. unserem vorherigen Beispiel existiert die Region <code>'RU'</code> nicht für die Sprache
  1522. <code>'to'</code>, aber es wird trotzdem true zurückgegeben da
  1523. <classname>Zend_Locale</classname> mit der vorhandenen Eingabe arbeiten kann.
  1524. </para>
  1525. <para>
  1526. Trotzdem ist es manchmal nützlich diese automatische Degradierung zu verhindern, und
  1527. hier kommt der zweite Parameter von <code>isLocale()</code> zu Tragen. Der
  1528. <code>strict</code> Parameter ist Standardmäßig <constant>FALSE</constant> und kann verwendet
  1529. werden um die automatische Degradierung zu verhindern wenn er auf <constant>TRUE</constant>
  1530. gesetzt wird.
  1531. </para>
  1532. <example id="zend.locale.detection.example-2">
  1533. <title>Strikte Erkennung des Gebietsschemas</title>
  1534. <programlisting language="php"><![CDATA[
  1535. $input = 'to_RU';
  1536. if (Zend_Locale::isLocale($input, true)) {
  1537. print "'{$input}' ist ein Gebietsschema";
  1538. } else {
  1539. print "Sorry... die vorhandene Eingabe ist kein Gebietsschema";
  1540. }
  1541. ]]></programlisting>
  1542. </example>
  1543. <para>
  1544. Jetzt da man in der Lage zu Erkennen ob ein vorhandenen String ein Gebietsschema ist
  1545. kann man Gebietsschema bezogenes Verhalten in seine eigenen Klassen hinzufügen. Aber man
  1546. wird schnell erkennen das das immer zu den gleichen 15 Zeilen Code führt. Etwas
  1547. ähnliches wie das folgende Beispiel:
  1548. </para>
  1549. <example id="zend.locale.detection.example-3">
  1550. <title>Implementierung von Gebietsschema bezogenem Verhalten</title>
  1551. <programlisting language="php"><![CDATA[
  1552. if ($locale === null) {
  1553. $locale = new Zend_Locale();
  1554. }
  1555. if (!Zend_Locale::isLocale($locale, true, false)) {
  1556. if (!Zend_Locale::isLocale($locale, false, false)) {
  1557. throw new Zend_Locale_Exception(
  1558. "Das Gebietsschema '$locale' ist kein bekanntes Gebietsschema");
  1559. }
  1560. $locale = new Zend_Locale($locale);
  1561. }
  1562. if ($locale instanceof Zend_Locale) {
  1563. $locale = $locale->toString();
  1564. }
  1565. ]]></programlisting>
  1566. </example>
  1567. <para>
  1568. Mit Zend Framework 1.8 haben wir die statische <code>findLocale()</code> Methode
  1569. hinzugefügt welche einen Gebietsschema-String zurückgibt mit dem man arbeiten kann. Sie
  1570. führt die folgenden Arbeiten durch:
  1571. </para>
  1572. <itemizedlist>
  1573. <listitem>
  1574. <para>
  1575. Erkennt ob ein angegebener String ein Gebietsschema ist
  1576. </para>
  1577. </listitem>
  1578. <listitem>
  1579. <para>
  1580. Degradiert das Gebietsschema wenn es in der angegebenen Region nicht existiert
  1581. </para>
  1582. </listitem>
  1583. <listitem>
  1584. <para>
  1585. Gibt das vorher gesetzte Anwendungsweite Gebietsscheam zurück wenn keine Eingabe
  1586. angegeben wurde
  1587. </para>
  1588. </listitem>
  1589. <listitem>
  1590. <para>
  1591. Erkennt das Gebietsschema vom Browser wenn die vorherigen Erkennungen
  1592. fehlgeschlagen sind
  1593. </para>
  1594. </listitem>
  1595. <listitem>
  1596. <para>
  1597. Erkennt das Gebietsschema vom Betriebssystem wenn die vorherigen Erkennungen
  1598. fehlgeschlagen sind
  1599. </para>
  1600. </listitem>
  1601. <listitem>
  1602. <para>
  1603. Erkennt das Gebietsschema vom Framework wenn die vorherigen Erkennungen
  1604. fehlgeschlagen sind
  1605. </para>
  1606. </listitem>
  1607. <listitem>
  1608. <para>
  1609. Gibt immer einen String zurück der das gefundene Gebietsschema repräsentiert
  1610. </para>
  1611. </listitem>
  1612. </itemizedlist>
  1613. <para>
  1614. Das folgende Beispiel zeigt wie diese Prüfungen und der obige Code mti einem einfachen
  1615. Aufruf vereinfacht werden kann:
  1616. </para>
  1617. <example id="zend.locale.detection.example-4">
  1618. <title>Gebietsschema bezogenes Verhalten mit ZF 1.8</title>
  1619. <programlisting language="php"><![CDATA[
  1620. $locale = Zend_Locale::findLocale($inputstring);
  1621. ]]></programlisting>
  1622. </example>
  1623. </sect2>
  1624. </sect1>