曜日・祝日計算サービス
Webサービスは,サービス単体ではほとんど使い物にはなりません.みなさまが開発されるアプリケーションの一部機能について,インターネットを介してお手伝いするものです.
ご使用条件を必ずお読み下さい.
月単位で、曜日の計算、祝日の算出を行うサービスです。
サービスURL
このサービスのURLは http://www.finds.jp/ws/calendar.phpです.
パラメータ
Toy Service共通仕様もあわせてご覧下さい.
- jsonp (共通)
- 応答文書をJSONP形式にする場合に指定します.
- php (共通)
- 応答文書をPHPシリアル化形式にする場合に指定します.
- y
- 西暦年を指定します。yは2000以上でなければなりません。
- m
- 月を指定します。mは1以上12以下でなければなりません。
- y
- 応答文書に含まれる日付リストのタイプを指定します。デフォルトは a です。
- t=a
- 全ての日付のリストを応答文書に含めます。
- t=h
- 祝日等のみのリストを応答文書に含めます。
- l
- 応答文書に含まれる祝日等のレベルを指定します。デフォルトは 0 です。
- l=1
- 祝日のみ
- l=2
- 振り替え休日を含む
- l=3
- 国民の休日および振り替え休日を含む
- l=0 または lの指定なし
- 全祝日レベル(平日htype=0は除く)を祝日とします。
応答文書
ルート要素
本サービスのルート要素は 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を指定)
- PHPシリアライズ版
- 2009年9月 (国民の休日)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版
- エラー例 - 年のみ指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版
- エラー例 - パラメータなし