package com.ruoyi.quartz.util;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;

import org.quartz.CronExpression;

/**
 * cron表达式工具类
 * 
 * @author ruoyi
 *
 */
public class CronUtils
{
    /**
     * 返回一个布尔值代表一个给定的Cron表达式的有效性
     *
     * @param cronExpression Cron表达式
     * @return boolean 表达式是否有效
     */
    public static boolean isValid(String cronExpression)
    {
        return CronExpression.isValidExpression(cronExpression);
    }

    /**
     * 返回一个字符串值,表示该消息无效Cron表达式给出有效性
     *
     * @param cronExpression Cron表达式
     * @return String 无效时返回表达式错误描述,如果有效返回null
     */
    public static String getInvalidMessage(String cronExpression)
    {
        try
        {
            new CronExpression(cronExpression);
            return null;
        }
        catch (ParseException pe)
        {
            return pe.getMessage();
        }
    }

    /**
     * 返回下一个执行时间根据给定的Cron表达式
     *
     * @param cronExpression Cron表达式
     * @return Date 下次Cron表达式执行时间
     */
    public static Date getNextExecution(String cronExpression)
    {
        try
        {
            CronExpression cron = new CronExpression(cronExpression);
            return cron.getNextValidTimeAfter(new Date(System.currentTimeMillis()));
        }
        catch (ParseException e)
        {
            throw new IllegalArgumentException(e.getMessage());
        }
    }

    /**
     * 将Date转换为精确到秒的Cron表达式
     * @param date 待转换的日期时间（不能为空）
     * @return 格式为 "秒 分 时 日 月 ?" 的Cron表达式（周字段使用?避免与日字段冲突）
     * @throws IllegalArgumentException 当传入日期为null时抛出异常
     */
    public static String generateCronExpression(Date date) {
        // 校验入参
        if (date == null) {
            throw new IllegalArgumentException("传入的日期不能为空！");
        }

        // 设置时区（避免时区偏移导致时间错误，可根据实际需求调整）
        TimeZone timeZone = TimeZone.getDefault();
        SimpleDateFormat sdf = new SimpleDateFormat("ss mm HH dd MM");
        sdf.setTimeZone(timeZone);

        // 格式化日期为：秒 分 时 日 月
        String timePart = sdf.format(date);
        // 拼接周字段为?（Cron表达式中，日和周字段不能同时指定具体值，此处用?表示不指定周）
        return timePart + " ?";
    }
}
