org.dromara.hutool.core.date.chinese

Class ShiChen

java.lang.Object

org.dromara.hutool.core.date.chinese.ShiChen

public class ShiChen
extends Object

时辰转换器，支持宋以后的二十四时辰制度。

本转换器提供以下功能：

• 处理包含“时”、“初”或“正”后缀的时辰描述，并自动返回相应的现代时间段。 “初”和“正”分别对应每个时辰的前半段和后半段，而不带后缀的“时”描述则涵盖该时辰的完整时间段。
• 根据小时数转换为相应的时辰描述，通过isAbs参数控制是否包含“初”或“正”。

异常情况：

• 如果输入的时辰描述无效或不被识别，toModernTime 方法将抛出 IllegalArgumentException。
• 同样，如果toShiChen方法接收到无效的小时数，将返回“未知”。

示例：

• toModernTime("子时") 返回的时间段从23点开始到1点结束。
• toModernTime("子初") 返回的时间段从23点开始到0点结束。
• toModernTime("子正") 返回的时间段从0点开始到1点结束。
• toShiChen(0, false) 返回“子正”。
• toShiChen(0, true) 返回“子时”。

Author:

achao@hutool.cn

Constructor Summary

Constructors

Constructor and Description
ShiChen()

Method Summary

Modifier and Type	Method and Description
static DateBetween	toModernTime(String shiChen) 将时辰描述转换为现代时间段。
static String	toShiChen(int hour, boolean isAbs) 根据给定的小时数转换为对应的时辰描述。

Methods inherited from class java.lang.Object

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

Constructor Detail

ShiChen

public ShiChen()

Method Detail

toModernTime

public static DateBetween toModernTime(String shiChen)

将时辰描述转换为现代时间段。示例：

• toModernTime("子时") 返回的时间段从23点开始到1点结束。
• toModernTime("子初") 返回的时间段从23点开始到0点结束。
• toModernTime("子正") 返回的时间段从0点开始到1点结束。

Parameters:

shiChen - 时辰描述，可以是“时”、“初”或“正”结尾。

Returns:

DateBetween 对象，表示起始和结束时间。

Throws:

IllegalArgumentException - 如果输入的时辰描述无效。

toShiChen

public static String toShiChen(int hour,
                               boolean isAbs)

根据给定的小时数转换为对应的时辰描述。示例：

• toShiChen(0, false) 返回“子正”。
• toShiChen(0, true) 返回“子时”。

Parameters:

hour - 小时数，应在0到23之间。

isAbs - 是否返回绝对时辰描述（即包含“时”后缀），而不是“初”或“正”。

Returns:

时辰描述，如果小时数无效，则返回“未知”。