Explorar o código

sync Japanese document with r16186.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16337 44c647ce-9c0f-0410-b52a-842ac1e357ba
takagi %!s(int64=16) %!d(string=hai) anos
pai
achega
ce268b3916

+ 14 - 14
documentation/manual/ja/module_specs/Zend_Date-Additional.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15851 -->
+<!-- EN-Revision: 16186 -->
 <sect1 id="zend.date.additional">
 
     <title>動作例</title>
@@ -20,18 +20,18 @@
             しかし、文字列で渡されると、それが本当に日付を表すものなのかがわかりません。
             そこで <classname>Zend_Date</classname> では、
             日付文字列を調べるために独自の静的関数を用意することにしました。
-            <classname>Zend_Locale</classname> には <code>getDate($date, $locale);</code>
+            <classname>Zend_Locale</classname> には <methodname>getDate($date, $locale);</methodname>
             という関数があり、これは日付を受け取って、適切に正規化された内容を返します。
             たとえば、月の名前が指定されていた場合もそれを適切に解釈し、
             数値に変換して返します。しかし、<classname>Zend_Locale</classname>
             は日付については何も知りません。なぜなら、
             このクラスは正規化および地域化を行うためのクラスだからです。
-            そこで、日付を確認する関数 <code>isDate($date);</code>
+            そこで、日付を確認する関数 <methodname>isDate($date);</methodname>
             と組み合わせて使用するようにします。
         </para>
 
         <para>
-            <code>isDate($date, $format, $locale);</code> は最大で三つまでのパラメータを受け取ります。
+            <methodname>isDate($date, $format, $locale);</methodname> は最大で三つまでのパラメータを受け取ります。
             そのうちのひとつは必須です。そのひとつは、当然ながら調べたい日付となります。
             この日付は文字列で渡します。二番目のパラメータは日付の書式を表します。
             これを省略した場合は、そのロケールの書式を使用します。
@@ -47,12 +47,12 @@
         </para>
 
         <para>
-            <code>isDate();</code> は、存在しない日付についての確認も行います。
+            <methodname>isDate()</methodname> は、存在しない日付についての確認も行います。
             <classname>Zend_Date</classname> 自体は日付についての確認を行いません。
             つまり、たとえば '31.February.2000' のような日付を <classname>Zend_Date</classname>
             で作成することもできます。この場合、<classname>Zend_Date</classname>
             は自動的に日付を適切な値に修正して返します。この例の場合なら
-            '03.March.2000' となります。一方 <code>isDate()</code>
+            '03.March.2000' となります。一方 <methodname>isDate()</methodname>
             は日付の確認を行い、'31.February.2000' を渡すと false を返します。
             というのもそんな日付はありえないということを知っているからです。
         </para>
@@ -121,8 +121,8 @@ print_r (Zend_Date_Cities::getCityList());
         </example>
 
         <para>
-            位置データ自体を取得するには、関数 <classname>Zend_Date_Cities::City()</classname> を使用します。
-            この関数に、<classname>Zend_Date_Cities::getCityList()</classname> が返す都市名を渡します。
+            位置データ自体を取得するには、関数 <methodname>Zend_Date_Cities::City()</methodname> を使用します。
+            この関数に、<methodname>Zend_Date_Cities::getCityList()</methodname> が返す都市名を渡します。
             また、オプションの二番目のパラメータで、水平線の種類を設定します。
         </para>
 
@@ -193,8 +193,8 @@ $mylocation = array('latitude' => 41.5, 'longitude' => 13.2446);
             これで、必要なデータがすべて設定できました。次に行うことは、
             日の出や日没に関する情報を取得したい日付を表す <classname>Zend_Date</classname>
             オブジェクトの作成です。算出用の関数は三つあります。
-            日没情報を算出するのが '<code>getSunset()</code>'、日の出の情報は '<code>getSunrise()</code>'、
-            そして太陽に関するすべての情報を取得するのが '<code>getSunInfo()</code>' です。
+            日没情報を算出するのが '<methodname>getSunset()</methodname>'、日の出の情報は '<methodname>getSunrise()</methodname>'、
+            そして太陽に関するすべての情報を取得するのが '<methodname>getSunInfo()</methodname>' です。
             算出した結果は、その時刻を保持する <classname>Zend_Date</classname>
             オブジェクトとして返されます。
         </para>
@@ -232,7 +232,7 @@ foreach ($info as $sun) {
             つまり、日付を扱う際には適切なタイムゾーンを設定しなければならないということです。
             複雑な話のように聞こえるかも知れませんが、思ったほど複雑でもありません。
             <classname>Zend_Date</classname> の最初の章で既に説明したとおり、デフォルトのタイムゾーンは
-            <code>php.ini</code> あるいは起動ファイル内で設定されています。
+            <filename>php.ini</filename> あるいは起動ファイル内で設定されています。
         </para>
 
         <para>
@@ -245,17 +245,17 @@ foreach ($info as $sun) {
         </para>
 
         <para>
-            <code>getTimezone()</code> は <classname>Zend_Date</classname>
+            <methodname>getTimezone()</methodname> は <classname>Zend_Date</classname>
             オブジェクト内で実際に設定されているタイムゾーンを返します。
             <classname>Zend_Date</classname> は、PHP の内部とは連携していないことを覚えておきましょう。
             つまり、返されるタイムゾーンは、PHP スクリプトのタイムゾーンではなく
             そのオブジェクトのタイムゾーンとなるということです。
-            <code>setTimezone($zone)</code> がもうひとつの関数で、
+            <methodname>setTimezone($zone)</methodname> がもうひとつの関数で、
             これは <classname>Zend_Date</classname> に新しいタイムゾーンを設定します。
             指定したタイムゾーンに対しては常にチェックが行われ、
             もしそのタイムゾーンが存在しない場合は例外がスローされます。
             スクリプトやシステムの実際のタイムゾーンをオブジェクトに設定するには、
-            パラメータを指定せずに <code>setTimezone()</code> をコールします。
+            パラメータを指定せずに <methodname>setTimezone()</methodname> をコールします。
             date オブジェクトを作成する際には、自動的にこれが行われます。
         </para>
 

+ 9 - 9
documentation/manual/ja/module_specs/Zend_Date-Basic.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15851 -->
+<!-- EN-Revision: 16186 -->
 <sect1 id="zend.date.basic">
 
     <title>基本メソッド</title>
@@ -31,7 +31,7 @@
         <para>
             引数を指定せずにインスタンスを作成すると、
             デフォルトのロケールでの現在時刻を表すオブジェクトを返します。
-            PHP の <code>time()</code> 関数で、このオブジェクトが使用する
+            PHP の <methodname>time()</methodname> 関数で、このオブジェクトが使用する
             <ulink url="http://en.wikipedia.org/wiki/Unix_Time">UNIX タイムスタンプ</ulink>
             を取得します。PHP の環境で、
             <link linkend="zend.date.setdefaulttimezone">デフォルトのタイムゾーン</link>
@@ -67,7 +67,7 @@ print $date;
             <para>
                 <classname>Zend_Date</classname> オブジェクトの日付を
                 地域化された形式の整数あるいは文字列で取得する際に、
-                <code>get()</code> メソッドを使用します。このメソッドには、
+                <methodname>get()</methodname> メソッドを使用します。このメソッドには、
                 さまざまなオプションが使用可能です。これらのオプションについてはあとで説明します。
             </para>
 
@@ -88,7 +88,7 @@ print $date->get();
             <title>日付の設定</title>
 
             <para>
-                <code>set()</code> メソッドは、オブジェクトに格納されている日付を変更し、
+                <methodname>set()</methodname> メソッドは、オブジェクトに格納されている日付を変更し、
                 変更後の値をタイムスタンプ (オブジェクトではありません) で返します。
                 このメソッドでもさまざまなオプションが使用可能です。
                 これらのオプションについてはあとで説明します。
@@ -112,11 +112,11 @@ print $date->get(Zend_Date::W3C);
             <title>日付の加減算</title>
 
             <para>
-                二つの日付を <code>add()</code> で加算するという場合、
+                二つの日付を <methodname>add()</methodname> で加算するという場合、
                 通常は実際の日付データにそうでない日付データの一部 ("12 時間" など)
                 を加算することになります。たとえば以下の例のようなものです。
-                <code>add()</code> および <code>sub()</code> は、どちらも
-                <code>set()</code> と同様のオプションを使用します。
+                <methodname>add()</methodname> および <methodname>sub()</methodname> は、どちらも
+                <methodname>set()</methodname> と同様のオプションを使用します。
                 これについてはあとで説明します。
             </para>
 
@@ -147,7 +147,7 @@ echo "toString() で取得した日付 = ", $date, "\n";
                 また、日付の一部に対して操作する (日付の "分"
                 の部分だけをある値と比較するなど) こともできます。
                 たとえば、現在時刻の "分" の部分を指定した値と比較するには
-                <code>compare()</code> を使用します。以下に例を示します。
+                <methodname>compare()</methodname> を使用します。以下に例を示します。
             </para>
 
             <example id="zend.date.simple.functions.compare.example-1">
@@ -165,7 +165,7 @@ if ($date->compare(10, Zend_Date::MINUTE) == -1) {
             </example>
 
             <para>
-                単純に等しいかどうかを比較するには <code>equals()</code>
+                単純に等しいかどうかを比較するには <methodname>equals()</methodname>
                 を使用します。これは boolean 値を返します。
             </para>
 

+ 3 - 3
documentation/manual/ja/module_specs/Zend_Date-Constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15851 -->
+<!-- EN-Revision: 16186 -->
 <sect1 id="zend.date.constants">
 
     <title>日付関数全般用の定数</title>
@@ -1129,12 +1129,12 @@ print $date->toString("'Era:GGGG='GGGG, ' Date:yy.MMMM.dd'yy.MMMM.dd");
             <classname>Zend_Date::setOptions(array('format_type' => 'php'))</classname> を使用しましょう。これで、
             Zend_Date のメソッドで ISO 書式指定子ではなく PHP の date() での指定子を用いるようになります
             その後の書式パラメータは、すべて
-            <ulink url="http://php.net/date">PHP の <code>date()</code> 書式指定子</ulink>
+            <ulink url="http://php.net/date">PHP の <methodname>date()</methodname> 書式指定子</ulink>
             に従うようになります。PHP の日付書式には含まれていないけれども ISO の書式には含まれるもの、
             またその逆もあります。もしそれほど PHP の日付書式になじみがないのなら、標準の
             ISO 書式を使用しましょう。既存のコードで PHP の日付書式をしているものがある場合は
             <link linkend="zend.locale.date.normalize">Zend_Locale_Format::convertPhpToIsoFormat()</link>
-            で ISO 書式に変換するか、<code>setOptions()</code>
+            で ISO 書式に変換するか、<methodname>setOptions()</methodname>
             を使用します。次の例は、下の表の定数を用いて独自の書式を定義するものです。
         </para>
 

+ 3 - 3
documentation/manual/ja/module_specs/Zend_Date-Creation.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15851 -->
+<!-- EN-Revision: 16186 -->
 <sect1 id="zend.date.creation">
 
     <title>日付の作成</title>
@@ -45,8 +45,8 @@ $date = new Zend_Date();
 
             <para>
                 静的メソッドを使用したほうが簡単に日付を作成できるという場合もあるでしょう。
-                そんな場合は <emphasis><code>now()</code></emphasis>
-                メソッドが使用できます。これは、<code>new Zend_Date()</code>
+                そんな場合は <emphasis><methodname>now()</methodname></emphasis>
+                メソッドが使用できます。これは、<command>new Zend_Date()</command>
                 とした時と同じ内容の <classname>Zend_Date</classname> オブジェクトを返します。
                 しかし、これは常にその時の日付情報を持つオブジェクトとなり、
                 オプションのパラメータで値を変更することはできません。

+ 29 - 25
documentation/manual/ja/module_specs/Zend_Date-Overview.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15851 -->
+<!-- EN-Revision: 16186 -->
 <sect1 id="zend.date.overview">
 
     <title>Zend_Date API の概要</title>
@@ -20,7 +20,7 @@
             <title>日付の書式の型の選択</title>
 
             <para>
-                いくつかのメソッドでは、PHP の <code>date()</code> 関数と似た形式の日付書式文字列を使用します。
+                いくつかのメソッドでは、PHP の <methodname>date()</methodname> 関数と似た形式の日付書式文字列を使用します。
                 PHP の日付書式指定子のほうが ISO 書式指定子よりなじみがあるという場合は、
                 <classname>Zend_Date::setOptions(array('format_type' => 'php'))</classname>
                 とすることができます。こうすると、<varname>$format</varname>
@@ -54,8 +54,9 @@
                 タイムスタンプが 1 時間少なくなるので、日付も予期したものより 1 日少なくなってしまいます。
                 これを避けるためにはオプション <code>fix_dst</code> を使用します。
                 このオプションのデフォルトは true で、この場合は夏時間が
-                "月" の計算 (<code>addMOnth()、subMonth()</code>) に影響を与えなくなります。
-                <classname>Zend_Date::setOptions(array('fix_dst' => false))</classname> とすると、
+                "月" の計算 (<methodname>addMonth()</methodname>、
+                <methodname>subMonth()</methodname>) に影響を与えなくなります。
+                <methodname>Zend_Date::setOptions(array('fix_dst' => false))</methodname> とすると、
                 夏時間にあわせた時間の加減算を "月" の計算時にも適用します。
             </para>
 
@@ -142,8 +143,8 @@
             <ulink url="http://en.wikipedia.org/wiki/Unix_Time">UNIX タイムスタンプ</ulink>を使用します。
             各地域固有の方式で日付を表示するには、まずタイムゾーンを知る必要があります。
             デフォルトのタイムゾーンは常に GMT/UTC です。オブジェクトのタイムゾーンを調べるには
-            <code>getTimeZone())</code> を使用します。オブジェクトのタイムゾーンを変更するには
-            <code>setTimeZone())</code> を使用します。
+            <methodname>getTimeZone()</methodname> を使用します。オブジェクトのタイムゾーンを変更するには
+            <methodname>setTimeZone()</methodname> を使用します。
             これらのオブジェクトに対するすべての操作は、このタイムゾーンを想定して行われます。
         </para>
 
@@ -205,7 +206,7 @@ echo $date3, "\n"; // 出力は "Mar 3, 2007 12:00:00 AM" となります
             <varname>$locale</varname> パラメータの内容をもとにして地域化した結果
             (日付書式を文字列で表したもの) を出力します。
             入力パラメータ <varname>$date</varname> に具体的な型が指定されている場合もあります
-            (たとえば <code>addHour()</code> では <varname>$hour</varname> です)。
+            (たとえば <methodname>addHour()</methodname> では <varname>$hour</varname> です)。
             このような場合でも、引数として <classname>Zend_Date</classname>
             オブジェクトを使用できることに注意しましょう。
             <varname>$locale</varname> を指定しなかった場合は、
@@ -238,10 +239,12 @@ $date = new Zend_Date('31.Feb.2007');
         <title>多くの日付要素で共通に使用できる、Zend_Date の基本操作</title>
 
         <para>
-            メソッド <code>add(), sub(), compare(), get(), and set()</code>
+            メソッド <methodname>add()</methodname>, <methodname>sub()</methodname>,
+            <methodname>compare()</methodname>, </methodname>get()</methodname> および
+            <methodname>set()</methodname>
             は、日付全般に対して使用できます。それぞれのメソッドは、
             そのインスタンスが保持する日付の値を操作します。
-            これらのメソッドのうち、<code>get()</code>
+            これらのメソッドのうち、<methodname>get()</methodname>
             以外ではすべて <varname>$date</varname> オペランドが必要となります。
             ここには <classname>Zend_Date</classname> のインスタンスか
             数値文字列、あるいは整数値を指定します。
@@ -252,7 +255,7 @@ $date = new Zend_Date('31.Feb.2007');
             たとえば "年"、"分" などが指定できます。それだけではなく、
             "December 31, 2007 23:59:59" のような長い形式の文字列も
             <varname>$date</varname> に指定できます。
-            <code>compare()</code> および <code>get()</code>
+            <methodname>compare()</methodname> および <methodname>get()</methodname>
             以外のメソッドは、処理の結果としてオブジェクト内の日付が変更されます。
         </para>
 
@@ -275,11 +278,11 @@ print $date;
             をいちいちタイプする必要がなくなります。
             好都合なことに、これらのメソッドの名前は
             プレフィックス (基本操作の名前) とサフィックス (日付要素の名前)
-            を組み合わせた形式、たとえば <code>addYear()</code>
+            を組み合わせた形式、たとえば <methodname>addYear()</methodname>
             のようになっています。以下の一覧における、すべての
             "日付要素" と "基本操作" の組み合わせが存在します。
             たとえば "add" は、各要素について
-            <code>addDay()</code> や <code>addYear()</code>
+            <methodname>addDay()</methodname> や <methodname>addYear()</methodname>
             などといったメソッドが存在します。
         </para>
 
@@ -354,8 +357,8 @@ print $date;
                              <classname>Zend_Date</classname> では、秒未満の単位を扱うために
                              二つのメソッドを用意しています。デフォルトでは、
                              <classname>Zend_Date</classname> のインスタンスはミリ秒単位の精度を使用します。
-                             これは <code>getFractionalPrecision()</code> を使用して取得します。
-                             精度を変更するには <code>setFractionalPrecision($precision)</code>
+                             これは <methodname>getFractionalPrecision()</methodname> を使用して取得します。
+                             精度を変更するには <methodname>setFractionalPrecision($precision)</methodname>
                              を使用します。しかし、精度は事実上ミリ秒までに制限されます。
                              というのも、<classname>Zend_Date</classname> は <code>
                              <ulink url="http://php.net/microtime">microtime()</ulink></code>
@@ -367,7 +370,7 @@ print $date;
                                 <ulink url="http://ja.wikipedia.org/wiki/%E6%97%A5">Day (日)</ulink>
                             </entry>
                             <entry>
-                             <classname>Zend_Date::DAY_SHORT</classname> は <varname>$date</varname>
+                             <constant>Zend_Date::DAY_SHORT</constant> は <varname>$date</varname>
                              から抽出します。これは、<varname>$date</varname> オペランドが
                              <classname>Zend_Date</classname> のインスタンスであるか、
                              あるいは数値文字列である場合に行われます。
@@ -480,13 +483,13 @@ print $date;
                                     <emphasis>get($part = null, $locale = null)</emphasis>
                                 </para>
                                 <para>
-                                    <code>get($part)</code> を使用して、このオブジェクトの日付の
+                                    <methodname>get($part)</methodname> を使用して、このオブジェクトの日付の
                                     <varname>$part</varname> の部分を取得します。
                                     結果は、<varname>$locale</varname>
                                     にもとづいて地域化された書式の文字列か整数値となります。
                                     BCMath 拡張モジュールを使用している場合は、
                                     大きな値の場合に整数ではなく数値文字列が返されるかもしれません。
-                                    <emphasis>注意:</emphasis> <code>get()</code>
+                                    <emphasis>注意:</emphasis> <methodname>get()</methodname>
                                     とは異なり、その他の get*() 系のメソッドは
                                     <classname>Zend_Date</classname> のインスタンスのみを返します。
                                     その中身は、選択された時刻/日付となります。
@@ -669,9 +672,10 @@ print $date;
                                 <emphasis>isLeapYear()</emphasis>
                             </para>
                             <para>
-                                <code>isLeapYear()</code> を使用して、
+                                <methodname>isLeapYear()</methodname> を使用して、
                                 そのオブジェクトが閏年であるかどうかを調べます。あるいは
-                                Zend_Date::checkLeapYear($year) を使用すると、$year
+                                <methodname>Zend_Date::checkLeapYear($year)</methodname> を使用すると、
+                                <varname>$year</varname>
                                 (文字列、整数値 あるいは <classname>Zend_Date</classname> のインスタンス)
                                 が閏年かどうかを知ることができます。
                             </para>
@@ -722,9 +726,9 @@ print $date;
                                 <emphasis>toString($format = null, $locale = null)</emphasis>
                             </para>
                             <para>
-                                直接実行することもできますし、マジックメソッド <code>__toString()</code>
+                                直接実行することもできますし、マジックメソッド <methodname>__toString()</methodname>
                                 から間接的にコールされることもあります。
-                                <code>toString()</code> メソッドは、自動的にオブジェクトの値の書式を設定します。
+                                <methodname>toString()</methodname> メソッドは、自動的にオブジェクトの値の書式を設定します。
                                 この書式は、オブジェクトのロケールか、あるいはオプションで指定した
                                 <varname>$locale</varname> にもとづいて決まります。
                                 サポートする書式コードの一覧は、
@@ -824,11 +828,11 @@ print $date;
                                 のような非数値要素を選択した場合は、
                                 <constant>FALSE</constant> を返します。
                                 <emphasis>注意:</emphasis> このメソッドは
-                                <link linkend="id.date.basic.operations"><code>get()</code></link>
+                                <link linkend="id.date.basic.operations"><methodname>get()</methodname></link>
                                 をコールし、結果を PHP の integer 型にキャストします。つまり、
-                                <code>get()</code> の返す結果が非常に大きな数値を表す数値表現となり、
+                                <methodname>get()</methodname> の返す結果が非常に大きな数値を表す数値表現となり、
                                 それが PHP の integer 型の制限をこえた場合には予期せぬ結果となります。
-                                そのような場合は、かわりに <code>get()</code> を使用します。
+                                そのような場合は、かわりに <methodname>get()</methodname> を使用します。
                             </para>
                         </entry>
                     </row>
@@ -856,7 +860,7 @@ print $date;
                                 <emphasis>now($locale = null)</emphasis>
                             </para>
                             <para>
-                                この関数は、<code>new Zend_Date()</code> と同等です。
+                                この関数は、<command>new Zend_Date()</command> と同等です。
                                 これは、現在の日付を表す <classname>Zend_Date</classname>
                                 オブジェクトに、ロケール <varname>$locale</varname>
                                 を指定して返します。