n8n-nodes-lunar

n8n custom node for converting dates to Chinese lunar calendar and BaZi (Eight Characters).

Description

This node converts Gregorian calendar dates to Chinese lunar calendar dates and generates the corresponding BaZi (Eight Characters) information. BaZi is a traditional Chinese concept consisting of four pillars (year, month, day, and hour) represented by Heavenly Stems and Earthly Branches.

Features

- Convert Gregorian date to Chinese lunar calendar
- Generate BaZi (Four Pillars of Destiny) information with accurate time calculation
- Get year, month, day, and hour stems and branches
- Retrieve zodiac animal for the year
- Include time information for precise BaZi calculation based on birth hour

Installation

$3

bash
Install globally

npm install -g n8n-nodes-lunar
Or install to n8n custom nodes directory

mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm install n8n-nodes-lunar

$3

bash
Using custom Docker image

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n
Then install in the container

docker exec -it n8n npm install -g n8n-lunar


After installation, restart n8n to load the new node.
Usage
1. Add the "Lunar Calendar & BaZi" node to your workflow
2. Configure the node with the date you want to convert
3. Optionally configure time information for hour-level BaZi accuracy
4. Execute the node to get lunar calendar and BaZi information
Input Parameters
- Date: The Gregorian date in YYYY-MM-DD format (required)
- Options:
  - Include Time: Whether to include time information
  - Hour: Hour for the time (0-23)
  - Minute: Minute for the time (0-59)
Output
The node returns an object with the following structure:

`json { "date": "input date", "lunar": { "year": 1986, "month": 4, "day": 21, "monthName": "四月", "dayName": "廿一", "zodiac": "虎", "ganZhi": { "year": "丙寅", "month": "癸巳", "day": "癸酉", "hour": "子" }, "baZi": "丙寅年癸巳月癸酉日子时", "fullString": "..." } }`

`Example`

Input: 1986-05-29`
Output: Complete lunar calendar and BaZi information for May 29, 1986

License

MIT

Installation

bash

Install globally

npm install -g n8n-nodes-lunar

Or install to n8n custom nodes directory

mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm install n8n-nodes-lunar

$3

bash

Using custom Docker image

docker run -d \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n

Then install in the container

docker exec -it n8n npm install -g n8n-lunar

After installation, restart n8n to load the new node.

Usage

1. Add the "Lunar Calendar & BaZi" node to your workflow
2. Configure the node with the date you want to convert
3. Optionally configure time information for hour-level BaZi accuracy
4. Execute the node to get lunar calendar and BaZi information

Input Parameters

- Date: The Gregorian date in YYYY-MM-DD format (required)
- Options:
- Include Time: Whether to include time information
- Hour: Hour for the time (0-23)
- Minute: Minute for the time (0-59)

Output

The node returns an object with the following structure:

json
{
  "date": "input date",
  "lunar": {
    "year": 1986,
    "month": 4,
    "day": 21,
    "monthName": "四月",
    "dayName": "廿一",
    "zodiac": "虎",
    "ganZhi": {
      "year": "丙寅",
      "month": "癸巳",
      "day": "癸酉",
      "hour": "子"
    },
    "baZi": "丙寅年 癸巳月 癸酉日 子时",
    "fullString": "..."
  }
}