com.iohao.game.common.kit.TimeBetweenKit Maven / Gradle / Ivy

Go to download
/*
 * ioGame
 * Copyright (C) 2021 - present  渔民小镇 （[email protected]、[email protected]） . All Rights Reserved.
 * # iohao.com . 渔民小镇
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see .
 */
package com.iohao.game.common.kit;

import java.io.Serializable;
import java.time.LocalTime;

/**
 * 时间段范围
 *  *     23:00~1:30
 * 
 *
 * @author 渔民小镇
 * @date 2021-12-20
 * @deprecated 暂无代替，如有需要请 copy 现有的相关代码
 */
@Deprecated
public class TimeBetweenKit implements Serializable {
    /**
     * 一天的分钟总数
     */
    static final int oneDayMinute = 24 * 60;

    /**
     * 指定时间是否在 时间段范围内
     *      * 示例:
     *     起始时间 23:00, 结束时间 1:30
     *
     *     当前时间在起始时间与结束时间之内就是时间段内,
     *     如果当前时间是 1:31, 就不属于时间段内
     * 
     *
     * @param startTime 起始时间 格式 [小时:分钟] . 如: 23:00, 1:30
     * @param endTime   结束时间 格式 [小时:分钟] . 如: 23:00, 1:30
     * @param nowTime   当前时间是否在 起始时间与结束时间之内
     * @return true 起始时间与结束时间之内
     */
    public static boolean betweenNowTime(String startTime, String endTime, LocalTime nowTime) {

        int startTimeIndex = convertTimeIndex(startTime);
        int endTimeIndex = convertTimeIndex(endTime);

        return betweenNowTime(startTimeIndex, endTimeIndex, nowTime);
    }

    /**
     * 指定时间是否在 时间段范围内
     *      * 示例:
     *     起始时间 23:00, 结束时间 1:30
     *
     *     当前时间在起始时间与结束时间之内就是时间段内,
     *     如果当前时间是 1:31, 就不属于时间段内
     * 
     *
     * @param startTimeIndex 起始时间数值 把格式 [小时:分钟] . 如: 23:00, 1:30的时间格式转换成 时间数值
     * @param endTimeIndex   结束时间数值 格式 [小时:分钟] . 如: 23:00, 1:30的时间格式转换成 时间数值
     * @param nowTime        当前时间是否在 起始时间与结束时间之内
     * @return true 起始时间与结束时间之内
     */
    public static boolean betweenNowTime(int startTimeIndex, int endTimeIndex, LocalTime nowTime) {
        if (startTimeIndex == endTimeIndex) {
            return false;
        }

        int nowTimeIndex = convertTimeIndex(nowTime);

        boolean success;
        // 跨天
        if (startTimeIndex > endTimeIndex) {
            if (nowTimeIndex >= startTimeIndex) {
                // 说明是当天的时间段比较
                success = true;
            } else {
                /*
                 * 跨天时间段:
                 * 1 给当前时间加上全天分钟数
                 * 2 给结束时间加上全天分钟数
                 */
                int upNowTimeIndex = nowTimeIndex + oneDayMinute;
                int upEndIndex = endTimeIndex + oneDayMinute;
                success = upNowTimeIndex >= startTimeIndex && upNowTimeIndex <= upEndIndex;
            }
        } else {
            success = nowTimeIndex >= startTimeIndex && nowTimeIndex <= endTimeIndex;
        }

        return success;
    }

    /**
     * 当前时间是否在 时间段范围内
     *      * 示例:
     *     起始时间 23:00, 结束时间 1:30
     *
     *     当前时间在起始时间与结束时间之内就是时间段内,
     *     如果当前时间是 1:31, 就不属于时间段内
     * 
     *
     * @param startTime 起始时间 格式 [小时:分钟] . 如: 23:00, 1:30
     * @param endTime   结束时间 格式 [小时:分钟] . 如: 23:00, 1:30
     * @return true 起始时间与结束时间之内
     */
    public static boolean betweenNowTime(String startTime, String endTime) {
        return betweenNowTime(startTime, endTime, LocalTime.now());
    }

    /**
     * 将 LocalTime 的时间和分钟转换成 时间数值
     *
     * @param localTime LocalTime
     * @return 转换后的 时间数值
     */
    private static int convertTimeIndex(LocalTime localTime) {
        int hour = localTime.getHour();
        int minute = localTime.getMinute();
        return convertTimeIndex(hour, minute);
    }

    /**
     * 将小时和分钟转换成 时间数值
     *
     * @param time 小时和分钟. 格式 [小时:分钟] . 如: 23:00, 1:30
     * @return 转换后的 时间数值
     */
    public static int convertTimeIndex(String time) {
        String[] split = time.split(":");
        int hours = Integer.parseInt(split[0]);
        int minute = Integer.parseInt(split[1]);
        return convertTimeIndex(hours, minute);
    }

    /**
     * 将小时和分钟转换成 时间数值
     *
     * @param hours  小时
     * @param minute 分钟
     * @return 转换后的 时间数值
     */
    private static int convertTimeIndex(int hours, int minute) {
        return hours * 60 + minute;
    }
}