XTimeTools (xtools-common 1.3.1 API)

java.lang.Object
- me.xuxiaoxiao.xtools.common.time.XTimeTools

```
public final class XTimeTools
extends Object
```
常用的基本的关于时间的函数的集合

字段概要

字段
限定符和类型	字段和说明
`static long`	`DAY_MILLIS` 一天的毫秒数
`static String`	`FORMAT_EEEE` EEEE格式的日期
`static String`	`FORMAT_HMS` HH:mm:ss格式的日期
`static String`	`FORMAT_YMD` yyyy-MM-dd格式的日期
`static String`	`FORMAT_YMDHMS` yyyy-MM-dd HH:mm:ss格式的日期
`static int`	`FRIDAY` 周五
`static int`	`HOLIDAY` int dateType(Date date);函数的返回值的枚举，节假日
`static int`	`MONDAY` 周一
`static int`	`RESTDAY` int dateType(Date date);函数的返回值的枚举，公休日
`static int`	`SATURDAY` 周六
`static int`	`SUNDAY` 周日
`static int`	`THURSDAY` 周四
`static int`	`TUESDAY` 周二
`static int`	`WEDNESDAY` 周三
`static long`	`WEEK_MILLIS` 一周的毫秒数
`static int`	`WORKDAY` int dateType(Date date);函数的返回值的枚举，工作日

构造器概要

构造器
构造器和说明

XTimeTools()

构造器
构造器和说明
`XTimeTools()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static Date`	`date(Date base, int offset)` 获取以任意时间所在的那一天为基准偏移若干天的00:00:00时刻的date对象
`static Date`	`dateByMonth(Date base, int monthOffset, int dayIndex)` 获取以某天所在的那一月为基准偏移若干月的某天00:00:00时刻的date对象
`static Date`	`dateBySeason(Date base, int seasonOffset, int dayIndex)` 获取以某天所在的那一季度为基准偏移若干季度的某天00:00:00时刻的date对象
`static Date`	`dateByWeek(Date base, int weekOffset, int dayIndex)` 获取以某天所在的那一周为基准偏移若干周的某天00:00:00时刻的date对象
`static Date`	`dateByYear(Date base, int yearOffset, int dayIndex)` 获取以某天所在的那一年为基准偏移若干年的某天00:00:00时刻的date对象
`static String`	`dateFormat(String format, Date date)` 将date对象转换成相应格式的字符串，线程安全
`static int`	`dateInMonth(Date base)` 获取任意一天是一个月中的第几天
`static int`	`dateInSeason(Date base)` 获取任意一天是一个季度中的第几天
`static int`	`dateInWeek(Date base)` 获取任意一天是一周中的第几天
`static int`	`dateInYear(Date base)` 获取任意一天是一年中的第几天
`static Date`	`dateParse(String format, String dateStr)` 将日期字符串转换成相应的date对象，线程安全
`static int`	`dateType(Date date)` 获取任意一天的类型
`static Date`	`lunarToSolar(String lunarDate)` 将农历时间转换成阳历时间
`static Date`	`monthBySeason(Date base, int seasonOffset, int monthIndex)` 获取以某天所在的那一季度为基准偏移若干季度的某月的一号00:00:00时刻的date对象
`static Date`	`monthByYear(Date base, int yearOffset, int monthIndex)` 获取以某天所在的那一年为基准偏移若干年的某月的一号00:00:00时刻的date对象
`static int`	`monthInSeason(Date base)` 获取任意一天所在的月是那一季度的第几月
`static int`	`monthInYear(Date base)` 获取任意一天所在的月是那一年的第几月
`static Date`	`seasonByYear(Date base, int yearOffset, int seasonIndex)` 获取以某天所在的那一年为基准偏移若干年的某季度的第一天00:00:00时刻的date对象
`static int`	`seasonInYear(Date base)` 获取任意一天所在的季度是那一年的第几个季度
`static String`	`solarToLunar(Date solarDate)` 将阳历时间转化成农历时间
`static Date`	`weekByMonth(Date base, int monthOffset, int weekIndex)` 获取以某天所在的那一月为基准偏移若干月的某周的周一00:00:00时刻的date对象
`static Date`	`weekBySeason(Date base, int seasonOffset, int weekIndex)` 获取以某天所在的那一季度为基准偏移若干季度的某周的周一00:00:00时刻的date对象
`static Date`	`weekByYear(Date base, int yearOffset, int weekIndex)` 获取以某天所在的那一年为基准偏移若干年的某周的周一00:00:00时刻的date对象
`static int`	`weekInMonth(Date base)` 获取任意一天所在的周是哪个月的第几周
`static int`	`weekInSeason(Date base)` 获取任意一天所在的周是哪一季度的第几周
`static int`	`weekInYear(Date base)` 获取任意一天所在的周是哪一年的第几周

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - MONDAY
```
public static final int MONDAY
```
    周一
    
    另请参阅:
    
    常量字段值
  - TUESDAY
```
public static final int TUESDAY
```
    周二
    
    另请参阅:
    
    常量字段值
  - WEDNESDAY
```
public static final int WEDNESDAY
```
    周三
    
    另请参阅:
    
    常量字段值
  - THURSDAY
```
public static final int THURSDAY
```
    周四
    
    另请参阅:
    
    常量字段值
  - FRIDAY
```
public static final int FRIDAY
```
    周五
    
    另请参阅:
    
    常量字段值
  - SATURDAY
```
public static final int SATURDAY
```
    周六
    
    另请参阅:
    
    常量字段值
  - SUNDAY
```
public static final int SUNDAY
```
    周日
    
    另请参阅:
    
    常量字段值
  - WORKDAY
```
public static final int WORKDAY
```
    int dateType(Date date);函数的返回值的枚举，工作日
    
    另请参阅:
    
    常量字段值
  - RESTDAY
```
public static final int RESTDAY
```
    int dateType(Date date);函数的返回值的枚举，公休日
    
    另请参阅:
    
    常量字段值
  - HOLIDAY
```
public static final int HOLIDAY
```
    int dateType(Date date);函数的返回值的枚举，节假日
    
    另请参阅:
    
    常量字段值
  - DAY_MILLIS
```
public static final long DAY_MILLIS
```
    一天的毫秒数
    
    另请参阅:
    
    常量字段值
  - WEEK_MILLIS
```
public static final long WEEK_MILLIS
```
    一周的毫秒数
    
    另请参阅:
    
    常量字段值
  - FORMAT_YMDHMS
```
public static final String FORMAT_YMDHMS
```
    yyyy-MM-dd HH:mm:ss格式的日期
    
    另请参阅:
    
    常量字段值
  - FORMAT_YMD
```
public static final String FORMAT_YMD
```
    yyyy-MM-dd格式的日期
    
    另请参阅:
    
    常量字段值
  - FORMAT_HMS
```
public static final String FORMAT_HMS
```
    HH:mm:ss格式的日期
    
    另请参阅:
    
    常量字段值
  - FORMAT_EEEE
```
public static final String FORMAT_EEEE
```
    EEEE格式的日期
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - XTimeTools
```
public XTimeTools()
```
- 方法详细资料
  - dateFormat
```
public static String dateFormat(String format,
                                Date date)
```
    将date对象转换成相应格式的字符串，线程安全
    
    参数:
    
    format - 格式字符串
    
    date - date对象
    
    返回:
    
    相应格式的字符串
  - dateParse
```
public static Date dateParse(String format,
                             String dateStr)
```
    将日期字符串转换成相应的date对象，线程安全
    
    参数:
    
    format - 格式字符串
    
    dateStr - 日期字符串
    
    返回:
    
    相应的date对象
  - dateType
```
public static int dateType(Date date)
```
    获取任意一天的类型
    
    参数:
    
    date - 任意一天的date对象
    
    返回:
    
    任意一天的类型。1：工作日(XTimeTools.WORKDAY)，2：公休日(XTimeTools.RESTDAY)，3：节假日(XTimeTools.HOLIDAY)
    
    另请参阅:
    
    WORKDAY, RESTDAY, HOLIDAY
  - date
```
public static Date date(Date base,
                        int offset)
```
    获取以任意时间所在的那一天为基准偏移若干天的00:00:00时刻的date对象
    
    参数:
    
    base - 任意时间的date对象，如果为null则以当前时间为基准
    
    offset - 偏移的天数
    
    返回:
    
    以base所在的那一天为基准偏移offset天00:00:00时刻的date对象
  - dateByWeek
```
public static Date dateByWeek(Date base,
                              int weekOffset,
                              int dayIndex)
```
    获取以某天所在的那一周为基准偏移若干周的某天00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    weekOffset - 偏移的周数
    
    dayIndex - 那一周的第几天（每周的第一天是周一，周一为0）
    
    返回:
    
    以base所在的那一周为基准偏移weekOffset周的dayIndex天00:00:00时刻的date对象
  - dateByMonth
```
public static Date dateByMonth(Date base,
                               int monthOffset,
                               int dayIndex)
```
    获取以某天所在的那一月为基准偏移若干月的某天00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    monthOffset - 偏移的月数
    
    dayIndex - 那一月的第几天（一号为0）
    
    返回:
    
    以base所在的那一月为基准偏移monthOffset月的dayIndex天00:00:00时刻的date对象
  - dateBySeason
```
public static Date dateBySeason(Date base,
                                int seasonOffset,
                                int dayIndex)
```
    获取以某天所在的那一季度为基准偏移若干季度的某天00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    seasonOffset - 偏移的季度数
    
    dayIndex - 那一季度的第几天（一号为0）
    
    返回:
    
    以base所在的那一季度为基准偏移seasonOffset季度的dayIndex天00:00:00时刻的date对象
  - dateByYear
```
public static Date dateByYear(Date base,
                              int yearOffset,
                              int dayIndex)
```
    获取以某天所在的那一年为基准偏移若干年的某天00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    yearOffset - 偏移的年数
    
    dayIndex - 那一年的第几天（第一天为0）
    
    返回:
    
    以base所在的那一年为基准偏移yearOffset年的dayIndex天00:00:00时刻的date对象
  - weekByMonth
```
public static Date weekByMonth(Date base,
                               int monthOffset,
                               int weekIndex)
```
    获取以某天所在的那一月为基准偏移若干月的某周的周一00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    monthOffset - 偏移的月数
    
    weekIndex - 那一月的第几周（每周的第一天是周一，每月的第一周是第一个周一所在的那一周，第一周为0）
    
    返回:
    
    以base所在的那一月为基准偏移monthOffset月的weekIndex周的周一00:00:00时刻的date对象
  - weekBySeason
```
public static Date weekBySeason(Date base,
                                int seasonOffset,
                                int weekIndex)
```
    获取以某天所在的那一季度为基准偏移若干季度的某周的周一00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    seasonOffset - 偏移的季度数
    
    weekIndex - 那一季度的第几周（每周的第一天是周一，每季度的第一周是第一个周一所在的那一周，第一周为0）
    
    返回:
    
    以base所在的那一季度为基准偏移seasonOffset季度的weekIndex周的周一00:00:00时刻的date对象
  - weekByYear
```
public static Date weekByYear(Date base,
                              int yearOffset,
                              int weekIndex)
```
    获取以某天所在的那一年为基准偏移若干年的某周的周一00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    yearOffset - 偏移的年数
    
    weekIndex - 那一年的第几周（每周的第一天是周一，每年的第一周是第一个周一所在的那一周，第一周为0）
    
    返回:
    
    以base所在的那一年为基准偏移yearOffset年的monthIndex月的weekIndex周的周一00:00:00时刻的date对象
  - monthBySeason
```
public static Date monthBySeason(Date base,
                                 int seasonOffset,
                                 int monthIndex)
```
    获取以某天所在的那一季度为基准偏移若干季度的某月的一号00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    seasonOffset - 偏移的季度数
    
    monthIndex - 那一季度的第几个月（第一个月为0）
    
    返回:
    
    以base所在的那一季度为基准偏移seasonOffset季度的monthIndex月的一号00:00:00时刻的date对象
  - monthByYear
```
public static Date monthByYear(Date base,
                               int yearOffset,
                               int monthIndex)
```
    获取以某天所在的那一年为基准偏移若干年的某月的一号00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    yearOffset - 偏移的年数
    
    monthIndex - 那一年的第几个月（一月为0）
    
    返回:
    
    以base所在的那一年为基准偏移yearOffset年的monthIndex月的一号00:00:00时刻的date对象
  - seasonByYear
```
public static Date seasonByYear(Date base,
                                int yearOffset,
                                int seasonIndex)
```
    获取以某天所在的那一年为基准偏移若干年的某季度的第一天00:00:00时刻的date对象
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    yearOffset - 偏移的年数
    
    seasonIndex - 那一年的第几个季度（第一个季度为0）
    
    返回:
    
    以base所在的那一年为基准偏移yearOffset年的seasonIndex月的第一天00:00:00时刻的date对象
  - dateInWeek
```
public static int dateInWeek(Date base)
```
    获取任意一天是一周中的第几天
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天是那周中的第几天（每周的第一天是周一，周一为0）
  - dateInMonth
```
public static int dateInMonth(Date base)
```
    获取任意一天是一个月中的第几天
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天是那个月中的第几天（一号为0）
  - dateInSeason
```
public static int dateInSeason(Date base)
```
    获取任意一天是一个季度中的第几天
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天是那个季度中的第几天（第一天为0）
  - dateInYear
```
public static int dateInYear(Date base)
```
    获取任意一天是一年中的第几天
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天是那一年中的第几天（第一天为0）
  - weekInMonth
```
public static int weekInMonth(Date base)
```
    获取任意一天所在的周是哪个月的第几周
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的周是哪个月的第几周（正数表示本月第几周，负数表示上月第几周,例：1=本月第二周，-3=上月第四周）
  - weekInSeason
```
public static int weekInSeason(Date base)
```
    获取任意一天所在的周是哪一季度的第几周
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的周是哪一季度的第几周（正数表示本季度第几周，负数表示上季度第几周,例：1=本季第第二周，-12=上季度第13周）
  - weekInYear
```
public static int weekInYear(Date base)
```
    获取任意一天所在的周是哪一年的第几周
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的周是哪一年的第几周（正数表示今年第几周，负数表示去年第几周,例：1=今年第二周，-51=去年第52周）
  - monthInSeason
```
public static int monthInSeason(Date base)
```
    获取任意一天所在的月是那一季度的第几月
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的月是那一季度的第几月，第一个月为0
  - monthInYear
```
public static int monthInYear(Date base)
```
    获取任意一天所在的月是那一年的第几月
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的月是那一年的第几月，第一个月为0
  - seasonInYear
```
public static int seasonInYear(Date base)
```
    获取任意一天所在的季度是那一年的第几个季度
    
    参数:
    
    base - 基准时间的date对象，如果为null则以当前时间为基准
    
    返回:
    
    base那天所在的季度是那一年的第几季度，第一个季度为0
  - solarToLunar
```
public static String solarToLunar(Date solarDate)
```
    将阳历时间转化成农历时间
    
    参数:
    
    solarDate - 阳历时间的Date对象
    
    返回:
    
    对应的农历时间的字符串，例1：1992年八月初六。例2：2033年闰冬月廿八
  - lunarToSolar
```
public static Date lunarToSolar(String lunarDate)
```
    将农历时间转换成阳历时间
    
    参数:
    
    lunarDate - 农历时间字符串。例1：1992年八月初六。例2：2033年闰冬月廿八
    
    返回:
    
    阳历时间的Date对象

类 XTimeTools

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

MONDAY

TUESDAY

WEDNESDAY

THURSDAY

FRIDAY

SATURDAY

SUNDAY

WORKDAY

RESTDAY

HOLIDAY

DAY_MILLIS

WEEK_MILLIS

FORMAT_YMDHMS

FORMAT_YMD

FORMAT_HMS

FORMAT_EEEE

构造器详细资料

XTimeTools

方法详细资料

dateFormat

dateParse

dateType

date

dateByWeek

dateByMonth

dateBySeason

dateByYear

weekByMonth

weekBySeason

weekByYear

monthBySeason

monthByYear

seasonByYear

dateInWeek

dateInMonth

dateInSeason

dateInYear

weekInMonth

weekInSeason

weekInYear

monthInSeason

monthInYear

seasonInYear

solarToLunar

lunarToSolar