diff options
Diffstat (limited to 'documentation/manual-pages/ja/man3/calendar.3')
| -rw-r--r-- | documentation/manual-pages/ja/man3/calendar.3 | 217 |
1 files changed, 217 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man3/calendar.3 b/documentation/manual-pages/ja/man3/calendar.3 new file mode 100644 index 0000000000..d5a734c722 --- /dev/null +++ b/documentation/manual-pages/ja/man3/calendar.3 @@ -0,0 +1,217 @@ +.\" Copyright (c) 1997 Wolfgang Helbig +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" %FreeBSD: src/lib/libcalendar/calendar.3,v 1.6.2.5 2001/12/17 10:08:28 ru Exp % +.\" $FreeBSD$ +.\" +.Dd November 29, 1997 +.Dt CALENDAR 3 +.Os +.Sh 名称 +.Nm easterg , +.Nm easterog , +.Nm easteroj , +.Nm gdate , +.Nm jdate , +.Nm ndaysg , +.Nm ndaysj , +.Nm week , +.Nm weekday +.Nd 西暦での日付けの演算 +.Sh ライブラリ +.Lb libcalendar +.Sh 書式 +.In calendar.h +.Ft struct date * +.Fn easterg "int year" "struct date *dt" +.Ft struct date * +.Fn easterog "int year" "struct date *dt" +.Ft struct date * +.Fn easteroj "int year" "struct date *dt" +.Ft struct date * +.Fn gdate "int nd" "struct date *dt" +.Ft struct date * +.Fn jdate "int nd" "struct date *dt" +.Ft int +.Fn ndaysg "struct date *dt" +.Ft int +.Fn ndaysj "struct date *dt" +.Ft int +.Fn week "int nd" "int *year" +.Ft int +.Fn weekday "int nd" +.Sh 解説 +これらの関数は、西暦 0 年 (すなわち B.C. 1 年) 3 月 1 日 +から西暦 100000 年までの +広範囲の年月のカレンダを演算します。 +.Pp +プログラムは +.Fl lcalendar +とリンクさせる必要があります。 +.Pp +関数 +.Fn easterg , +.Fn easterog +および +.Fn easteroj +は、 +Easter Sunday (復活祭の日曜日) +の日付けを、 +.Fa dt +で指定した構造体に保存し、 +この構造体のポインタを返します。 +関数 +.Fn easterg +は、グレゴリオ暦 +(1582 年以降に西ヨーロッパのほとんどのキリスト教会で採用された) +を仮定し、 +関数 +.Fn easterog +および +.Fn easteroj +は、正統派 +(1582 年以前の西ヨーロッパ教会、および今日まで続く +ギリシャ正教会、ロシア正教会などいわゆる東方正教会) +の規則に従って、 +Easter Sunday +の日付けを演算します。 +その結果、 +.Fn easterog +はグレゴリオ暦(現行太陽暦)を返し、 +.Fn easteroj +はユリウス暦(旧太陽暦)を返します。 +.Pp +関数 +.Fn gdate , +.Fn jdate , +.Fn ndaysg +および +.Fn ndaysj +は、日付けの +.Qq 年、月、日 +という一般表記と、より演算に適した +.Qq 日数 +表現の相互変換を行います。 +B.C. 1 年 3 月 1 日を 0 として、 +以降の経過日に順番に番号が振られます。 +すなわちこの日番号は、 +B.C. 1 年 3 月 1 日からその日までの経過日数を示します。 +変換は、正数の日番号に対してだけ機能します。 +.Pp +.Fn gdate +および +.Fn jdate +関数は、日番号 +.Fa nd +に対応する日付けを +.Fa dt +で指定した構造体に保存し、その構造体のポインタを返します。 +.Pp +.Fn ndaysg +および +.Fn ndaysj +関数は、 +.Fa dt +で指定した日付けの日番号を返します。 +.Pp +.Fn gdate +および +.Fn ndaysg +関数は、1582 年 10 月 4 日以降のグレゴリオ暦および、 +以前のユリウス暦を仮定しますが、 +一方、 +.Fn jdate +および +.Fn ndaysj +は一貫してユリウス暦だけを仮定します。 +.Pp +これら 2 つの暦ではうるう年の定義が違います。 +ユリウス暦では 4 の倍数の年はすべてうるう年ですが、 +グレゴリオ暦ではそのうちの +100 の倍数で、400 の 倍数ではない年を除きます。 +すなわち、1700, 1800, 1900, 2100 年はうるう年ではなく、 +2000 年はうるう年になります。 +この新たな規則は、1582 年 10 月 4 日に、 +同日以降の 10 日を削除することで開始されました。 +カトリック国家のほとんどは、 +16 世紀末までにこの新暦を採用しましたが、 +一方、20 世紀までなおユリウス暦にとどまる国々もありました。 +英国とその植民地が新暦に切り替えたのは、1752 年 9 月 2 日でしたが、 +その時点ではすでに 11 日を削除する必要がありました。 +.Pp +関数 +.Fn week +は、 +.Fa nd +で指定された日番号の日付けが含まれる週番号を返します。 +引数 +.Fa *year +は、その週 (の半分以上) が含まれる年に設定されます。 +週番号は、各年の 3 日以上が含まれる第 1 週を 1 として、 +順番に振られます。 +週は月曜日から始まります。 +この関数はグレゴリオ暦だけに定義されます。 +.Pp +関数 +.Fn weekday +は、 +.Fa nd +で指定された日番号の日付けの曜日 +(月曜 = 0 … 日曜 = 6) +を返します。 +.Pp +構造体 +.Fa date +は +.Aq Pa calendar.h +内で定義されています。次のフィールドを +含みます。 +.Bd -literal -offset indent +int y; /\(** year (0000 - ????) \(**/ +int m; /\(** month (1 - 12) \(**/ +int d; /\(** day of month (1 - 31) \(**/ +.Ed +.Pp +0 年は歴史家の手では +.Qq 1 B.C. +と書かれますが、天文学者とこのライブラリでは +.Qq 0 +と表記されます。 +.Sh 関連項目 +.Xr ncal 1 , +.Xr strftime 3 +.Sh 規格 +週番号は ISO 8601: 1988 に適合しています。 +.Sh 歴史 +.Nm calendar +ライブラリは +.Fx 3.0 +ではじめて登場しました。 +.Sh 作者 +このマニュアルページとライブラリは、 +.An Wolfgang Helbig Aq helbig@FreeBSD.org +によって書かれました。 +.Sh バグ +このライブラリはきわめて慎重にコーディングされたので、 +残されたバグはありません。 |