| Name | zhdate JSON |
| Version |
1.0
JSON |
| download |
| home_page | https://github.com/CutePandaSh/zhdate |
| Summary | A pachage to convert Chinese Lunar Calendar to datetime |
| upload_time | 2023-01-21 02:31:05 |
| maintainer | |
| docs_url | None |
| author | PandaWithBeard |
| requires_python | |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ZhDate 中国农历日期处理对象
[](https://pypi.org/project/zhdate/) [](https://pypi.org/project/zhdate/) [](https://github.com/CutePandaSh/zhdate/blob/master/LICENSE)
不用网络接口直接本地计算中国农历，支持农历阳历互转
## 感谢
[EillesWan](https://github.com/EillesWan/zhdate)
## 更新
- 修正农历初一前一天错误
- 修正f 字符串输出方式
## 安装方法
通过 pip 直接安装
```bash
pip install zhdate
```
或从git拉取
```bash
git clone https://github.com/CutePandaSh/zhdate.git
cd zhdate
python setup.py install
```
更新
```bash
pip install zhdate --upgrade
```
## 使用方法
见如下代码案例:
```python
from zhdate import ZhDate
date1 = ZhDate(2010, 1, 1) # 新建农历 2010年正月初一 的日期对象
print(date1) # 直接返回农历日期字符串
dt_date1 = date1.to_datetime() # 农历转换成阳历日期 datetime 类型
dt_date2 = datetime(2010, 2, 6)
date2 = ZhDate.from_datetime(dt_date2) # 从阳历日期转换成农历日期对象
date3 = ZhDate(2020, 4, 30, leap_month=True) # 新建农历 2020年闰4月30日
print(date3.to_datetime())
# 支持比较
if ZhDate(2019, 1, 1) == ZhDate.from_datetime(datetime(2019, 2, 5)):
pass
# 减法支持
new_zhdate = ZhDate(2019, 1, 1) - 30 #减整数，得到差额天数的新农历对象
new_zhdate2 = ZhDate(2019, 1, 1) - ZhDate(2018, 1, 1) #两个zhdate对象相减得到两个农历日期的差额
new_zhdate3 = ZhDate(2019, 1, 1) - datetime(2019, 1, 1) # 减去阳历日期，得到农历日期和阳历日期之间的天数差额
# 加法支持
new_zhdate4 = ZhDate(2019, 1, 1) + 30 # 加整数返回相隔天数以后的新农历对象
# 中文输出
new_zhdate5 = ZhDate(2019, 1, 1)
print(new_zhdate5.chinese())
# 当天的农历日期
ZhDate.today()
```
Raw data
{
"_id": null,
"home_page": "https://github.com/CutePandaSh/zhdate",
"name": "zhdate",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "PandaWithBeard",
"author_email": "9861649@qq.com",
"download_url": "https://files.pythonhosted.org/packages/58/ff/88fa42fb0dcffc49eda8a6777e2f6182289c6a921bcc554654a764dd921a/zhdate-1.0.macosx-11.0-arm64.tar.gz",
"platform": null,
"description": "# ZhDate \u4e2d\u56fd\u519c\u5386\u65e5\u671f\u5904\u7406\u5bf9\u8c61\n\n[](https://pypi.org/project/zhdate/) [](https://pypi.org/project/zhdate/) [](https://github.com/CutePandaSh/zhdate/blob/master/LICENSE)\n\n\u4e0d\u7528\u7f51\u7edc\u63a5\u53e3\u76f4\u63a5\u672c\u5730\u8ba1\u7b97\u4e2d\u56fd\u519c\u5386\uff0c\u652f\u6301\u519c\u5386\u9633\u5386\u4e92\u8f6c\n\n## \u611f\u8c22\n[EillesWan](https://github.com/EillesWan/zhdate)\n\n## \u66f4\u65b0\n- \u4fee\u6b63\u519c\u5386\u521d\u4e00\u524d\u4e00\u5929\u9519\u8bef\n- \u4fee\u6b63f \u5b57\u7b26\u4e32\u8f93\u51fa\u65b9\u5f0f\n\n## \u5b89\u88c5\u65b9\u6cd5\n\n\u901a\u8fc7 pip \u76f4\u63a5\u5b89\u88c5\n\n```bash\npip install zhdate\n```\n\n\u6216\u4ecegit\u62c9\u53d6\n\n```bash\ngit clone https://github.com/CutePandaSh/zhdate.git\ncd zhdate\npython setup.py install\n```\n\n\u66f4\u65b0\n\n```bash\npip install zhdate --upgrade\n```\n\n## \u4f7f\u7528\u65b9\u6cd5\n\n\u89c1\u5982\u4e0b\u4ee3\u7801\u6848\u4f8b:\n\n```python\nfrom zhdate import ZhDate\n\ndate1 = ZhDate(2010, 1, 1) # \u65b0\u5efa\u519c\u5386 2010\u5e74\u6b63\u6708\u521d\u4e00 \u7684\u65e5\u671f\u5bf9\u8c61\nprint(date1) # \u76f4\u63a5\u8fd4\u56de\u519c\u5386\u65e5\u671f\u5b57\u7b26\u4e32\ndt_date1 = date1.to_datetime() # \u519c\u5386\u8f6c\u6362\u6210\u9633\u5386\u65e5\u671f datetime \u7c7b\u578b\n\ndt_date2 = datetime(2010, 2, 6)\ndate2 = ZhDate.from_datetime(dt_date2) # \u4ece\u9633\u5386\u65e5\u671f\u8f6c\u6362\u6210\u519c\u5386\u65e5\u671f\u5bf9\u8c61\n\ndate3 = ZhDate(2020, 4, 30, leap_month=True) # \u65b0\u5efa\u519c\u5386 2020\u5e74\u95f04\u670830\u65e5\nprint(date3.to_datetime())\n\n# \u652f\u6301\u6bd4\u8f83\nif ZhDate(2019, 1, 1) == ZhDate.from_datetime(datetime(2019, 2, 5)):\n pass\n\n# \u51cf\u6cd5\u652f\u6301\nnew_zhdate = ZhDate(2019, 1, 1) - 30 #\u51cf\u6574\u6570\uff0c\u5f97\u5230\u5dee\u989d\u5929\u6570\u7684\u65b0\u519c\u5386\u5bf9\u8c61\nnew_zhdate2 = ZhDate(2019, 1, 1) - ZhDate(2018, 1, 1) #\u4e24\u4e2azhdate\u5bf9\u8c61\u76f8\u51cf\u5f97\u5230\u4e24\u4e2a\u519c\u5386\u65e5\u671f\u7684\u5dee\u989d\nnew_zhdate3 = ZhDate(2019, 1, 1) - datetime(2019, 1, 1) # \u51cf\u53bb\u9633\u5386\u65e5\u671f\uff0c\u5f97\u5230\u519c\u5386\u65e5\u671f\u548c\u9633\u5386\u65e5\u671f\u4e4b\u95f4\u7684\u5929\u6570\u5dee\u989d\n\n# \u52a0\u6cd5\u652f\u6301\nnew_zhdate4 = ZhDate(2019, 1, 1) + 30 # \u52a0\u6574\u6570\u8fd4\u56de\u76f8\u9694\u5929\u6570\u4ee5\u540e\u7684\u65b0\u519c\u5386\u5bf9\u8c61\n\n# \u4e2d\u6587\u8f93\u51fa\nnew_zhdate5 = ZhDate(2019, 1, 1)\nprint(new_zhdate5.chinese())\n\n# \u5f53\u5929\u7684\u519c\u5386\u65e5\u671f\nZhDate.today()\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "A pachage to convert Chinese Lunar Calendar to datetime",
"version": "1.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "58ff88fa42fb0dcffc49eda8a6777e2f6182289c6a921bcc554654a764dd921a",
"md5": "6569dd181e2ac6bbf836b7f975dc982e",
"sha256": "1642717dd62bf2ae1c63987f34ca875fb4906995d5faa1e66e6ae29b7728b630"
},
"downloads": -1,
"filename": "zhdate-1.0.macosx-11.0-arm64.tar.gz",
"has_sig": false,
"md5_digest": "6569dd181e2ac6bbf836b7f975dc982e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11699,
"upload_time": "2023-01-21T02:31:05",
"upload_time_iso_8601": "2023-01-21T02:31:05.146342Z",
"url": "https://files.pythonhosted.org/packages/58/ff/88fa42fb0dcffc49eda8a6777e2f6182289c6a921bcc554654a764dd921a/zhdate-1.0.macosx-11.0-arm64.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-21 02:31:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "CutePandaSh",
"github_project": "zhdate",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "zhdate"
}
