![[English]](../../img/2en-88x31.gif){kind=small}
曜日・祝日計算サービス
月単位で，曜日の計算，祝日の算出を行うサービスです．
Webサービスは，サービス単体ではほとんど使い物にはなりません．みなさまが開発されるアプリケーションの一部機能について，インターネットを介してお手伝いするものです．
サービスURL
このサービスのURLは http://www.finds.jp/ws/calendar.phpです．
パラメータ
Toy Service共通仕様もあわせてご覧下さい．
- jsonp (共通)
- 応答文書をJSONP形式にする場合に指定します．値を指定しない場合はJSON形式を返却します．
- json (共通)
- 応答文書をJSON形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- php (共通)
- 応答文書をPHPシリアル化形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- y
- 西暦年を指定します．yは2000以上でなければなりません．
- m
- 月を指定します．mは1以上12以下でなければなりません．
- t
- 応答文書に含まれる日付リストのタイプを指定します．デフォルトは a です．
- t=a
- 全ての日付のリストを応答文書に含めます．
- t=h
- 祝日等のみのリストを応答文書に含めます．
- l
- 応答文書に含まれる祝日等のレベルを指定します．デフォルトは 0 です．
- l=1
- 祝日のみ
- l=2
- 振り替え休日を含む
- l=3
- 国民の休日および振り替え休日を含む
- l=0 または lの指定なし
- 全祝日レベル(平日htype=0は除く)を祝日とします．
- lc
- 言語を選択します．デフォルトは日本語です．
- lc=en
- hname要素の実体を英語で記述します．hkana要素は出現しません．
応答文書
ルート要素
本サービスのルート要素は calendar です．
応答ステータス
| コード | 意味 |
|---|---|
| 200 | 成功した場合 (共通) |
| 400 | パラメータ等に誤りがあって失敗した場合 (共通) |
| 500 | サーバ側で問題があって失敗した場合 (共通) |
result要素
Toy Service共通仕様もあわせてご覧下さい．
result要素は次に示す子要素を持っています．
- <year>
- 指定した年を子要素に入れます．
- <month>
- 指定した月を子要素に入れます．
- <firstwday>
- 指定した年月の月初の曜日のコード(1:日曜,...7:土曜)を子要素に入れます．
- <days>
- 指定した年月の日数を子要素に入れます．
- <day> (繰り返し)
- 日ごとの繰り返しです．この要素は次の子要素を持ちます．
- mday
- その日の，月を単位とした日付を子要素に入れます．
- wday
- その日の，曜日のコード(1:日曜,...7:土曜)を子要素に入れます．
- htype
- その日の，祝日タイプを指定します．祝日タイプコードは次の通りです．
- 0
- 祝日等ではない
- 1
- 祝日
- 2
- 振替休日
- 3
- 国民の休日
- 9
- その他休日(いわゆる御用納期間)
- hname
- htypeが0より大きい(祝日等)の場合には，その名称を子要素に入れます．それ以外の場合には，この要素は出現しません．
- hkana
- 子要素に平仮名表記によるhnameの読みを入れます．この要素の出現条件は，日本語の場合は hname と同じです．英語の場合は必ず出現しません．
実行例
XML文書，またはJavaScriptやPHPで使用される表現で表示されます．人が見たら読みにくいものと感じるかもしれません．あらかじめご了承ください．
- 2008年5月 (振替休日)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- 2009年9月 (国民の休日)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - 年のみ指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - パラメータなし