Description
n8n-nodes-lunar-calendar-vi
🌙 n8n Community Node để chuyển đổi giữa âm lịch và dương lịch Việt Nam
📖 Giới thiệu
Đây là một n8n community node để chuyển đổi giữa âm lịch và dương lịch Việt Nam, sử dụng thư viện @nghiavuive/lunar_date_vi được phát triển bởi cộng đồng Việt Nam.
✨ Tính năng chính
- 🔄 Chuyển đổi Dương lịch sang Âm lịch – Hỗ trợ ngày hiện tại, ngày cụ thể hoặc từ dữ liệu đầu vào
- 🔄 Chuyển đổi Âm lịch sang Dương lịch – Hỗ trợ tháng nhuận và các trường hợp đặc biệt
- 🌟 Thông tin Can Chi – Tên năm, tháng, ngày theo can chi (vd: Quý Mão, Giáp Thìn)
- ⏰ Giờ hoàng đạo – Danh sách các giờ tốt trong ngày
- 📅 Tiết khí – Thông tin 24 tiết khí trong năm
- 🗓️ Thứ trong tuần – Tên thứ bằng tiếng Việt
- 🏷️ Interface tiếng Việt – Dễ sử dụng cho người Việt
🚀 Cài đặt
Cài đặt trong n8n
- Vào Settings → Community Nodes
- Chọn Install
- Nhập
n8n-nodes-lunar-calendar-vi - Chọn Install
Cài đặt từ npm
npm install n8n-nodes-lunar-calendar-vi
🎯 Cách sử dụng
Ví dụ 1: Chuyển ngày hiện tại sang âm lịch
- Thêm node Lunar Calendar VI vào workflow
- Chọn Thao tác: "Dương lịch sang Âm lịch"
- Chọn Nguồn ngày tháng: "Ngày hiện tại"
- Trong Thông tin bổ sung, chọn các thông tin bạn muốn:
- ✅ Tên năm Can Chi
- ✅ Giờ hoàng đạo
- ✅ Tiết khí
- Chạy workflow
Kết quả:
{
"solar": {
"day": 19,
"month": 6,
"year": 2023,
"leap_year": false
},
"lunar": {
"day": 2,
"month": 5,
"year": 2023,
"leap_year": true,
"leap_month": false,
"year_name": "Quý Mão",
"lucky_hours": [
{ "name": "Tý", "time": [23, 1] },
{ "name": "Sửu", "time": [1, 3] }
]
},
"julian": 2460115,
"solar_term": "Hạ chí"
}
Ví dụ 2: Chuyển ngày cụ thể sang âm lịch
- Thêm node Lunar Calendar VI
- Chọn Thao tác: "Dương lịch sang Âm lịch"
- Chọn Nguồn ngày tháng: "Ngày cụ thể"
- Nhập:
- Ngày: 1
- Tháng: 1
- Năm: 2024
- Chạy workflow
Ví dụ 3: Chuyển từ dữ liệu đầu vào
Dữ liệu đầu vào:
{
"birth_date": "1990-05-15",
"name": "Nguyễn Văn A"
}
Cấu hình node:
- Thao tác: "Dương lịch sang Âm lịch"
- Nguồn ngày tháng: "Từ dữ liệu đầu vào"
- Trường chứa ngày dương lịch:
birth_date
Ví dụ 4: Chuyển âm lịch sang dương lịch
- Thêm node Lunar Calendar VI
- Chọn Thao tác: "Âm lịch sang Dương lịch"
- Nhập thông tin âm lịch:
- Ngày âm lịch: 15
- Tháng âm lịch: 8
- Năm âm lịch: 2023
- Tháng nhuận: false
- Chạy workflow
📋 Dữ liệu đầu ra
Cấu trúc dữ liệu trả về
{
// Thông tin dương lịch
solar: {
day: number, // Ngày (1-31)
month: number, // Tháng (1-12)
year: number, // Năm
leap_year: boolean, // Có phải năm nhuận không
date?: Date // Date object (chỉ có khi chuyển từ âm lịch)
},
// Thông tin âm lịch
lunar: {
day: number, // Ngày âm lịch (1-30)
month: number, // Tháng âm lịch (1-12)
year: number, // Năm âm lịch
leap_year: boolean, // Có phải năm nhuận không
leap_month: boolean, // Có phải tháng nhuận không
// Thông tin bổ sung (nếu được chọn)
year_name?: string, // Tên năm Can Chi (vd: "Quý Mão")
month_name?: string, // Tên tháng Can Chi
day_name?: string, // Tên ngày Can Chi
lucky_hours?: Array<{ // Giờ hoàng đạo
name: string, // Tên giờ (vd: "Tý", "Sửu")
time: [number, number] // Khoảng thời gian [bắt đầu, kết thúc]
}>
},
// Thông tin chung
julian: number, // Số ngày Julian
day_of_week?: string, // Thứ trong tuần (vd: "Thứ hai")
solar_term?: string // Tiết khí (vd: "Hạ chí", "Đông chí")
}
🛠️ Phát triển
Yêu cầu hệ thống
- Node.js 18.x hoặc cao hơn
- npm 8.x hoặc cao hơn
- n8n 0.190.0 hoặc cao hơn
Cài đặt môi trường phát triển
# Clone repository
git clone https://github.com/hophamlam/n8n-lunar-calendar-vi.git
cd n8n-lunar-calendar-vi
# Cài đặt dependencies
npm install
# Build project
npm run build
# Kiểm tra linting
npm run lint
# Format code
npm run format
Test local với n8n
# Build và link package
npm run build
npm link
# Trong thư mục n8n (~/.n8n)
npm link n8n-nodes-lunar-calendar-vi
# Khởi động n8n
n8n start
Cấu trúc project
n8n-lunar-calendar-vi/
├── nodes/
│ └── LunarCalendarVi/
│ ├── LunarCalendarVi.node.ts # Node chính
│ ├── LunarCalendarVi.node.json # Metadata
│ └── lunarCalendar.svg # Icon
├── dist/ # Build output
├── package.json # Package config
├── tsconfig.json # TypeScript config
├── .eslintrc.js # ESLint config
├── gulpfile.js # Build scripts
└── README.md # Documentation
🌏 Ngôn ngữ và địa phương hóa
Node này được thiết kế đặc biệt cho thị trường Việt Nam:
- ✅ Interface hoàn toàn bằng tiếng Việt
- ✅ Hỗ trợ lịch âm Việt Nam chính xác
- ✅ Can Chi theo truyền thống Việt Nam
- ✅ Tiết khí theo lịch Việt Nam
- ✅ Giờ hoàng đạo theo phong tục Việt Nam
📚 Tài liệu tham khảo
🤝 Đóng góp
Chúng tôi chào đón mọi đóng góp từ cộng đồng!
Cách đóng góp
- Fork repository này
- Tạo feature branch (
git checkout -b feature/amazing-feature) - Commit thay đổi (
git commit -m 'Add some amazing feature') - Push lên branch (
git push origin feature/amazing-feature) - Mở Pull Request
Báo lỗi
Nếu bạn phát hiện lỗi, vui lòng tạo issue với thông tin:
- Phiên bản n8n
- Phiên bản node
- Mô tả lỗi chi tiết
- Bước tái hiện lỗi
- Kết quả mong đợi vs thực tế
📄 Giấy phép
Dự án này được phát hành dưới giấy phép MIT License.
👥 Tác giả
- Hoang Pham – Initial work – @hophamlam
🙏 Cảm ơn
- nacana22 – Tác giả thư viện lunar-date gốc
- n8n.io – Platform workflow automation tuyệt vời
- Cộng đồng lập trình viên Việt Nam
📈 Changelog
v0.1.0 (2024-01-01)
- ✅ Chức năng chuyển đổi dương lịch sang âm lịch
- ✅ Chức năng chuyển đổi âm lịch sang dương lịch
- ✅ Hỗ trợ thông tin Can Chi
- ✅ Hỗ trợ giờ hoàng đạo
- ✅ Hỗ trợ tiết khí
- ✅ Interface tiếng Việt
⭐ Nếu project này hữu ích, đừng quên cho chúng tôi một star trên GitHub!
