lunar_date_error_quark ()

GQuark
lunar_date_error_quark (void);

lunar_date_new ()

LunarDate *
lunar_date_new (void);

Allocates a LunarDate and initializes it. Free the return value with lunar_date_free().

Since: 2.4.0

lunar_date_set_solar_date ()

void
lunar_date_set_solar_date (LunarDate *date,
                           GDateYear year,
                           GDateMonth month,
                           GDateDay day,
                           guint8 hour,
                           GError **error);

Sets the solar year, month, day and the hour for a LunarDate.

Since: 2.4.0

lunar_date_set_lunar_date ()

void
lunar_date_set_lunar_date (LunarDate *date,
                           GDateYear year,
                           GDateMonth month,
                           GDateDay day,
                           guint8 hour,
                           gboolean isleap,
                           GError **error);

Sets the lunar year, month, day and the hour for a LunarDate. If the month is a leap month, you should set the isleap to TRUE.

Since: 2.4.0

lunar_date_set_solar_holiday ()

void
lunar_date_set_solar_holiday (LunarDate *date,
                              GDateMonth month,
                              GDateDay day,
                              const gchar *holiday);

Add new holiday by solar.

Since: 3.0.0

lunar_date_set_lunar_holiday ()

void
lunar_date_set_lunar_holiday (LunarDate *date,
                              GDateMonth month,
                              GDateDay day,
                              const gchar *holiday);

Add new holiday by lunar.

Since: 3.0.0

lunar_date_set_week_holiday ()

void
lunar_date_set_week_holiday (LunarDate *date,
                             GDateMonth month,
                             gint week_of_month,
                             gint day_of_week,
                             const gchar *holiday);

Add new holiday by week.

Since: 3.0.0

lunar_date_get_holiday ()

gchar *
lunar_date_get_holiday (LunarDate *date,
                        const gchar *delimiter);

Returns the all holiday of the date, joined with the delimiter. The date must be valid.

Since: 3.0.0

lunar_date_get_calendar ()

gchar *
lunar_date_get_calendar (LunarDate *date,
                         gint max);

Returns the string about the date, used to show in calendar.

Since: 3.0.0

lunar_date_strftime ()

gchar *
lunar_date_strftime (LunarDate *date,
                     const gchar *format);

Use the given format to output a string, similar to strftime usage. The available formats and outputs are as follows:

1
2
3
4
5
6
7
8

format="%(YEAR)年%(MONTH)月%(DAY)日%(HOUR)时", output="一九一○年二月十九日二时"   //大写公历
format="%(year)年%(month)月%(day)日%(hour)时", output="1910年2月19日2时"          //小写公历
format="%(NIAN)年%(YUE)月%(RI)日%(SHI)时",     output="庚戌年一月初十日丑时"      //大写农历(月份前带"闰"表示闰月)
format="%(nian)年%(yue)月%(ri)日%(shi)时",     output="1910年1月10日2时"          //小写农历(月份前带"*"表示闰月)
format="%(Y60)年%(M60)月%(D60)日%(H60)时",     output="庚戌年戊寅月乙卯日丁丑时"  //干支
format="%(Y8)年%(M8)月%(D8)日%(H8)时",         output="庚戌年戊寅月乙卯日丁丑时"  //八字
format="%(shengxiao)",                        output="狗"                         //生肖
format="%(holiday)",                          output="雨水"                       //节日(节日、纪念日、节气等)

When using %(holiday), the output is automatically truncated to 3 utf8 characters or 4 ascii characters. If you need all the holiday information, please use lunar_date_get_holiday() to get the output.

Since: 2.4.0

lunar_date_get_constellation ()

gchar *
lunar_date_get_constellation (LunarDate *date);

lunar_date_free ()

void
lunar_date_free (LunarDate *date);

Frees a LunarDate returned from lunar_date_new().

Since: 2.4.0

lunar_date_get_jieri ()

gchar *
lunar_date_get_jieri (LunarDate *date,
                      const gchar *delimiter);

Returns the all holiday of the date, joined with the delimiter. The date must be valid.

LUNAR_TYPE_DATE

#define LUNAR_TYPE_DATE          (lunar_date_get_type ())

LUNAR_DATE_ERROR

#define LUNAR_DATE_ERROR         (lunar_date_error_quark ())

enum LunarDateError

LunarDate

typedef struct _LunarDate LunarDate;