java 工具类将不规范日期转为规范日期

原创

mob649e81637cea 2024-08-21 05:57:32 ©著作权

©著作权归作者所有：来自51CTO博客作者mob649e81637cea的原创作品，请联系作者获取转载授权，否则将追究法律责任

实现 Java 工具类将不规范日期转为规范日期

在开发中，日期的处理往往是一个琐碎且容易出错的环节。特别是有些系统中，日期格式不统一，这就需要我们写一个工具类，将这些不规范日期转换为标准格式。本文将带你一步一步实现这个 Java 工具类。

整体流程

以下是将不规范日期转为规范日期的步骤流程：

步骤	描述
1	确定输入与输出格式
2	编写工具类的基本结构
3	实现日期格式转换的方法
4	编写单元测试

步骤详解

1. 确定输入与输出格式

在进行日期转换之前，首先需要明确输入及输出格式。一般来说，输入日期可能是多种格式，例如："yyyy-MM-dd"、"MM/dd/yyyy"、"dd-MM-yyyy"，而我们希望将它们统一转换为 ISO 标准格式，即："yyyy-MM-dd"。

2. 编写工具类的基本结构

接下来，我们将创建一个工具类 DateUtil，用以存放我们的日期处理方法。

package com.example.utils;

/**
 * 日期工具类，用于将不规范日期转换为规范日期
 */
public class DateUtil {
    // 未来会添加的方法
}

3. 实现日期格式转换的方法

我们需要一个方法 convertDate，这个方法将接受一个字符串形式的日期，并返回规范的日期格式。我们将使用 SimpleDateFormat 类来处理日期的解析和格式化。

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

/**
 * 日期工具类，实现日期格式转换
 */
public class DateUtil {
    private static final String STANDARD_DATE_FORMAT = "yyyy-MM-dd";

    /**
     * 将不规范日期字符串转换为规范日期格式
     *
     * @param dateStr 不规范的日期字符串
     * @return 规范的日期字符串
     */
    public static String convertDate(String dateStr) {
        // 定义多种可能的日期格式
        String[] formats = {
            "yyyy-MM-dd",
            "MM/dd/yyyy",
            "dd-MM-yyyy",
            "yyyy.MM.dd",
            "MM.dd.yyyy"
        };

        // 尝试逐一解析日期
        for (String format : formats) {
            try {
                SimpleDateFormat sdf = new SimpleDateFormat(format);
                Date date = sdf.parse(dateStr);
                // 格式化为标准日期格式
                SimpleDateFormat standardSDF = new SimpleDateFormat(STANDARD_DATE_FORMAT);
                return standardSDF.format(date);
            } catch (ParseException e) {
                // 捕获解析异常，继续尝试下一个格式
            }
        }
        // 如果所有格式都无效，返回 null 或抛出异常
        return null; // 或者 throw new IllegalArgumentException("无效日期格式");
    }
}

4. 编写单元测试

为了确保我们的工具类可以正常工作，我们需要编写一些单元测试来验证其功能。

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

public class DateUtilTest {
  
    @Test
    public void testConvertDate() {
        Assertions.assertEquals("2023-10-01", DateUtil.convertDate("2023-10-01"));
        Assertions.assertEquals("2023-10-01", DateUtil.convertDate("10/01/2023"));
        Assertions.assertEquals("2023-10-01", DateUtil.convertDate("01-10-2023"));
        Assertions.assertEquals("2023-10-01", DateUtil.convertDate("2023.10.01"));
        Assertions.assertEquals("2023-10-01", DateUtil.convertDate("10.01.2023"));
    }

    @Test
    public void testInvalidDate() {
        Assertions.assertNull(DateUtil.convertDate("invalid-date"));
    }
}

上面的测试用例涵盖了多种格式和无效输入，以确保我们的方法能有效地进行日期转换而不出错。

序列图

下面是一个序列图，展示了日期转换的过程。

sequenceDiagram
    participant User
    participant DateUtil
    User->>DateUtil: convertDate("10/01/2023")
    DateUtil->>DateUtil: parse("10/01/2023")
    DateUtil->>User: "2023-10-01"

甘特图

接下来是一个甘特图，展示整个开发的时间安排。

gantt
    title 日期工具类开发计划
    dateFormat  YYYY-MM-DD
    section 设计阶段
    确定输入与输出格式     :a1, 2023-10-01, 1d
    编写工具类基本结构       :a2, after a1, 1d
    section 实现阶段
    日期格式转换实现        :b1, after a2, 2d
    编写单元测试             :b2, after b1, 1d