Java 时间工具类

### Java 时间工具类详解 在Java开发中，处理日期与时间是常见的需求之一。本文将详细介绍一个实用的Java时间工具类——`DataUtil`。该工具类提供了多种用于日期和时间转换的方法，使得开发者能够更加方便地进行日期时间的操作。 #### 一、包结构与导入依赖 此工具类位于`com..util`包下，导入了以下依赖： - `java.sql.Timestamp` - `java.text.SimpleDateFormat` - `java.util.Calendar` - `java.util.Date` 这些依赖为实现日期时间转换的功能提供了必要的支持。 #### 二、核心功能介绍 ##### 1. 日期到字符串的转换 - **`public static String DateToString(Date date, String pattern)`** - 功能：将日期对象按照指定的格式转换为字符串。 - 参数： - `date`: 日期对象。 - `pattern`: 转换格式，例如 `"yyyy-MM-dd"`。 - 返回值：转换后的字符串。 - **`public static String DateToString(Date date)`** - 功能：将日期对象按照默认格式（`"yyyy-MM-dd"`）转换为字符串。 - 参数：`date` - 日期对象。 - 返回值：转换后的字符串。 - **`public static String DateTimeToString(Date date)`** - 功能：将日期对象按照包含时间的格式（`"yyyy-MM-dd HH:mm:ss"`）转换为字符串。 - 参数：`date` - 日期对象。 - 返回值：转换后的字符串。 ##### 2. 字符串到日期的转换 - **`public static Date StringToDate(String str, String pattern)`** - 功能：将字符串按照指定的格式转换为日期对象。 - 参数： - `str`: 需要转换的字符串。 - `pattern`: 转换格式。 - 返回值：转换后的日期对象。 - **`public static Date StringToDate(String str)`** - 功能：将字符串按照默认格式（`"yyyy-MM-dd"`）转换为日期对象。 - 参数：`str` - 需要转换的字符串。 - 返回值：转换后的日期对象。 - **`public static Date StringToDateTime(String str)`** - 功能：将字符串按照包含时间的格式（`"yyyy-MM-dd HH:mm:ss"`）转换为日期对象。 - 参数：`str` - 需要转换的字符串。 - 返回值：转换后的日期对象。 ##### 3. 字符串到Timestamp的转换 - **`public static Timestamp StringToDateHMS(String str) throws Exception`** - 功能：将字符串按照`"yyyy-MM-dd HH:mm:ss"`格式转换为`Timestamp`对象。 - 参数：`str` - 待转换的字符串。 - 返回值：转换后的`Timestamp`对象。 - 异常：如果转换失败，则抛出异常。 ##### 4. 根据年月日创建日期对象 - **`public static Date YmdToDate(int year, int month, int day)`** - 功能：根据传入的年、月、日创建一个日期对象。 - 参数： - `year`: 年份。 - `month`: 月份（注意，这里的月份是从0开始计数的，即1月为0）。 - `day`: 天。 - 返回值：创建好的日期对象。 #### 三、使用示例 下面通过几个具体的例子来展示如何使用`DataUtil`类中的方法： 1. **将当前日期转换为字符串**: ```java String currentDateStr = DataUtil.DateToString(new Date()); System.out.println("Current Date: " + currentDateStr); ``` 2. **将特定格式的字符串转换为日期**: ```java String dateString = "2023-09-01"; Date date = DataUtil.StringToDate(dateString); System.out.println("Converted Date: " + date); ``` 3. **创建一个特定日期**: ```java Date specificDate = DataUtil.YmdToDate(2023, 8, 15); // 注意月份是从0开始计数的 System.out.println("Specific Date: " + specificDate); ``` #### 四、注意事项 1. **格式化字符串**：确保提供的格式化字符串正确无误，否则可能导致转换失败。 2. **异常处理**：在处理可能引发异常的操作时（如字符串到日期的转换），应当考虑适当的异常处理机制。 3. **月份计数**：在使用`YmdToDate`方法时，需要注意月份是从0开始计数的，即1月为0、2月为1等。 通过以上介绍，我们可以看出`DataUtil`工具类为Java开发者提供了强大而灵活的时间日期处理能力，大大简化了日常开发中的日期时间操作。