xyz.zhouxy.plusone.commons.time

Enum Quarter

java.lang.Object

java.lang.Enum<Quarter>

xyz.zhouxy.plusone.commons.time.Quarter

All Implemented Interfaces:

Serializable, Comparable<Quarter>, IWithIntCode

public enum Quarter
extends Enum<Quarter>
implements IWithIntCode

季度

Author:

ZhouXY108

Enum Constant Summary

Enum Constants

Enum Constant and Description
Q1 第一季度
Q2 第二季度
Q3 第三季度
Q4 第四季度

Method Summary

Modifier and Type	Method and Description
YearQuarter	atYear(int year) 根据指定的年份，获取一个新的 YearQuarter 实例 此方法允许在保持当前季度信息不变的情况下，更改年份
static int	checkValidIntValue(int value) 检查给定的季度值是否有效
int	firstDayOfYear(boolean leapYear) 计算该季度的第一天为当年的第几天
Month	firstMonth() 该季度的第一个月
MonthDay	firstMonthDay() 该季度的第一天
int	firstMonthValue() 该季度的第一个月
static Quarter	fromMonth(int monthValue) 根据给定的月份值返回对应的季度
static Quarter	fromMonth(Month month) 根据给定的月份返回对应的季度
int	getCode() 获取码值
int	getValue() 获取季度值
Month	lastMonth() 该季度的最后一个月
MonthDay	lastMonthDay() 该季度的最后一天
int	lastMonthValue() 该季度的最后一个月
Quarter	minus(long quarters) 减去指定数量的季度
static Quarter	of(int value) 根据给定的季度值返回对应的季度
Quarter	plus(long quarters) 加上指定数量的季度
static Quarter	valueOf(String name) Returns the enum constant of this type with the specified name.
static Quarter[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface xyz.zhouxy.plusone.commons.base.IWithIntCode

isCodeEquals, isSameCodeAs, isSameCodeAs, isSameCodeAs

Enum Constant Detail

Q1

public static final Quarter Q1

第一季度

Q2

public static final Quarter Q2

第二季度

Q3

public static final Quarter Q3

第三季度

Q4

public static final Quarter Q4

第四季度

Method Detail

values

public static Quarter[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Quarter c : Quarter.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Quarter valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

fromMonth

public static Quarter fromMonth(int monthValue)

根据给定的月份值返回对应的季度

Parameters:

monthValue - 月份值，取值范围为1到12

Returns:

对应的季度

Throws:

IllegalArgumentException - 如果月份值不在有效范围内（1到12），将抛出异常

fromMonth

public static Quarter fromMonth(Month month)

根据给定的月份返回对应的季度

Parameters:

month - 月份

Returns:

对应的季度

atYear

public final YearQuarter atYear(int year)

根据指定的年份，获取一个新的 YearQuarter 实例 此方法允许在保持当前季度信息不变的情况下，更改年份

Parameters:

year - 指定的年份

Returns:

返回一个新的 YearQuarter 实例，年份更新为指定的年份

of

public static Quarter of(int value)

根据给定的季度值返回对应的季度

Parameters:

value - 季度值 (1/2/3/4)

Returns:

对应的季度

Throws:

IllegalArgumentException - 如果季度值不在有效范围内（1到4），将抛出异常

plus

public Quarter plus(long quarters)

加上指定数量的季度

Parameters:

quarters - 所添加的季度数量

Returns:

计算结果

minus

public Quarter minus(long quarters)

减去指定数量的季度

Parameters:

quarters - 所减去的季度数量

Returns:

计算结果

getValue

public int getValue()

获取季度值

Returns:

季度值

getCode

public int getCode()

Description copied from interface: IWithIntCode

获取码值

Specified by:

getCode in interface IWithIntCode

Returns:

码值

firstMonth

public Month firstMonth()

该季度的第一个月

Returns:

Month 对象

firstMonthValue

public int firstMonthValue()

该季度的第一个月

Returns:

月份值从 1 开始，1 表示 1月，以此类推。

lastMonth

public Month lastMonth()

该季度的最后一个月

Returns:

Month 对象

lastMonthValue

public int lastMonthValue()

该季度的最后一个月

Returns:

月份值从 1 开始，1 表示 1月，以此类推。

firstMonthDay

public MonthDay firstMonthDay()

该季度的第一天

Returns:

MonthDay 对象

lastMonthDay

public MonthDay lastMonthDay()

该季度的最后一天

Returns:

MonthDay 对象

firstDayOfYear

public int firstDayOfYear(boolean leapYear)

计算该季度的第一天为当年的第几天

Parameters:

leapYear - 是否为闰年

Returns:

day of year

checkValidIntValue

public static int checkValidIntValue(int value)

检查给定的季度值是否有效

Parameters:

value - 季度值

Returns:

如果给定的季度值有效则返回该值

Throws:

DateTimeException - 如果给定的季度值不在有效范围内（1到4），将抛出异常