{"repo":"880831ian/taiwan-calendar","free":true,"listed":false,"github":"https://github.com/880831ian/taiwan-calendar","clone":"git clone https://github.com/880831ian/taiwan-calendar.git","description":"臺灣行事曆，資料來源中華民國政府行政機關辦公日曆表，可以透過 API 取得資料，並新增其他欄位，例如：民國年、星期英文、星期縮寫等等，方便大家使用。 https://api.pin-yi.me/taiwan-calendar/","language":"Go","stars":21,"topics":["calendar","taiwan","taiwan-calendar"],"license":null,"category":"productivity","readme_excerpt":"Taiwan-Calendar 臺灣行事曆 說明 最近在做一個專案，會需要台灣的國定假日，可惜政府資料開放平台沒有提供 API，只能下載檔案 (CSV、XML、JSON)，也沒有我想要的格式，因此我將政府資料開放平台提供的 JSON 資料格式透過 Go 寫了一隻簡單的 API，方便大家使用。 資料來源 本資料取自於政府資料開放平台之「中華民國政府行政機關辦公日曆表」，欄位內容包含日期、星期、是否放假、說明。 使用說明 1. 由於是開源專案，歡迎大家直接使用，或是 Fork 進行修改。 2. 本人免費提供 API，但是不保證服務穩定性，API：https://api.pin-yi.me/taiwan-calendar。 3. API 有每秒 2 次請求的限制，請大家不要把我的 API 打爆 QQ。 4. 使用說明： - GET /taiwan-calendar/swagger/index.html/# ：查看 API 文件。 - GET /taiwan-calendar/health ：檢查 API 是否正常運作。 - GET /taiwan-calendar/supported-years ：取得支援的年份列表。 - GET /taiwan-calendar/{year} ：取得指定年份的行事曆資料。 - GET /taiwan-calendar/{year}/{month} ：取得指定年份+月份的行事曆資料。 - GET /taiwan-calendar/{year}/{month}/{day} ：取得指定年份+月份+日的行事曆資料。 - GET /taiwan-calendar/{year}/?isHoliday={true/false} ：取得指定年份是否為假日的行事曆資料。 - GET /taiwan-calendar/{year}/{month}/?isHoliday={true/false} ：取得指定年份+月份是否為假日的行事曆資料。 - GET /taiwan-calendar/{year}/{month}/{day}/?isHoliday={true/false} ：取得指定年份+月份+日是否為假日的行事曆資料。 其餘詳細說明請參考 API 文件。 顯示資料格式 資料更新 由於中華民國政府行政機關辦公日曆表更新日期約為每年 6 月底更新下一年度的行事曆，因此本專案也會盡量於每年 6 月底更新下一年度的行事曆。 目前收納資料範圍為 2017 年至 2026 年，未來會持續更新。 (資料更新：2025/06/25 14:10) 資料內容備註 由於政府資料開放平台提供資料，有些無法下載 JSON 格式，因此我先下載 CSV 格式，再轉換成 JSON 格式。 以下為有問題的資料： - 2025 年：沒有 JSON 格式，下載 CSV 會出現亂碼 - 2022 年：沒有 JSON 格式 - 2020 年：沒有 JSON 格式，下載 CSV 會出現亂碼 - 2019 年：沒有 JSON 格式，下載 CSV 會出現亂碼 補充 過程中有發現 GitHub 有人已經做了類似的專案，TaiwanCalendar，有參考部分 README.md 內容。","default_branch":null,"files":null,"tree":[],"storefront":"/r/880831ian","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/880831ian/taiwan-calendar/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}