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

Method 1: Direct npm installation

# 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

Method 2: In Docker environment

# 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:

{
  "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