{"id":32154179,"url":"https://github.com/antimon2/qdates.jl","last_synced_at":"2025-10-21T11:52:12.094Z","repository":{"id":61799275,"uuid":"89853723","full_name":"antimon2/QDates.jl","owner":"antimon2","description":"Japanese `Kyūreki` (旧暦) Calendrical Calculations in Julia.","archived":false,"fork":false,"pushed_at":"2020-09-22T08:46:50.000Z","size":239,"stargazers_count":1,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-28T18:32:30.398Z","etag":null,"topics":["calendrical-calculations","julia","julia-package"],"latest_commit_sha":null,"homepage":null,"language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/antimon2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-30T13:54:01.000Z","updated_at":"2019-02-17T03:09:17.000Z","dependencies_parsed_at":"2022-10-21T11:30:36.010Z","dependency_job_id":null,"html_url":"https://github.com/antimon2/QDates.jl","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/antimon2/QDates.jl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antimon2%2FQDates.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antimon2%2FQDates.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antimon2%2FQDates.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antimon2%2FQDates.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antimon2","download_url":"https://codeload.github.com/antimon2/QDates.jl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antimon2%2FQDates.jl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280256223,"owners_count":26299342,"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","status":"online","status_checked_at":"2025-10-21T02:00:06.614Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["calendrical-calculations","julia","julia-package"],"created_at":"2025-10-21T11:52:11.051Z","updated_at":"2025-10-21T11:52:12.090Z","avatar_url":"https://github.com/antimon2.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"QDates\n======\n\n[![Build Status](https://travis-ci.org/antimon2/QDates.jl.svg?branch=master)](https://travis-ci.org/antimon2/QDates.jl) [![Build status](https://ci.appveyor.com/api/projects/status/github/antimon2/QDates.jl?branch=master)](https://ci.appveyor.com/project/antimon2/qdates-jl/branch/master)  [![Cirrus](https://api.cirrus-ci.com/github/antimon2/QDates.jl.svg)](https://cirrus-ci.com/github/antimon2/QDates.jl)  \n[![Coverage Status](https://coveralls.io/repos/antimon2/QDates.jl/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/antimon2/QDates.jl?branch=master) [![codecov.io](http://codecov.io/github/antimon2/QDates.jl/coverage.svg?branch=master)](http://codecov.io/github/antimon2/QDates.jl?branch=master)\n\nThe **QDates** package provides Japanese \"Kyūreki (旧暦)\" calendrical calculations into Julia.  \n\"Kyūreki (旧暦)\" is one of the Lunisolar Calendar that has been once used in Japan.\n\n\n## Installation\n\nTo install the release version, simply run on the Julia Pkg REPL-mode:\n\n```julia\npkg\u003e add QDates\n```\n\nTo install the latest development version, run the following command instead:\n\n```julia\npkg\u003e add QDates#master\n```\n\nThen you can run the built-in unit tests with\n\n```julia\npkg\u003e test QDates\n```\n\nto verify that everything is functioning properly on your machine.\n\n\n## Usage\n\n`QDates` has APIs almost compatible with the standard `Dates` package.\n\n```julia\nusing QDates\n\n### construct Kyūreki Date\nqdt = QDate(2017, 5, 1)\n# =\u003e 旧2017年05月01日\n\n### get year/month/day values\nusing Dates\nDates.yearmonthday(qdt)\n# =\u003e (2017,5,1)\n\n### check leapmonth or not\nQDates.isleapmonth(qdt)\n# =\u003e false\n\n### arithmetic\nqdt1 = qdt + Dates.Month(1)\n# =\u003e 旧2017年閏05月01日\n\n### check leapmonth or not\nQDates.isleapmonth(qdt1)\n# =\u003e true\n\n### get year/month/isleapmonth/day values\nQDates.yearmonthleapday(qdt1)\n# =\u003e (2017,5,true,1)\n\n### comparison (with constructing leapmonth-date)\nqdt1 == QDate(2017, 5, true, 1)\n# =\u003e true\n\n### conversion to Gregorian Date\ndt = Date(qdt)\n# =\u003e 2017-05-26\n\n### conversion from Gregorian Date\nqdt0 = QDate(dt)\n# =\u003e 旧2017年05月01日\n\n### get today\nqtoday = QDates.today()\n# =\u003e 旧2017年04月10日\nqtoday == QDate(Dates.today())\n# =\u003e true\n\n### six-day week system\n[QDates.dayname(d) for d=qdt:QDate(2017,5,7)]\n# =\u003e 7-element Array{String,1}:\n#     \"大安\"\n#     \"赤口\"\n#     \"先勝\"\n#     \"友引\"\n#     \"先負\"\n#     \"仏滅\"\n#     \"大安\"\n\n[d for d=qdt:qdt1 if QDates.is大安(d)]\n# =\u003e 6-element Array{QDates.QDate,1}:\n#     旧2017年05月01日\n#     旧2017年05月07日\n#     旧2017年05月13日\n#     旧2017年05月19日\n#     旧2017年05月25日\n#     旧2017年閏05月01日\n\n### month names (old-fashioned)\n[QDates.monthname(m) for m=QDate(2017,1):Dates.Month(1):QDate(2017,12)]\n# =\u003e 13-element Array{String,1}:\n#     \"睦月\"\n#     \"如月\"\n#     \"弥生\"\n#     \"卯月\"\n#     \"皐月\"\n#     \"閏皐月\" # \u003c- means leapmonth(\"閏月\") of \"皐月\"\n#     \"水無月\"\n#     \"文月\"\n#     \"葉月\"\n#     \"長月\"\n#     \"神無月\"\n#     \"霜月\"\n#     \"師走\"\n\n### The number of days in a month (29 or 30, not constant).\n[QDates.daysinmonth(m) for m=QDate(2017,1):Dates.Month(1):QDate(2017,12)]\n# =\u003e 13-element Array{Int64,1}:\n#     29 # 1月\n#     30 # 2月\n#     29 # 3月\n#     30 # 4月\n#     29 # 5月\n#     29 # 閏5月\n#     30 # 6月\n#     29 # 7月\n#     30 # 8月\n#     29 # 9月\n#     30 # 10月\n#     30 # 11月\n#     30 # 12月\n\n### leapyear or not (⇔ including leapmonth or not, not constant)\n[QDates.isleapyear(y) for y=QDate(2011):Dates.Year(1):QDate(2020)]\n# =\u003e 10-element Array{Bool,1}:\n#     false # 2011\n#      true # 2012\n#     false # 2013\n#      true # 2014\n#     false # 2015\n#     false # 2016\n#      true # 2017\n#     false # 2018\n#     false # 2019\n#      true # 2020\n\n```\n\n\n## Requirements\n\n+ [Julia](https://julialang.org) (VERSION ≥ v\"1.0\", ready for v\"1.1\")\n    + QDates v0.0.2 is available for Julia of VERSION \u003c v\"0.6\"\n    + QDates v0.1.0 is available for Julia of VERSION \u003c v\"1.0\"\n+ Dates module\n\n\n## Limitations\n\n+ Year range is 445-2200. `QDate(2201)` throws `ArgumentError`.\n\n\n## Credits\n\nQDates.jl is created by @antimon2 (Shunsuke GOTOH).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantimon2%2Fqdates.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantimon2%2Fqdates.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantimon2%2Fqdates.jl/lists"}