README
¶
Bazica (Ba-zi Calculator) - (In Progress 🚧)
Convert Solar Calendar to Bazi Chart (Chinese astrology) with the year, month, day and hour of birth information (in Go)
Getting started with bazica
Prerequisites
Getting Bazica (Ba-zi Calculator)
With Go module support, simply add the following import
import "github.com/tommitoan/bazica"
to your code, and then go [build|run|test] will automatically fetch the necessary dependencies.
Otherwise, run the following Go command to install the gin package:
$ go get -u github.com/tommitoan/bazica
Get Data (Important) ⚠️⚠️
This module provides data related to solar terms, zodiac signs, and the 60-year era cycle.
For your convenience, the data is also summarized in JSON files and located in the data folder.
To use this module:
Clone or copy this repository to your project directory. Access the JSON files located in the data folder. Please note: You'll need to manually copy the relevant JSON files from the data folder into your project to utilize the data within your application.
For a given date and time of birth, the Hsia Calendar is used to obtain the Heavenly Stems and Earthly Branches with which to construct the Four Pillars of Destiny (四柱) of a person. The Four Pillars of Destiny are also known as the Ba Zi (八字), literally the Eight Characters of a person's birth. In ancient China, one use of this form of divination was to select a suitable marriage partner.
The Four Pillars of Destiny are the Year Pillar, the Month Pillar, the Day Pillar and the Hour Pillar. Each Pillar is made up of two components, namely the Heavenly Stem and the Earthly Branch, both of which are read from the Hsia Calendar.
The Hsia Calendar is also used in various types of Feng Shui, or Chinese Geomancy, such as the Flying Star Feng Shui.
A ba zi chart done with mixed Lunar & Seasonal (Xia) Calendar will look like this:-
Year: Ji-Chou (Ox) - (Lunar Calendar Year) Month: Yi-Chou - (Seasonal-Xia Calendar Month) Day: Xin-Wei - (Lunar Calendar Day)
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var PrefixPath string
Functions ¶
This section is empty.
Types ¶
type CombinedData ¶ added in v0.2.3
type CombinedData struct {
Year string `json:"year"` // Year extracted from filename
Data SolarTermYear `json:"data"` // Data for the specific year
}
type SolarTermYear ¶ added in v0.2.3
type SolarTermYear struct {
MinorCold string `json:"minor_cold"`
MajorCold string `json:"major_cold"`
StartOfSpring string `json:"start_of_spring"`
SpringShowers string `json:"spring_showers"`
AwakeningOfInsects string `json:"awakening_of_insects"`
SpringEquinox string `json:"spring_equinox"`
PureBrightness string `json:"pure_brightness"`
GrainRain string `json:"grain_rain"`
StartOfSummer string `json:"start_of_summer"`
GrainBuds string `json:"grain_buds"`
GrainInEar string `json:"grain_in_ear"`
SummerSolstice string `json:"summer_solstice"`
MinorHeat string `json:"minor_heat"`
MajorHeat string `json:"major_heat"`
StartOfAutumn string `json:"start_of_autumn"`
EndOfHeat string `json:"end_of_heat"`
WhiteDew string `json:"white_dew"`
AutumnEquinox string `json:"autumn_equinox"`
ColdDew string `json:"cold_dew"`
Frost string `json:"frost"`
StartOfWinter string `json:"start_of_winter"`
MinorSnow string `json:"minor_snow"`
MajorSnow string `json:"major_snow"`
WinterSolstice string `json:"winter_solstice"`
}
func GetSolarTermsByYear ¶ added in v0.2.3
func GetSolarTermsByYear(year, path string) (SolarTermYear, error)
Source Files