sync Japanese document with r17166, r17171, r17172, r17175, r17178, r17227, r17230, and r17342.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17562 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ja/module_specs/Zend_Date-Overview.xml

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16394 -->
+<!-- EN-Revision: 17342 -->
 <sect1 id="zend.date.overview">
 
     <title>Zend_Date API の概要</title>
 
     <para>
-        <classname>Zend_Date</classname> の API はシンプルで統一性がありますが、
+        <classname>Zend_Date</classname> の <acronym>API</acronym> はシンプルで統一性がありますが、
         非常に柔軟で強力な設計になっており、
         さまざまな操作や演算ができます。
     </para>
@@ -20,14 +20,14 @@
             <title>日付の書式の型の選択</title>
 
             <para>
-                いくつかのメソッドでは、PHP の <methodname>date()</methodname> 関数と似た形式の日付書式文字列を使用します。
-                PHP の日付書式指定子のほうが ISO 書式指定子よりなじみがあるという場合は、
-                <classname>Zend_Date::setOptions(array('format_type' => 'php'))</classname>
+                いくつかのメソッドでは、<acronym>PHP</acronym> の <methodname>date()</methodname> 関数と似た形式の日付書式文字列を使用します。
+                <acronym>PHP</acronym> の日付書式指定子のほうが <acronym>ISO</acronym> 書式指定子よりなじみがあるという場合は、
+                <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname>
                 とすることができます。こうすると、<varname>$format</varname>
-                パラメータを持つすべての関数で PHP の日付書式指定子が使用できるようになります。
-                <classname>Zend_Date::setOptions(array('format_type' => 'iso'))</classname>
+                パラメータを持つすべての関数で <acronym>PHP</acronym> の日付書式指定子が使用できるようになります。
+                <methodname>Zend_Date::setOptions(array('format_type' => 'iso'))</methodname>
                 とすると、デフォルトのモードに戻ります。このモードは、
-                ISO 日付書式トークンのみをサポートするものです。
+                <acronym>ISO</acronym> 日付書式トークンのみをサポートするものです。
                 サポートする書式コードの一覧は、
                 <xref linkend="zend.date.constants.phpformats" /> を参照ください。
             </para>
@@ -50,10 +50,10 @@
                 通常は 1 時間分足したり引いたりします。
                 たとえば、春の夏時間適用日をまたがる日付計算の結果は、
                 時刻部分が 00:00:00 のままの場合は予期したものより 1 日少なくなります。というのも、
-                Zend_Date は日付部分ではなくタイムスタンプに基づいて計算を行うからです。
+                <classname>Zend_Date</classname> は日付部分ではなくタイムスタンプに基づいて計算を行うからです。
                 タイムスタンプが 1 時間少なくなるので、日付も予期したものより 1 日少なくなってしまいます。
                 これを避けるためにはオプション <code>fix_dst</code> を使用します。
-                このオプションのデフォルトは true で、この場合は夏時間が
+                このオプションのデフォルトは <constant>TRUE</constant> で、この場合は夏時間が
                 "月" の計算 (<methodname>addMonth()</methodname>、
                 <methodname>subMonth()</methodname>) に影響を与えなくなります。
                 <methodname>Zend_Date::setOptions(array('fix_dst' => false))</methodname> とすると、
@@ -62,10 +62,10 @@
 
             <para>
                 <emphasis><classname>Zend_Date</classname>
-                インスタンスの実際のタイムゾーンが UTC あるいは GMT の場合、
+                インスタンスの実際のタイムゾーンが <acronym>UTC</acronym> あるいは <acronym>GMT</acronym> の場合、
                 オプション <code>'fix_dst'</code> は用いられません</emphasis>。
                 これらのタイムゾーンには DST は適用されないからです。
-                このインスタンスのタイムゾーンを UTC あるいは GMT 以外のものに変更すると、
+                このインスタンスのタイムゾーンを <acronym>UTC</acronym> あるいは <acronym>GMT</acronym> 以外のものに変更すると、
                 その前に設定されていた 'fix_dst' オプションの値を
                 "月" の計算時に適用します。
             </para>
@@ -79,15 +79,15 @@
                 ある日付に対して月を足したり引いたりすると、
                 もとの日付が月の最後のほうだった場合に予期せぬ結果となることがあります。
                 たとえば「1月31日」に一ヶ月足すことを考えてみましょう。
-                SQL に慣れている人なら、この結果は「2月28日」になるものと思われるでしょう。
+                <acronym>SQL</acronym> に慣れている人なら、この結果は「2月28日」になるものと思われるでしょう。
                 一方、Excel や OpenOffice を使っている人は、この結果が「3月3日」
                 になるものと考えるのではないでしょうか。
                 この問題は、計算結果の月の日数が元の日付の月の日数より少ない場合に起こりえます。
                 Zend Framework の開発者向けには、どちらの方式かを選択できるようにしました。
-                <code>extend_month</code> オプションを false にすると
-                SQL 風の挙動になり、true にすると表計算ソフト風の挙動になります。
-                <code>extend_month</code> のデフォルトは false なので、
-                <classname>Zend_Date</classname> は SQL 互換の計算をします。
+                <code>extend_month</code> オプションを <constant>FALSE</constant> にすると
+                <acronym>SQL</acronym> 風の挙動になり、<constant>TRUE</constant> にすると表計算ソフト風の挙動になります。
+                <code>extend_month</code> のデフォルトは <constant>FALSE</constant> なので、
+                <classname>Zend_Date</classname> は <acronym>SQL</acronym> 互換の計算をします。
                 デフォルトでは、<classname>Zend_Date</classname> は月の計算をする際に
                 (必要に応じて) 日を切り詰めます。計算した結果に該当する日がその月に存在しなかった場合に、
                 翌月にまたがることはありません。
@@ -105,8 +105,8 @@
                 <classname>Zend_Date</classname> を高速に動作させるには <classname>Zend_Cache</classname>
                 アダプタを使用します。これを使用すると、地域化したデータを扱う際の
                 <classname>Zend_Date</classname> のすべてのメソッドが高速化します。
-                たとえば、定数 <classname>Zend_Date::DATE</classname> や
-                <classname>Zend_Date::TIME</classname> を扱うメソッドは、すべてこの影響を受けます。
+                たとえば、定数 <constant>Zend_Date::DATE</constant> や
+                <constant>Zend_Date::TIME</constant> を扱うメソッドは、すべてこの影響を受けます。
                 <classname>Zend_Cache</classname> アダプタを <classname>Zend_Date</classname> に設定するには、
                 <classname>Zend_Date::setOptions(array('cache' => $adapter));</classname>
                 とするだけです。
@@ -123,7 +123,7 @@
                 <classname>Zend_Date</classname> は、この問題を
                 <classname>Zend_TimeSync</classname> で解決することができます。
                 タイムサーバを <classname>Zend_Date::setOptions(array('timesync' => $timeserver));</classname>
-                で設定すると、すべての Zend_Date インスタンスについて、
+                で設定すると、すべての <classname>Zend_Date</classname> インスタンスについて、
                 そのタイムスタンプと実際のタイムスタンプを間のオフセットを設定します。
                 このオプションを使用しても、既存のインスタンスのタイムスタンプは変わりません。
                 そこで、これを用いる場合は起動ファイルで設定することをおすすめします。
@@ -142,7 +142,7 @@
             このオブジェクトはタイムゾーンに関連付けられます。しかし、内部的な形式としては通常の
             <ulink url="http://en.wikipedia.org/wiki/Unix_Time">UNIX タイムスタンプ</ulink>を使用します。
             各地域固有の方式で日付を表示するには、まずタイムゾーンを知る必要があります。
-            デフォルトのタイムゾーンは常に GMT/UTC です。オブジェクトのタイムゾーンを調べるには
+            デフォルトのタイムゾーンは常に <acronym>GMT</acronym>/UTC です。オブジェクトのタイムゾーンを調べるには
             <methodname>getTimeZone()</methodname> を使用します。オブジェクトのタイムゾーンを変更するには
             <methodname>setTimeZone()</methodname> を使用します。
             これらのオブジェクトに対するすべての操作は、このタイムゾーンを想定して行われます。
@@ -160,18 +160,18 @@
         <para>
             ほとんどのメソッドで、引数 <varname>$part</varname> に定数を指定できます。
             これにより、日付のどの部分を選択するかを指定します。この定数は、
-            たとえば <classname>Zend_Date::HOUR</classname> のようになります。
+            たとえば <constant>Zend_Date::HOUR</constant> のようになります。
             これらの定数は、以下のすべての関数で使用できます。使用可能なすべての定数の一覧は
             <xref linkend="zend.date.constants.list" /> にあります。
-            <varname>$part</varname> を省略した場合は、<classname>Zend_Date::TIMESTAMP</classname>
+            <varname>$part</varname> を省略した場合は、<constant>Zend_Date::TIMESTAMP</constant>
             が指定されたものとみなします。また、ユーザ定義の書式を
             <varname>$part</varname> で使用することもできます。ここには、
-            <link linkend="zend.locale.date.normalize"><classname>Zend_Locale_Format::getDate()</classname>
+            <link linkend="zend.locale.date.normalize"><methodname>Zend_Locale_Format::getDate()</methodname>
             </link>
             と同様のコードを使用します。
             日付オブジェクトが明らかに無効な値を用いて作成された場合 (たとえば月が 12 より大きいなど) は、
             <classname>Zend_Date</classname> は例外をスローします。ただし、特定の日付フォーマットが指定されている場合、
-            つまり <varname>$part</varname> が <constant>NULL</constant> あるいは <classname>Zend_Date::DATES</classname> ("あいまいな" フォーマット)
+            つまり <varname>$part</varname> が <constant>NULL</constant> あるいは <constant>Zend_Date::DATES</constant> ("あいまいな" フォーマット)
             のいずれかである場合は別です。
         </para>
 
@@ -314,7 +314,7 @@ print $date;
                                 <ulink url="http://en.wikipedia.org/wiki/Unix_Time">Timestamp (タイムスタンプ)</ulink>
                             </entry>
                             <entry>
-                            UNIX タイムスタンプ。January 1st, 1970 00:00:00 GMT/UTC
+                            UNIX タイムスタンプ。January 1st, 1970 00:00:00 <acronym>GMT</acronym>/UTC
                             からの経過秒数です。
                         </entry>
                         </row>
@@ -375,9 +375,9 @@ print $date;
                              <classname>Zend_Date</classname> のインスタンスであるか、
                              あるいは数値文字列である場合に行われます。
                              それ以外の場合は、以下の定数によって指定した規約に基づいて抽出します。
-                             <classname>Zend_Date::WEEKDAY_NARROW</classname>、<classname>Zend_Date::WEEKDAY_NAME</classname>、
-                             <classname>Zend_Date::WEEKDAY_SHORT</classname>、
-                             <classname>Zend_Date::WEEKDAY</classname> (グレゴリオ暦とみなして処理します)。
+                             <constant>Zend_Date::WEEKDAY_NARROW</constant>、<constant>Zend_Date::WEEKDAY_NAME</constant>、
+                             <constant>Zend_Date::WEEKDAY_SHORT</constant>、
+                             <constant>Zend_Date::WEEKDAY</constant> (グレゴリオ暦とみなして処理します)。
                             </entry>
                         </row>
                         <row>
@@ -385,7 +385,7 @@ print $date;
                                 <ulink url="http://ja.wikipedia.org/wiki/%E9%80%B1">Week (週)</ulink>
                             </entry>
                             <entry>
-                             <classname>Zend_Date::WEEK</classname> は <varname>$date</varname>
+                             <constant>Zend_Date::WEEK</constant> は <varname>$date</varname>
                              から抽出します。これは、<varname>$date</varname> オペランドが
                              <classname>Zend_Date</classname> のインスタンスであるか、
                              あるいは数値文字列である場合に行われます。
@@ -395,12 +395,12 @@ print $date;
                         <row>
                             <entry>Date (日)</entry>
                             <entry>
-                             <classname>Zend_Date::DAY_MEDIUM</classname> は <varname>$date</varname>
+                             <constant>Zend_Date::DAY_MEDIUM</constant> は <varname>$date</varname>
                              から抽出します。これは、<varname>$date</varname> オペランドが
                              <classname>Zend_Date</classname> のインスタンスである場合に行われます。
                              それ以外の場合は、文字列 <varname>$date</varname>
                              を正規化して Zend_Date::DATE_MEDIUM 形式の日付にしようとします。
-                             <classname>Zend_Date::DAY_MEDIUM</classname> の書式は、
+                             <constant>Zend_Date::DAY_MEDIUM</constant> の書式は、
                              そのオブジェクトのロケールに依存します。
                             </entry>
                         </row>
@@ -408,14 +408,14 @@ print $date;
                             <entry>Weekday (曜日)</entry>
                             <entry>
                              曜日は、0 (日曜日) から 6 (土曜日) までの数字で表されます。
-                             <classname>Zend_Date::WEEKDAY_DIGIT</classname> は <varname>$date</varname>
+                             <constant>Zend_Date::WEEKDAY_DIGIT</constant> は <varname>$date</varname>
                              から抽出します。これは、<varname>$date</varname> オペランドが
                              <classname>Zend_Date</classname> のインスタンスであるか、
                              あるいは数値文字列である場合に行われます。
                              それ以外の場合は、以下の定数によって指定した規約に基づいて抽出します。
-                             <classname>Zend_Date::WEEKDAY_NARROW</classname>、<classname>Zend_Date::WEEKDAY_NAME</classname>、
-                             <classname>Zend_Date::WEEKDAY_SHORT</classname>、
-                             <classname>Zend_Date::WEEKDAY</classname> (グレゴリオ暦とみなして処理します)。
+                             <constant>Zend_Date::WEEKDAY_NARROW</constant>、<constant>Zend_Date::WEEKDAY_NAME</constant>、
+                             <constant>Zend_Date::WEEKDAY_SHORT</constant>、
+                             <constant>Zend_Date::WEEKDAY</constant> (グレゴリオ暦とみなして処理します)。
                             </entry>
                         </row>
                         <row>
@@ -431,11 +431,11 @@ print $date;
                                 <ulink url="http://www.faqs.org/rfcs/rfc822.html">Arpa</ulink>
                             </entry>
                             <entry>
-                             Arpa 日付 (つまり RFC 822 形式の日付) をサポートしています。
+                             Arpa 日付 (つまり <acronym>RFC</acronym> 822 形式の日付) をサポートしています。
                              出力形式は、"GMT" あるいは "地方時 + 時差" 形式になります
-                             (RFC 822 の section 5 を参照ください)。
-                             PHP 5.2.2 より前のバージョンでは、定数 DATE_RFC822 を
-                             PHP の日付関数で使用したときに
+                             (<acronym>RFC</acronym> 822 の section 5 を参照ください)。
+                             <acronym>PHP</acronym> 5.2.2 より前のバージョンでは、定数 DATE_RFC822 を
+                             <acronym>PHP</acronym> の日付関数で使用したときに
                              <ulink url="http://bugs.php.net/bug.php?id=40308">おかしな結果</ulink>
                              となる場合がありました。Zend_Date は、正しい結果を返します。
                              例: <code>Mon, 31 Dec 06 23:59:59 GMT</code>
@@ -446,7 +446,7 @@ print $date;
                                 <ulink url="http://ja.wikipedia.org/wiki/ISO_8601">Iso</ulink>
                             </entry>
                             <entry>
-                             出力形式として、完全な ISO 8601 日付のみをサポートしています。
+                             出力形式として、完全な <acronym>ISO</acronym> 8601 日付のみをサポートしています。
                              例: <code>2009-02-14T00:31:30+01:00</code>
                             </entry>
                         </row>
@@ -598,8 +598,8 @@ print $date;
                             </para>
                             <para>
                                 ロケール <varname>$locale</varname> で格納されている日付 <varname>$date</varname>
-                                の要素 <varname>$part</varname> がこのオブジェクトの日付要素と等しい場合に true、
-                                それ以外の場合に false を返します。
+                                の要素 <varname>$part</varname> がこのオブジェクトの日付要素と等しい場合に <constant>TRUE</constant>、
+                                それ以外の場合に <constant>FALSE</constant> を返します。
                             </para>
                         </entry>
                     </row>
@@ -612,7 +612,7 @@ print $date;
                             <para>
                                 このオブジェクトの日付要素 <varname>$part</varname> が、
                                 ロケール <varname>$locale</varname> で格納されている日付 <varname>$date</varname>
-                                の要素 <varname>$part</varname> より前である場合に true を返します。
+                                の要素 <varname>$part</varname> より前である場合に <constant>TRUE</constant> を返します。
                             </para>
                         </entry>
                     </row>
@@ -625,7 +625,7 @@ print $date;
                             <para>
                                 このオブジェクトの日付要素 <varname>$part</varname> が、
                                 ロケール <varname>$locale</varname> で格納されている日付 <varname>$date</varname>
-                                の要素 <varname>$part</varname> より後である場合に true を返します。
+                                の要素 <varname>$part</varname> より後である場合に <constant>TRUE</constant> を返します。
                             </para>
                         </entry>
                     </row>
@@ -689,8 +689,8 @@ print $date;
                             </para>
                             <para>
                                 このメソッドは、指定した日付が本当に日付であるかどうかを調べ、
-                                すべてのチェックを通過したときに true を返します。
-                                PHP の checkdate() 関数と似たような働きですが、各地域固有の月名にも対応しており、
+                                すべてのチェックを通過したときに <constant>TRUE</constant> を返します。
+                                <acronym>PHP</acronym> の checkdate() 関数と似たような働きですが、各地域固有の月名にも対応しており、
                                 また checkdate() の対象範囲外の日付でも正しく判定できます。
                             </para>
                         </entry>
@@ -746,69 +746,69 @@ print $date;
                             <para>
                                 選択した日付を、そのオブジェクトのロケールにもとづいて配列形式で返します。
                                 返される配列は
-                                PHP の <ulink url="http://php.net/getdate">getdate()</ulink>
+                                <acronym>PHP</acronym> の <ulink url="http://php.net/getdate">getdate()</ulink>
                                 関数が返すものと同じ形式で、次のような要素を含みます。
                             </para>
                             <para>
                                 <itemizedlist>
                                     <listitem>
                                         <para>
-                                            日を表す '<emphasis>day</emphasis>' (<classname>Zend_Date::DAY_SHORT</classname>)
+                                            日を表す '<emphasis>day</emphasis>' (<constant>Zend_Date::DAY_SHORT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            月を表す '<emphasis>month</emphasis>' (<classname>Zend_Date::MONTH_SHORT</classname>)
+                                            月を表す '<emphasis>month</emphasis>' (<constant>Zend_Date::MONTH_SHORT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            年を表す '<emphasis>year</emphasis>' (<classname>Zend_Date::YEAR</classname>)
+                                            年を表す '<emphasis>year</emphasis>' (<constant>Zend_Date::YEAR</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            時間を表す '<emphasis>hour</emphasis>' (<classname>Zend_Date::HOUR_SHORT</classname>)
+                                            時間を表す '<emphasis>hour</emphasis>' (<constant>Zend_Date::HOUR_SHORT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            分を表す '<emphasis>minute</emphasis>' (<classname>Zend_Date::MINUTE_SHORT</classname>)
+                                            分を表す '<emphasis>minute</emphasis>' (<constant>Zend_Date::MINUTE_SHORT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            秒を表す '<emphasis>second</emphasis>' (<classname>Zend_Date::SECOND_SHORT</classname>)
+                                            秒を表す '<emphasis>second</emphasis>' (<constant>Zend_Date::SECOND_SHORT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            タイムゾーンの略称を表す '<emphasis>timezone</emphasis>' (<classname>Zend_Date::TIMEZONE</classname>)
+                                            タイムゾーンの略称を表す '<emphasis>timezone</emphasis>' (<constant>Zend_Date::TIMEZONE</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            Unix タイムスタンプを表す '<emphasis>timestamp</emphasis>' (<classname>Zend_Date::TIMESTAMP</classname>)
+                                            Unix タイムスタンプを表す '<emphasis>timestamp</emphasis>' (<constant>Zend_Date::TIMESTAMP</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            曜日番号を表す '<emphasis>weekday</emphasis>' (<classname>Zend_Date::WEEKDAY_DIGIT</classname>)
+                                            曜日番号を表す '<emphasis>weekday</emphasis>' (<constant>Zend_Date::WEEKDAY_DIGIT</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            年初からの日数を表す '<emphasis>dayofyear</emphasis>' (<classname>Zend_Date::DAY_OF_YEAR</classname>)
+                                            年初からの日数を表す '<emphasis>dayofyear</emphasis>' (<constant>Zend_Date::DAY_OF_YEAR</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            週を表す '<emphasis>week</emphasis>' (<classname>Zend_Date::WEEK</classname>)
+                                            週を表す '<emphasis>week</emphasis>' (<constant>Zend_Date::WEEK</constant>)
                                         </para>
                                     </listitem>
                                     <listitem>
                                         <para>
-                                            GMT からの時差を表す '<emphasis>gmtsecs</emphasis>' (<classname>Zend_Date::GMT_SECS</classname>)
+                                            <acronym>GMT</acronym> からの時差を表す '<emphasis>gmtsecs</emphasis>' (<constant>Zend_Date::GMT_SECS</constant>)
                                         </para>
                                     </listitem>
                                 </itemizedlist>
@@ -824,14 +824,14 @@ print $date;
                             <para>
                                 指定した日付要素 <varname>$part</varname> の、
                                 そのオブジェクトのロケールにもとづいた整数表現を返します。
-                                <varname>$part</varname> で <classname>Zend_Date::MONTH_NAME_SHORT</classname>
+                                <varname>$part</varname> で <constant>Zend_Date::MONTH_NAME_SHORT</constant>
                                 のような非数値要素を選択した場合は、
                                 <constant>FALSE</constant> を返します。
                                 <emphasis>注意:</emphasis> このメソッドは
                                 <link linkend="id.date.basic.operations"><methodname>get()</methodname></link>
-                                をコールし、結果を PHP の integer 型にキャストします。つまり、
+                                をコールし、結果を <acronym>PHP</acronym> の integer 型にキャストします。つまり、
                                 <methodname>get()</methodname> の返す結果が非常に大きな数値を表す数値表現となり、
-                                それが PHP の integer 型の制限をこえた場合には予期せぬ結果となります。
+                                それが <acronym>PHP</acronym> の integer 型の制限をこえた場合には予期せぬ結果となります。
                                 そのような場合は、かわりに <methodname>get()</methodname> を使用します。
                             </para>
                         </entry>