Thư viện Python tính lịch Âm – Dương, Can Chi và ngày tốt xấu theo lịch Việt Nam

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for hoangdtung-2013 from gravatar.com hoangdtung-2013

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: Hoang Duc Tung
  • Tags vietnamese-calendar , chinese-calendar , lunar-calendar , solar-calendar , can-chi , vn-calendar , am-duong
  • Requires: Python >=3.7
Classifiers
Report project as malware

Project description

vncalendar

I. Giới thiệu

vncalendar là một thư viện Python phục vụ việc tính toán và tra cứu Lịch Vạn Sự Việt Nam, bao gồm chuyển đổi Âm – Dương lịch, Can Chi, ngày Hoàng Đạo / Hắc Đạo, các ngày kỵ truyền thống và 24 Tiết Khí.

Thư viện được xây dựng dựa trên:

  • Lịch Vạn Sự truyền thống Việt Nam
  • Thuật toán tính Âm lịch của Hồ Ngọc Đức

II. Chức năng chính

2.1. Xử lý ngày tháng

  • Kiểm tra năm nhuận
  • Tính số ngày trong tháng, trong năm
  • Cộng, trừ ngày
  • Tính thứ trong tuần
  • Tính tuổi chính xác theo ngày sinh

2.2. Chuyển đổi lịch

  • Chuyển từ Dương lịch sang Âm lịch
  • Chuyển từ Âm lịch sang Dương lịch
  • Hỗ trợ tháng nhuận âm lịch

2.3. Can Chi

  • Can Chi năm
  • Can Chi tháng
  • Can Chi ngày

2.4. Tốt – Xấu (Vạn Sự)

  • Xác định ngày Hoàng Đạo / Hắc Đạo
  • Kiểm tra các ngày xấu:
    • Tam Nương
    • Nguyệt Phá
    • Sát Chủ
    • Thọ Tử
    • Vãng Vong
    • Nguyệt Kỵ
    • Đại Bại
  • Xác định Giờ Hoàng Đạo

2.5. Tiết Khí

  • Xác định tiết khí của một ngày bất kỳ
  • Tính thời điểm bắt đầu chính xác của từng tiết khí
  • Danh sách đầy đủ 24 tiết khí trong năm

2.6. Thông tin Vạn Sự tổng hợp

  • Trả về thông tin đầy đủ của một ngày theo Dương lịch hoặc Âm lịch

III. Cấu trúc thư viện

3.1. Lớp Date

Xử lý các phép toán liên quan đến ngày tháng và JDN.

3.2. VanSu.SolarAndLunar

Chuyển đổi giữa lịch Dương và lịch Âm.

3.3. VanSu.CanChi

Tính Can Chi cho năm, tháng và ngày.

3.4. VanSu.TotXau

Xử lý ngày tốt – xấu, giờ Hoàng Đạo và các ngày kỵ.

3.5. VanSu.TietKhi

Tính toán 24 tiết khí dựa trên kinh độ Mặt Trời.

3.6. VanSu.getInfo

Tổng hợp toàn bộ thông tin Vạn Sự của một ngày.

IV. Độ chính xác và phạm vi sử dụng

  • Múi giờ mặc định: UTC+7 (Việt Nam)
  • Thuật toán dựa trên thiên văn học
  • Phù hợp cho:
    • Ứng dụng lịch
    • Công cụ tra cứu Vạn Sự
    • Nghiên cứu lịch truyền thống

V. Lưu ý

  • Thư viện không sử dụng thư viện bên thứ ba
  • Kết quả mang tính tham khảo theo lịch truyền thống Việt Nam

VI. Bản quyền và nguồn tham khảo

VII. Tác giả

Họ tên: Hoàng Đức Tùng
Email: hoangdtung2021@gmail.com
Facebook: https://www.facebook.com/hoangductung.keocon/

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for hoangdtung-2013 from gravatar.com hoangdtung-2013

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT License (MIT)
  • Author: Hoang Duc Tung
  • Tags vietnamese-calendar , chinese-calendar , lunar-calendar , solar-calendar , can-chi , vn-calendar , am-duong
  • Requires: Python >=3.7
Classifiers

Release history Release notifications | RSS feed

1.3.1

1.3.0

1.0.1

This version

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vncalendar-1.0.0.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vncalendar-1.0.0-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file vncalendar-1.0.0.tar.gz.

File metadata

  • Download URL: vncalendar-1.0.0.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vncalendar-1.0.0.tar.gz
Algorithm Hash digest
SHA256 29bcad5121db4bedb6a19ef4e06d246920092c3cd43c716c2f1200be219c1c71
MD5 de6627f8f3bb3b9b7326204a8ad59106
BLAKE2b-256 cb82ca8524d594a03a8446a9c40b707e6e0a0548d0fff2527596b53b0613edd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for vncalendar-1.0.0.tar.gz:

Publisher: publish.yml on hoangdtung-2013/vncalendar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vncalendar-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: vncalendar-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vncalendar-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2bbb675a6c56a0a3d799e0f49b30f00e87f2d9f502dbbe4f3c46bd2dca80e131
MD5 fead810e2fe779304d0588236f5a5631
BLAKE2b-256 0394e3691ecc0210f01c2665b3550c8b9901ea030be85406ee62315abc2c2928

See more details on using hashes here.

Provenance

The following attestation bundles were made for vncalendar-1.0.0-py3-none-any.whl:

Publisher: publish.yml on hoangdtung-2013/vncalendar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page