首页 > 代码库 > 为大家提供一个好的时间工具类DateTime

为大家提供一个好的时间工具类DateTime

此类的灵感来源于C#

尽管网上有什么date4j,可是jar太纠结了。先给出源代码,能够继承到自己的util包中。作为一个资深程序猿,我相信都有不少好的util工具类,我也希望经过此次分享,能带动技术大牛们能分享出自己的好用的工具类。


先看源代码

/*
 * 岸思科技开发平台(JAVA) SDK
 *
 * Copyright (c) 2014, Ansitech Network Technology Co.,Ltd All rights reserved.
 * http://www.ansitech.com/java/sdk/
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.ansitech.core.system;

import java.io.Serializable;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;

/**
 * 日期时间类
 *
 * <p>对Calendar的封装,以便于使用</p>
 *
 * @author qsyang
 * @version 1.0
 */
public class DateTime implements Serializable {

    /**
     * yyyy-MM-dd HH:mm:ss 格式
     */
    public static final String DEFAULT_DATE_TIME_FORMAT_PATTERN = "yyyy-MM-dd HH:mm:ss";
    /**
     * yyyy-MM-dd HH:mm 格式
     */
    public static final String DEFAULT_DATE_TIME_HHmm_FORMAT_PATTERN = "yyyy-MM-dd HH:mm";
    /**
     * yyyy-MM-dd HH 格式
     */
    public static final String DEFAULT_DATE_TIME_HH_FORMAT_PATTERN = "yyyy-MM-dd HH";
    /**
     * yyyy-MM-dd 格式
     */
    public static final String DEFAULT_DATE_FORMAT_PATTERN = "yyyy-MM-dd";
    /**
     * HH:mm:ss 格式
     */
    public static final String DEFAULT_TIME_FORMAT_PATTERN = "HH:mm:ss";
    /**
     * HH:mm 格式
     */
    public static final String DEFAULT_TIME_HHmm_FORMAT_PATTERN = "HH:mm";
    /**
     * 年
     * <p>能够通过DateTime.now().get(DateTime.YEAR_FIELD)来获取当前时间的年</p>
     */
    public static final int YEAR_FIELD = java.util.Calendar.YEAR;
    /**
     * 月
     * <p>能够通过DateTime.now().get(DateTime.MONTH_FIELD)来获取当前时间的月</p>
     */
    public static final int MONTH_FIELD = java.util.Calendar.MONTH;
    /**
     * 日
     * <p>能够通过DateTime.now().get(DateTime.DAY_FIELD)来获取当前时间的日</p>
     */
    public static final int DAY_FIELD = java.util.Calendar.DATE;
    /**
     * 小时 <p>能够通过DateTime.now().get(DateTime.HOUR_FIELD)来获取当前时间的小时</p>
     */
    public static final int HOUR_FIELD = java.util.Calendar.HOUR_OF_DAY;
    /**
     * 分钟 <p>能够通过DateTime.now().get(DateTime.MINUTE_FIELD)来获取当前时间的分钟</p>
     */
    public static final int MINUTE_FIELD = java.util.Calendar.MINUTE;
    /**
     * 秒
     * <p>能够通过DateTime.now().get(DateTime.SECOND_FIELD)来获取当前时间的秒</p>
     */
    public static final int SECOND_FIELD = java.util.Calendar.SECOND;
    /**
     * 毫秒 <p>能够通过DateTime.now().get(DateTime.MILLISECOND_FIELD)来获取当前时间的毫秒</p>
     */
    public static final int MILLISECOND_FIELD = java.util.Calendar.MILLISECOND;
    private java.util.Calendar c;   //日历类

    /**
     * 获取一个DateTime,此DateTime尚未初始化,表示的时间是1970-1-1 00:00:00.000
     * <p>要获取当前系统时间,请用DateTime.now();</p>
     */
    public DateTime() {
        c = Calendar.getInstance();
        c.clear();
    }

    /**
     * 设置时间 <p>能够传入一个时间对象,将会被转换为DateTime类型</p>
     *
     * @param date 时间对象
     */
    public DateTime(java.util.Date date) {
        c = Calendar.getInstance();
        c.setTime(date);
    }

    /**
     * 设置时间 <p>能够传入一个日历对象。将会被转换为DateTime类型</p>
     *
     * @param calendar 日历对象
     */
    public DateTime(java.util.Calendar calendar) {
        this.c = calendar;
    }

    /**
     * 获取当前系统时间
     *
     * @return DateTime 当前系统时间
     */
    public static DateTime now() {
        Calendar calendar = Calendar.getInstance();
        return new DateTime(calendar);
    }

    /**
     * 用毫秒来设置时间, 时间的基数是1970-1-1 00:00:00.000; <p>比方,new DateTime(1000)
     * 则表示1970-1-1 00:00:01.000;<br> 用负数表示基础时间曾经的时间</p>
     *
     * @param milliseconds 毫秒
     */
    public DateTime(long milliseconds) {
        c = Calendar.getInstance();
        c.setTimeInMillis(milliseconds);
    }

    /**
     * 转换为Date类型
     *
     * @return Date时间
     */
    public Date toDate() {
        return c.getTime();
    }

    /**
     * 转换成 日历对象
     *
     * @return Calendar对象
     */
    public java.util.Calendar toCalendar() {
        return c;
    }

    /**
     * 转换成java.sql.Date(yyyy-MM-dd)日期
     *
     * @return java.sql.Date日期
     */
    public java.sql.Date toSqlDate() {
        return new java.sql.Date(c.getTimeInMillis());
    }

    /**
     * 转换为java.sql.Time(hh:mm:ss)时间
     *
     * @return java.sql.Time时间
     */
    public java.sql.Time toSqlTime() {
        return new java.sql.Time(c.getTimeInMillis());
    }

    /**
     * 转换为java.sql.Timestamp(时间戳)
     *
     * @return java.sql.Timestamp时间戳
     */
    public java.sql.Timestamp toSqlTimestamp() {
        return new java.sql.Timestamp(c.getTimeInMillis());
    }

    /**
     * 解析时间 <p>依据DateTime中的DEFAULT_TIME_FORMAT_PATTERN规则转换为hh:mm:ss或hh:mm格式</p>
     *
     * @param time 字符串格式时间
     * @return DateTime 日期时间对象
     */
    public static DateTime parseTime(String time) throws java.text.ParseException {
        try {
            return DateTime.parseDateTime(time, DateTime.DEFAULT_TIME_FORMAT_PATTERN);
        } catch (ParseException e) {
            return DateTime.parseDateTime(time, DateTime.DEFAULT_TIME_HHmm_FORMAT_PATTERN);
        }
    }

    /**
     * 解析日期 <p>依据DateTime中的DEFAULT_DATE_FORMAT_PATTERN规则转换为yyyy-MM-dd格式</p>
     *
     * @param date 字符串格式日期
     * @return DateTime 日期时间类
     */
    public static DateTime parseDate(String date) throws java.text.ParseException {
        return DateTime.parseDateTime(date, DateTime.DEFAULT_DATE_FORMAT_PATTERN);
    }

    /**
     * 解析日期时间 <p>依据DateTime中的DEFAULT_DATE_TIME_FORMAT_PATTERN规则转换为yyyy-MM-dd
     * HH:mm:ss格式</p>
     *
     * @param datetime 字符串格式日期时间
     * @return DateTime 日期时间对象
     */
    public static DateTime parseDateTime(String datetime) throws java.text.ParseException {
        DateTime result = null;
        //尝试按yyyy-MM-dd HH:mm:ss分析
        try {
            result = DateTime.parseDateTime(datetime, DateTime.DEFAULT_DATE_TIME_FORMAT_PATTERN);
        } catch (ParseException e) {
            //解析错误
            result = null;
        }

        //尝试按yyyy-MM-dd HH:mm分析
        if (null == result) {
            try {
                result = DateTime.parseDateTime(datetime, DateTime.DEFAULT_DATE_TIME_HHmm_FORMAT_PATTERN);
            } catch (ParseException e) {
                //解析错误
                result = null;
            }
        }

        //尝试按yyyy-MM-dd HH分析
        if (null == result) {
            try {
                result = DateTime.parseDateTime(datetime, DateTime.DEFAULT_DATE_TIME_HH_FORMAT_PATTERN);
            } catch (ParseException e) {
                //解析错误
                result = null;
            }
        }

        //尝试按yyyy-MM-dd分析
        if (null == result) {
            try {
                result = DateTime.parseDate(datetime);
            } catch (ParseException e) {
                //解析错误
                result = null;
            }
        }

        //尝试按时间分析
        if (null == result) {
            result = DateTime.parseTime(datetime);
        }
        return result;
    }

    /**
     * 用指定的pattern分析字符串 <p>pattern的使用方法參见java.text.SimpleDateFormat</p>
     *
     * @param datetime 字符串格式日期时间
     * @param pattern 日期解析规则
     * @return DateTime 日期时间对象
     * @see java.text.SimpleDateFormat
     */
    public static DateTime parseDateTime(String datetime, String pattern) throws java.text.ParseException {
        SimpleDateFormat fmt = (SimpleDateFormat) DateFormat.getDateInstance();
        fmt.applyPattern(pattern);
        return new DateTime(fmt.parse(datetime));
    }

    /**
     * 转换为 DEFAULT_DATE_FORMAT_PATTERN (yyyy-MM-dd) 格式字符串
     *
     * @return yyyy-MM-dd格式字符串
     */
    public String toDateString() {
        return toDateTimeString(DateTime.DEFAULT_DATE_FORMAT_PATTERN);
    }

    /**
     * 转换为 DEFAULT_TIME_FORMAT_PATTERN (HH:mm:ss) 格式字符串
     *
     * @return HH:mm:ss 格式字符串
     */
    public String toTimeString() {
        return toDateTimeString(DateTime.DEFAULT_TIME_FORMAT_PATTERN);
    }

    /**
     * 转换为 DEFAULT_DATE_TIME_FORMAT_PATTERN (yyyy-MM-dd HH:mm:ss) 格式字符串
     *
     * @return yyyy-MM-dd HH:mm:ss 格式字符串
     */
    public String toDateTimeString() {
        return toDateTimeString(DateTime.DEFAULT_DATE_TIME_FORMAT_PATTERN);
    }

    /**
     * 使用日期转换pattern <p>pattern的使用方法參见java.text.SimpleDateFormat</p>
     *
     * @param pattern 日期解析规则
     * @return 按规则转换后的日期时间字符串
     */
    public String toDateTimeString(String pattern) {
        SimpleDateFormat fmt = (SimpleDateFormat) DateFormat.getDateInstance();
        fmt.applyPattern(pattern);
        return fmt.format(c.getTime());
    }

    /**
     * 获取DateTime所表示时间的某个度量的值
     *
     * @param field int 取值为:<br> DateTime.YEAR_FIELD -- 返回年份<br>
     * DateTime.MONTH_FIELD -- 返回月份,一月份返回1,二月份返回2,依次类推<br> DateTime.DAY_FIELD --
     * 返回当前的天(本月中的)<br> DateTime.HOUR_FIELD -- 返回小时数(本天中的),24小时制<br>
     * DateTime.MINUTE_FIELD -- 返回分钟数(本小时中的)<br> DateTime.SECOND_FIELD --
     * 返回秒数(本分钟中的)<br> DateTime.MILLISECOND_FIELD -- 返回毫秒数(本秒中的)
     * @return int field相应的值
     */
    public int get(int field) {
        //月份须要+1(月份从0開始)
        if (DateTime.MONTH_FIELD == field) {
            return c.get(field) + 1;
        } else {
            return c.get(field);
        }
    }

    /**
     * 返回自 1970-1-1 0:0:0 至此时间的毫秒数
     *
     * @return long 毫秒数
     */
    public long getTimeInMillis() {
        return c.getTimeInMillis();
    }

    /**
     * 设置field字段的值
     *
     * @param field int 取值为:<br> DateTime.YEAR_FIELD -- 年份<br>
     * DateTime.MONTH_FIELD -- 月份,一月份从1開始<br> DateTime.DAY_FIELD --
     * 当前的天(本月中的)<br> DateTime.HOUR_FIELD -- 小时数(本天中的),24小时制<br>
     * DateTime.MINUTE_FIELD -- 分钟数(本小时中的)<br> DateTime.SECOND_FIELD --
     * 秒数(本分钟中的)<br> DateTime.MILLISECOND_FIELD -- 毫秒数(本秒中的)
     * @param value
     */
    public void set(int field, int value) {
        //月份须要-1(月份从0開始)
        if (DateTime.MONTH_FIELD == field) {
            c.set(field, value - 1);
        } else {
            c.set(field, value);
        }
    }

    /**
     * 设置DateTime日期的年/月/日
     *
     * @param year 年
     * @param month 月
     * @param day 日
     */
    public void set(int year, int month, int day) {
        set(DateTime.YEAR_FIELD, year);
        set(DateTime.MONTH_FIELD, month);
        set(DateTime.DAY_FIELD, day);
    }

    /**
     * 设置DateTime日期的年/月/日/小时
     *
     * @param year 年
     * @param month 月
     * @param day 日
     * @param hour 小时
     */
    public void set(int year, int month, int day, int hour) {
        set(year, month, day);
        set(DateTime.HOUR_FIELD, hour);
    }

    /**
     * 设置DateTime日期的年/月/日/小时/分钟
     *
     * @param year 年
     * @param month 月
     * @param day 日
     * @param hour 小时
     * @param minute 分钟
     */
    public void set(int year, int month, int day, int hour, int minute) {
        set(year, month, day, hour);
        set(DateTime.MINUTE_FIELD, minute);
    }

    /**
     * 设置DateTime日期的年/月/日/小时/分钟/秒
     *
     * @param year 年
     * @param month 月
     * @param day 日
     * @param hour 小时
     * @param minute 分钟
     * @param second 秒
     */
    public void set(int year, int month, int day, int hour, int minute, int second) {
        set(year, month, day, hour, minute);
        set(DateTime.SECOND_FIELD, second);
    }

    /**
     * 设置DateTime日期的年/月/日/小时/分钟/秒/毫秒
     *
     * @param year 年
     * @param month 月
     * @param day 日
     * @param hour 小时
     * @param minute 分钟
     * @param second 秒
     * @param milliSecond 毫秒
     */
    public void set(int year, int month, int day, int hour, int minute, int second, int milliSecond) {
        set(year, month, day, hour, minute, second);
        set(DateTime.MILLISECOND_FIELD, milliSecond);
    }

    /**
     * 对field值进行相加 <p>add() 的功能很强大,add 能够对 DateTime 的字段进行计算。<br>
     * 假设须要减去值,那么使用负数值就能够了。如 add(field, -value)。<br>
     * 或者调用DateTime.reduce(int,int)进行日期相减</p>
     *
     * @param field int 取值为:<br>   DateTime.YEAR_FIELD -- 年份<br>
     *   DateTime.MONTH_FIELD -- 月份,一月份从1開始<br>
     *   DateTime.DAY_FIELD -- 当前的天(本月中的)<br>
     *   DateTime.HOUR_FIELD -- 小时数(本天中的),24小时制<br>
     *   DateTime.MINUTE_FIELD -- 分钟数(本小时中的)<br>
     *   DateTime.SECOND_FIELD -- 秒数(本分钟中的)<br>
     *   DateTime.MILLISECOND_FIELD -- 毫秒数(本秒中的)
     * @param amount 数量(假设数量小于0则为相减)
     */
    public void add(int field, int amount) {
        c.add(field, amount);
    }

    /**
     * 对field值进行相减 <p>对add() 的功能进行封装,add 能够对 Calendar 的字段进行计算。

<br> * 假设须要减去值,那么使用负数值就能够了,如 add(field, -value)。

<br> * 具体使用方法參见Calendar.add(int,int)</p> * * @param field int 取值为:<br>   DateTime.YEAR_FIELD -- 年份<br> *   DateTime.MONTH_FIELD -- 月份,一月份从1開始<br> *   DateTime.DAY_FIELD -- 当前的天(本月中的)<br> *   DateTime.HOUR_FIELD -- 小时数(本天中的),24小时制<br> *   DateTime.MINUTE_FIELD -- 分钟数(本小时中的)<br> *   DateTime.SECOND_FIELD -- 秒数(本分钟中的)<br> *   DateTime.MILLISECOND_FIELD -- 毫秒数(本秒中的) * @param amount 数量(假设数量小于0则为相加) */ public void reduce(int field, int amount) { c.add(field, -amount); } /** * 推断此 DateTime 表示的时间是否在指定 Object 表示的时间之后,返回推断结果。

<p>此方法等效于:compareTo(when) * > 0<br> 当且仅当 when 是一个 DateTime 实例时才返回 true。否则该方法返回 false。 * * @param when 要比較的 Object * @return 假设此 DateTime 的时间在 when 表示的时间之后。则返回 true。否则返回 false。 */ public boolean after(Object when) { if (when instanceof DateTime) { return c.after(((DateTime) when).c); } return c.after(when); } /** * 推断此 DateTime 表示的时间是否在指定 Object 表示的时间之前,返回推断结果。 <p>此方法等效于:compareTo(when) * < 0<br> 当且仅当 when 是一个 DateTime 实例时才返回 true。否则该方法返回 false。

</p> * * @param when 要比較的 Object * @return 假设此 Calendar 的时间在 when 表示的时间之前。则返回 true;否则返回 false。

*/ public boolean before(Object when) { if (when instanceof DateTime) { return c.before(((DateTime) when).c); } return c.before(when); } /** * 创建并返回此对象的一个副本 * * @return 日期时间对象 */ @Override public Object clone() { return new DateTime((Calendar) c.clone()); } /** * 返回该此日历的哈希码 * * @return 此对象的哈希码值。

* @see Object */ @Override public int hashCode() { return c.hashCode(); } /** * 将此 DateTime 与指定 Object 比較。 * * @param obj - 要与之比較的对象。 * @return 假设此对象等于 obj。则返回 true;否则返回 false。 * @see Object */ @Override public boolean equals(Object obj) { if (obj instanceof DateTime) { return c.equals(((DateTime) obj).toCalendar()); } if (obj instanceof Calendar) { return c.equals(obj); } if (obj instanceof java.util.Date) { return c.getTime().equals(obj); } return false; } }

接下来再来看看怎样使用:

获取当前系统时间:DateTime.now(); 返回的是一个DateTime对象。

一个DateTime对象能够转换成我们须要的各种日期格式,

比如:java.util.date 

DateTime.now().toDate();
大家可能也认为这个写法还没有直接new Date();来得快对不正确。

那么有非常多情况是一个字符串,须要转换成java.util.Date对象,我们该怎么做呢?

<pre name="code" class="java">new DateTime("2014-10-29").toDate();

当然也能够是这种

new DateTime("2014-10-29 15:19:23").toDate();
这里的仅仅是基础使用方法,另一些情况是将java.util.Date转换成字符串格式的

可能大家通常会用SimpleDateFormat,可是这个太费事了。我们看看简单的办法。

new DateTime(new Date()).toDateString();
返回的是 2014-10-29 这样的格式的字符串

new DateTime(new Date()).toDateTimeString();
返回的是2014-10-29 15:23:23 这样的格式的字符串

假设我们须要类似 2014年10月29日 或 2014年10月29日 15时23分34秒 这样的格式的怎么办呢

new DateTime(new Date()).toDateTimeString("yyyy年MM月dd日");
new DateTime(new Date()).toDateTimeString("yyyy年MM月dd日 hh时mm分ss秒");
这样就能够了。

还有非常多其它的函数。我这里就不一一举例了,假设大家认为还不错,就也请大家支持一下,留个评论,或转介绍给其它好友,让很多其它人知道。

我写文章的动力。来源于你们的支持,你们的訪问量!

感谢大家看完本文,谢谢!







为大家提供一个好的时间工具类DateTime