{"id":20665221,"url":"https://github.com/xmisao/xcal","last_synced_at":"2025-07-24T21:05:43.667Z","repository":{"id":10821491,"uuid":"13097628","full_name":"xmisao/xcal","owner":"xmisao","description":"xcal displays a japan calendar like cal, ncal","archived":false,"fork":false,"pushed_at":"2021-04-26T14:20:57.000Z","size":15,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-15T02:55:00.616Z","etag":null,"topics":["gem","ruby","ruby-gem"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"dmlc/mxnet","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xmisao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-09-25T15:27:52.000Z","updated_at":"2021-04-26T14:19:46.000Z","dependencies_parsed_at":"2022-08-29T10:20:48.790Z","dependency_job_id":null,"html_url":"https://github.com/xmisao/xcal","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmisao%2Fxcal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmisao%2Fxcal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmisao%2Fxcal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmisao%2Fxcal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xmisao","download_url":"https://codeload.github.com/xmisao/xcal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249738223,"owners_count":21318501,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gem","ruby","ruby-gem"],"created_at":"2024-11-16T19:29:09.312Z","updated_at":"2025-04-19T16:27:22.467Z","avatar_url":"https://github.com/xmisao.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xcal\n\nxcalは休日の色付き表示に対応したcal, ncalライクなカレンダーコマンドです。\nカレンダーはカラフルに土曜日が青色、日曜日と休日が赤色で表示されます。\n\n休日の情報は表示のたびにiCal(icsファイル)をダウンロードして取得します。\nデフォルトではGoogleが提供するiCalを利用し日本の休日を表示します。\nまた任意のicsファイルを指定して休日を表示することもできます。\n\n![xcal demo](https://raw.githubusercontent.com/xmisao/demos/master/xcal/xcal_demo.png)\n\n## インストール\n\n```\n# gem install xcal\n```\n\n## 使い方\n\nデフォルトで前後1ヶ月の3ヶ月分のカレンダーを表示します。(実際は色付きです)\n\n```\n$ xcal\n   November 2017         December 2017          January 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n          1  2  3  4                  1  2      1  2  3  4  5  6\n 5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13\n12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20\n19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27\n26 27 28 29 30        24 25 26 27 28 29 30  28 29 30 31         \n                      31                                        \n```\n\n`-l`オプションで休日の詳細を表示することができます。(iCalの`summary`を表示します)\n\n```\n$ xcal -l\n   November 2017         December 2017          January 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n          1  2  3  4                  1  2      1  2  3  4  5  6\n 5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13\n12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20\n19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27\n26 27 28 29 30        24 25 26 27 28 29 30  28 29 30 31         \n                      31                                        \n2017-11-03 (Fr) 文化の日\n2017-11-23 (Th) 勤労感謝の日\n2017-12-23 (Sa) 天皇誕生日\n2018-01-01 (Mo) 元日\n2018-01-08 (Mo) 成人の日\n```\n\n`-9`オプションで前後4ヶ月の9ヶ月分のカレンダーを表示します。\n\n```\n$ xcal -9\n     August 2017        September 2017          October 2017    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n       1  2  3  4  5                  1  2   1  2  3  4  5  6  7\n 6  7  8  9 10 11 12   3  4  5  6  7  8  9   8  9 10 11 12 13 14\n13 14 15 16 17 18 19  10 11 12 13 14 15 16  15 16 17 18 19 20 21\n20 21 22 23 24 25 26  17 18 19 20 21 22 23  22 23 24 25 26 27 28\n27 28 29 30 31        24 25 26 27 28 29 30  29 30 31            \n                                                                \n   November 2017         December 2017          January 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n          1  2  3  4                  1  2      1  2  3  4  5  6\n 5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13\n12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20\n19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27\n26 27 28 29 30        24 25 26 27 28 29 30  28 29 30 31         \n                      31                                        \n   February 2018            March 2018            April 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n             1  2  3               1  2  3   1  2  3  4  5  6  7\n 4  5  6  7  8  9 10   4  5  6  7  8  9 10   8  9 10 11 12 13 14\n11 12 13 14 15 16 17  11 12 13 14 15 16 17  15 16 17 18 19 20 21\n18 19 20 21 22 23 24  18 19 20 21 22 23 24  22 23 24 25 26 27 28\n25 26 27 28           25 26 27 28 29 30 31  29 30               \n```\n\n環境変数`XCAL_ICS_URL`にicsファイルのURLを指定すると日本以外の休日を表示することもできます。\n以下はアメリカ合衆国の休日のicsファイルを読み込ませてアメリカ合衆国のカレンダーを表示する例です。\n\n```\n$ export XCAL_ICS_URL=https://calendar.google.com/calendar/ical/ja.usa%23holiday%40group.v.calendar.google.com/public/basic.ics\n$ xcal -9 -l\n     August 2017        September 2017          October 2017    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n       1  2  3  4  5                  1  2   1  2  3  4  5  6  7\n 6  7  8  9 10 11 12   3  4  5  6  7  8  9   8  9 10 11 12 13 14\n13 14 15 16 17 18 19  10 11 12 13 14 15 16  15 16 17 18 19 20 21\n20 21 22 23 24 25 26  17 18 19 20 21 22 23  22 23 24 25 26 27 28\n27 28 29 30 31        24 25 26 27 28 29 30  29 30 31            \n                                                                \n   November 2017         December 2017          January 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n          1  2  3  4                  1  2      1  2  3  4  5  6\n 5  6  7  8  9 10 11   3  4  5  6  7  8  9   7  8  9 10 11 12 13\n12 13 14 15 16 17 18  10 11 12 13 14 15 16  14 15 16 17 18 19 20\n19 20 21 22 23 24 25  17 18 19 20 21 22 23  21 22 23 24 25 26 27\n26 27 28 29 30        24 25 26 27 28 29 30  28 29 30 31         \n                      31                                        \n   February 2018            March 2018            April 2018    \nSu Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa\n             1  2  3               1  2  3   1  2  3  4  5  6  7\n 4  5  6  7  8  9 10   4  5  6  7  8  9 10   8  9 10 11 12 13 14\n11 12 13 14 15 16 17  11 12 13 14 15 16 17  15 16 17 18 19 20 21\n18 19 20 21 22 23 24  18 19 20 21 22 23 24  22 23 24 25 26 27 28\n25 26 27 28           25 26 27 28 29 30 31  29 30               \n                                                                \n2017-09-04 (Mo) Labor Day\n2017-10-09 (Mo) Columbus Day (regional holiday)\n2017-10-31 (Tu) Halloween\n2017-11-05 (Su) Daylight Saving Time ends\n2017-11-10 (Fr) Veterans Day observed\n2017-11-11 (Sa) Veterans Day\n2017-11-23 (Th) Thanksgiving Day\n2017-12-24 (Su) Christmas Eve\n2017-12-25 (Mo) Christmas Day\n2017-12-31 (Su) New Year's Eve\n2018-01-01 (Mo) New Year's Day\n2018-01-15 (Mo) Martin Luther King Jr. Day\n2018-02-14 (We) Valentine's Day\n2018-02-19 (Mo) Presidents' Day\n2018-03-11 (Su) Daylight Saving Time starts\n2018-04-01 (Su) Easter Sunday\n2018-04-13 (Fr) Thomas Jefferson's Birthday\n```\n\n## License\n\nThis software is distributed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmisao%2Fxcal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxmisao%2Fxcal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmisao%2Fxcal/lists"}