-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.html
91 lines (78 loc) · 3.64 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>Holidays JP API (日本の祝日API)</title>
<meta name="description" content="Holidays JP API は、日本の祝日一覧をJSONで返却するAPIです (CSV形式もサポート)">
<meta content="https://avatars1.githubusercontent.com/u/24262823?v=3&s=400" name="twitter:image:src" />
<meta content="https://avatars1.githubusercontent.com/u/24262823?v=3&s=400" property="og:image" />
<link rel="icon" type="image/x-icon" href="https://avatars1.githubusercontent.com/u/24262823?v=3&s=400">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/marx/2.0.7/marx.min.css">
<style>
h2 {
margin-top: 3em;
}
h3, h4, h5 {
margin-top: 2em;
}
</style>
</head>
<body>
<main>
<h1>🎌 Holidays JP API</h1>
<p>日本の国民の祝日の一覧を、JSON形式もしくはCSV形式で返すAPIです。</p>
<p>データは Google が用意している Googleカレンダーの情報から自動で生成しています。</p>
<p>去年・今年・来年のデータが取得可能です。</p>
<h2>祝日一覧API (date)</h2>
<h3>URL</h3>
<p><a href="https://holidays-jp.github.io/api/v1/date.json">https://holidays-jp.github.io/api/v1/date.json</a></p>
<h3>返却例</h3>
<pre><code>{
"2017-01-01": "元日",
"2017-01-02": "元日 振替休日",
"2017-01-09": "成人の日"
}</code></pre>
<p>日付をキーに、祝日名が入ったオブジェクトを返します。</p>
<h3>CSV形式</h3>
<p>URL末尾の拡張子部分を csv にすることで、CSV形式で返します(全API共通)。</p>
<p><a href="https://holidays-jp.github.io/api/v1/date.csv">https://holidays-jp.github.io/api/v1/date.csv</a></p>
<h3>返却例</h3>
<pre><code>2017-01-01,元日
2017-01-02,"元日 振替休日"
2017-01-09,成人の日
</code></pre>
<h2>祝日一覧API (datetime)</h2>
<h3>URL</h3>
<p><a href="https://holidays-jp.github.io/api/v1/datetime.json">https://holidays-jp.github.io/api/v1/datetime.json</a></p>
<h3>返却例</h3>
<pre><code>{
"1420038000": "元日",
"1420988400": "成人の日",
"1423580400": "建国記念の日"
}</code></pre>
<p>unixtimeをキーに、祝日名が入ったオブジェクトを返します。</p>
<h2>年別API (date)</h2>
<h3>URL</h3>
<p><a href="https://holidays-jp.github.io/api/v1/2017/date.json">https://holidays-jp.github.io/api/v1/2017/date.json</a></p>
<p>上記URLの <code>2017</code>の部分に、年号を4桁で指定します。</p>
<p>指定された年のデータだけを返します。返却形式は基本API(date)と同じです。</p>
<h2>年別API (datetime)</h2>
<h3>URL</h3>
<p><a href="https://holidays-jp.github.io/api/v1/2017/datetime.json">https://holidays-jp.github.io/api/v1/2017/datetime.json</a></p>
<p>上記URLの <code>2017</code>の部分に、年号を4桁で指定します。</p>
<p>指定された年のデータだけを返します。返却形式は基本API(datetime)と同じです。</p>
<hr>
<h2>License</h2>
<p>MIT</p>
<h3>紹介ブログ</h3>
<ul>
<li><a href="https://matsuoshi.hatenablog.com/entry/2018/11/14/000000">日本の祝日一覧を返す API - モノラルログ</a></li>
<li><a href="https://qiita.com/matsuoshi/items/7c19e7dcf404b7d921d6">日本の祝日を JSON / CSV 形式で返す API - Qiita</a></li>
</ul>
</main>
<footer>
by matsuoshi, <a href="https://monaural.net">monaural.net</a><br>
<a href="https://github.com/holidays-jp">https://github.com/holidays-jp</a>
</footer>
</body>
</html>