Class LunarCalendar

java.lang.Object
tech.riemann.nif.utils.LunarCalendar
public class LunarCalendar extends Object
农历日历工具类，提供农历日期的计算和转换功能
Author:
Kerbores(kerbores@riemann.tech)

  • Constructor Summary

    Constructors
    Constructor
    Description
    LunarCalendar()
    构造一个表示当前日期的农历日历
    LunarCalendar(Calendar cal)
    使用指定日历日期构造一个农历日历
    LunarCalendar(Date date)
    使用指定日期构造一个农历日历

  • Method Summary

    Modifier and Type
    Method
    Description
    final String
    animalsYear()
    返回给定农历年份的生肖 生肖是一个按照12年周期重复的序列，每个年份对应一个生肖动物 该方法通过计算年份与生肖序列的偏移量来确定对应的生肖
    final String
    cyclical()
    根据年份获取对应的干支表示 干支纪年是中国传统的纪年方法，每60年为一个循环，其中甲子为第一个年份 该方法通过计算与1900年的相对年份，来确定相应的干支
    static final String
    cyclicalm(int num)
    根据月日的offset返回对应的天干地支 此方法用于循环计算天干地支，其中0代表“甲子”
    static String
    getChinaDayString(int day)
    根据给定的天数返回对应的中文表示字符串 该方法专门用于处理农历天数的中文转换，考虑到特殊的天数表达方式，如“初”、“十”、“廿”、“卅”
    Date
    getDate()
    获得表示农历年月日的日期对象
    String
    toString()
    重写toString方法，返回农历日期的字符串表示

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • LunarCalendar

      public LunarCalendar()
      构造一个表示当前日期的农历日历

    • LunarCalendar

      public LunarCalendar(Calendar cal)
      使用指定日历日期构造一个农历日历
      Parameters:
      cal - 日历

    • LunarCalendar

      public LunarCalendar(Date date)
      使用指定日期构造一个农历日历
      Parameters:
      date - 日期对象

  • Method Details

    • cyclicalm

      public static final String cyclicalm(int num)
      根据月日的offset返回对应的天干地支 此方法用于循环计算天干地支，其中0代表“甲子”
      Parameters:
      num - 月日的offset，用于确定天干地支的位置
      Returns:
      返回对应天干地支的字符串

    • getChinaDayString

      public static String getChinaDayString(int day)
      根据给定的天数返回对应的中文表示字符串 该方法专门用于处理农历天数的中文转换，考虑到特殊的天数表达方式，如“初”、“十”、“廿”、“卅”
      Parameters:
      day - 需要转换的天数，应为1到30之间的整数
      Returns:
      对应的中文表示字符串如果天数大于30，则返回空字符串

    • animalsYear

      public final String animalsYear()
      返回给定农历年份的生肖 生肖是一个按照12年周期重复的序列，每个年份对应一个生肖动物 该方法通过计算年份与生肖序列的偏移量来确定对应的生肖
      Returns:
      字符串，表示该农历年份对应的生肖

    • cyclical

      public final String cyclical()
      根据年份获取对应的干支表示 干支纪年是中国传统的纪年方法，每60年为一个循环，其中甲子为第一个年份 该方法通过计算与1900年的相对年份，来确定相应的干支
      Returns:
      对应年份的干支表示

    • getDate

      public Date getDate()
      获得表示农历年月日的日期对象
      Returns:
      日期

    • toString

      public String toString()
      重写toString方法，返回农历日期的字符串表示
      Overrides:
      toString in class Object
      Returns:
      农历日期的字符串表示