import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
/**
* <pre>
* author: Blankj
* blog : http://blankj.com
* time : 2016/8/2
* desc : 时间相关的工具类
* </pre>
*/
public class TimeUtils {
private TimeUtils() {
throw new UnsupportedOperationException("u can't fuck me...");
}
/**
* <p>在工具类中经常使用到工具类的格式化描述，这个主要是一个日期的操作类，所以日志格式主要使用 SimpleDateFormat的定义格式.</p>
* 格式的意义如下： 日期和时间模式 <br>
* <p>日期和时间格式由日期和时间模式字符串指定。在日期和时间模式字符串中，未加引号的字母 'A' 到 'Z' 和 'a' 到 'z'
* 被解释为模式字母，用来表示日期或时间字符串元素。文本可以使用单引号 (') 引起来，以免进行解释。"''"
* 表示单引号。所有其他字符均不解释；只是在格式化时将它们简单复制到输出字符串，或者在分析时与输入字符串进行匹配。
* </p>
* 定义了以下模式字母（所有其他字符 'A' 到 'Z' 和 'a' 到 'z' 都被保留）： <br>
* <table border="1" cellspacing="1" cellpadding="1" summary="Chart shows pattern letters, date/time component, presentation, and examples.">
* <tr bgcolor="#ccccff">
* <th align="left">字母</th>
* <th align="left">日期或时间元素</th>
* <th align="left">表示</th>
* <th align="left">示例</th>
* </tr>
* <tr>
* <td><code>G</code></td>
* <td>Era 标志符</td>
* <td>Text</td>
* <td><code>AD</code></td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>y</code> </td>
* <td>年 </td>
* <td>Year </td>
* <td><code>1996</code>; <code>96</code> </td>
* </tr>
* <tr>
* <td><code>M</code> </td>
* <td>年中的月份 </td>
* <td>Month </td>
* <td><code>July</code>; <code>Jul</code>; <code>07</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>w</code> </td>
* <td>年中的周数 </td>
* <td>Number </td>
* <td><code>27</code> </td>
* </tr>
* <tr>
* <td><code>W</code> </td>
* <td>月份中的周数 </td>
* <td>Number </td>
* <td><code>2</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>D</code> </td>
* <td>年中的天数 </td>
* <td>Number </td>
* <td><code>189</code> </td>
* </tr>
* <tr>
* <td><code>d</code> </td>
* <td>月份中的天数 </td>
* <td>Number </td>
* <td><code>10</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>F</code> </td>
* <td>月份中的星期 </td>
* <td>Number </td>
* <td><code>2</code> </td>
* </tr>
* <tr>
* <td><code>E</code> </td>
* <td>星期中的天数 </td>
* <td>Text </td>
* <td><code>Tuesday</code>; <code>Tue</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>a</code> </td>
* <td>Am/pm 标记 </td>
* <td>Text </td>
* <td><code>PM</code> </td>
* </tr>
* <tr>
* <td><code>H</code> </td>
* <td>一天中的小时数（0-23） </td>
* <td>Number </td>
* <td><code>0</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>k</code> </td>
* <td>一天中的小时数（1-24） </td>
* <td>Number </td>
* <td><code>24</code> </td>
* </tr>
* <tr>
* <td><code>K</code> </td>
* <td>am/pm 中的小时数（0-11） </td>
* <td>Number </td>
* <td><code>0</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>h</code> </td>
* <td>am/pm 中的小时数（1-12） </td>
* <td>Number </td>
* <td><code>12</code> </td>
* </tr>
* <tr>
* <td><code>m</code> </td>
* <td>小时中的分钟数 </td>
* <td>Number </td>
* <td><code>30</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>s</code> </td>
* <td>分钟中的秒数 </td>
* <td>Number </td>
* <td><code>55</code> </td>
* </tr>
* <tr>
* <td><code>S</code> </td>
* <td>毫秒数 </td>
* <td>Number </td>
* <td><code>978</code> </td>
* </tr>
* <tr bgcolor="#eeeeff">
* <td><code>z</code> </td>
* <td>时区 </td>
* <td>General time zone </td>
* <td><code>Pacific Standard Time</code>; <code>PST</code>; <code>GMT-08:00</code> </td>
* </tr>
* <tr>
* <td><code>Z</code> </td>
* <td>时区 </td>
* <td>RFC 822 time zone </td>
* <td><code>-0800</code> </td>
* </tr>
* </table>
* <pre>
* yyyy-MM-dd 1969-12-31
* yyyy-MM-dd 1970-01-01
* yyyy-MM-dd HH:mm 1969-12-31 16:00
* yyyy-MM-dd HH:mm 1970-01-01 00:00
* yyyy-MM-dd HH:mmZ 1969-12-31 16:00-0800
* yyyy-MM-dd HH:mmZ 1970-01-01 00:00+0000
* yyyy-MM-dd HH:mm:ss.SSSZ 1969-12-31 16:00:00.000-0800
* yyyy-MM-dd HH:mm:ss.SSSZ 1970-01-01 00:00:00.000+0000
* yyyy-MM-dd'T'HH:mm:ss.SSSZ 1969-12-31T16:00:00.000-0800
* yyyy-MM-dd'T'HH:mm:ss.SSSZ 1970-01-01T00:00:00.000+0000
* </pre>
*/
public static final SimpleDateFormat DEFAULT_SDF = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
/**
* 各时间单位与毫秒的倍数
*/
public static final int UNIT_MSEC = 1;
public static final int UNIT_SEC = 1000;
public static final int UNIT_MIN = 60000;
public static final int UNIT_HOUR = 3600000;
public static final int UNIT_DAY = 86400000;
/**
* 将时间戳转为时间字符串
* <p>格式为yyyy-MM-dd HH:mm:ss</p>
*
* @param milliseconds 毫秒时间戳
* @return 时间字符串
*/
public static String milliseconds2String(long milliseconds) {
return milliseconds2String(milliseconds, DEFAULT_SDF);
}
/**
* 将时间戳转为时间字符串
* <p>格式为用户自定义</p>
*
* @param milliseconds 毫秒时间戳
* @param format 时间格式
* @return 时间字符串
*/
public static String milliseconds2String(long milliseconds, SimpleDateFormat format) {
return format.format(new Date(milliseconds));
}
/**
* 将时间字符串转为时间戳
* <p>格式为yyyy-MM-dd HH:mm:ss</p>
*
* @param time 时间字符串
* @return 毫秒时间戳
*/
public static long string2Milliseconds(String time) {
return string2Milliseconds(time, DEFAULT_SDF);
}
/**
* 将时间字符串转为时间戳
* <p>格式为用户自定义</p>
*
* @param time 时间字符串
* @param format 时间格式
* @return 毫秒时间戳
*/
public static long string2Milliseconds(String time, SimpleDateFormat format) {
try {
return format.parse(time).getTime();
} catch (ParseException e) {
e.printStackTrace();
}
return -1;
}
/**
* 将时间字符串转为Date类型
* <p>格式为yyyy-MM-dd HH:mm:ss</p>
*
* @param time 时间字符串
* @return Date类型
*/
public static Date string2Date(String time) {
return string2Date(time, DEFAULT_SDF);
}
/**
* 将时间字符串转为Date类型
* <p>格式为用户自定义</p>
*
* @param time 时间字符串
* @param format 时间格式
* @return Date类型
*/
public static Date string2Date(String time, SimpleDateFormat format) {
return new Date(string2Milliseconds(time, format));
}
/**
* 将Date类型转为时间字符串
* <p>格式为yyyy-MM-dd HH:mm:ss</p>
*
* @param time Date类型时间
* @return 时间字符串
*/
public static String date2String(Date time) {
return date2String(time, DEFAULT_SDF);
}
/**
* 将Date类型转为时间字符串
* <p>格式为用户自定义</p>
*
* @param time Date类型时间
* @param format 时间格式
* @return 时间字符串
*/
public static String date2String(Date time, SimpleDateFormat format) {
return format.format(time);
}
/**
* 将Date类型转为时间戳
*
* @param time Date类型时间
* @return 毫秒时间戳
*/
public static long date2Milliseconds(Date time) {
return time.getTime();
}
/**
* 将时间戳转为Date类型
*
* @param milliseconds 毫秒时间戳
* @return Date类型时间
*/
public static Date milliseconds2Date(long milliseconds) {
return new Date(milliseconds);
}
/**
* 毫秒时间戳单位转换（单位：unit）
*
* @param milliseconds 毫秒时间戳
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @return unit时间戳
*/
private static long milliseconds2Unit(long milliseconds, int unit) {
switch (unit) {
case UNIT_MSEC:
case UNIT_SEC:
case UNIT_MIN:
case UNIT_HOUR:
case UNIT_DAY:
return Math.abs(milliseconds) / unit;
}
return -1;
}
/**
* 获取两个时间差（单位：unit）
* <p>time1和time2格式都为yyyy-MM-dd HH:mm:ss</p>
*
* @param time1 时间字符串1
* @param time2 时间字符串2
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @return unit时间戳
*/
public static long getIntervalTime(String time1, String time2, int unit) {
return getIntervalTime(time1, time2, unit, DEFAULT_SDF);
}
/**
* 获取两个时间差（单位：unit）
* <p>time1和time2格式都为format</p>
*
* @param time1 时间字符串1
* @param time2 时间字符串2
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @param format 时间格式
* @return unit时间戳
*/
public static long getIntervalTime(String time1, String time2, int unit, SimpleDateFormat format) {
return milliseconds2Unit(string2Milliseconds(time1, format)
- string2Milliseconds(time2, format), unit);
}
/**
* 获取两个时间差（单位：unit）
* <p>time1和time2都为Date类型</p>
*
* @param time1 Date类型时间1
* @param time2 Date类型时间2
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @return unit时间戳
*/
public static long getIntervalTime(Date time1, Date time2, int unit) {
return milliseconds2Unit(date2Milliseconds(time2) - date2Milliseconds(time1), unit);
}
/**
* 获取当前时间
*
* @return 毫秒时间戳
*/
public static long getCurTimeMills() {
return System.currentTimeMillis();
}
/**
* 获取当前时间
* <p>格式为yyyy-MM-dd HH:mm:ss</p>
*
* @return 时间字符串
*/
public static String getCurTimeString() {
return milliseconds2String(getCurTimeMills());
}
/**
* 获取当前时间
* <p>格式为用户自定义</p>
*
* @param format 时间格式
* @return 时间字符串
*/
public static String getCurTimeString(SimpleDateFormat format) {
return milliseconds2String(getCurTimeMills(), format);
}
/**
* 获取当前时间
* <p>Date类型</p>
*
* @return Date类型时间
*/
public static Date getCurTimeDate() {
return new Date();
}
/**
* 获取与当前时间的差（单位：unit）
* <p>time格式为yyyy-MM-dd HH:mm:ss</p>
*
* @param time 时间字符串
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @return unit时间戳
*/
public static long getIntervalByNow(String time, int unit) {
return getIntervalByNow(time, unit, DEFAULT_SDF);
}
/**
* 获取与当前时间的差（单位：unit）
* <p>time格式为format</p>
*
* @param time 时间字符串
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @param format 时间格式
* @return unit时间戳
*/
public static long getIntervalByNow(String time, int unit, SimpleDateFormat format) {
return getIntervalTime(getCurTimeString(), time, unit, format);
}
/**
* 获取与当前时间的差（单位：unit）
* <p>time为Date类型</p>
*
* @param time Date类型时间
* @param unit <ul>
* <li>UNIT_MSEC:毫秒</li>
* <li>UNIT_SEC :秒</li>
* <li>UNIT_MIN :分</li>
* <li>UNIT_HOUR:小时</li>
* <li>UNIT_DAY :天</li>
* </ul>
* @return unit时间戳
*/
public static long getIntervalByNow(Date time, int unit) {
return getIntervalTime(getCurTimeDate(), time, unit);
}
/**
* 判断闰年
*
* @param year 年份
* @return true: 闰年<br>false: 平年
*/
public static boolean isLeapYear(int year) {
return year % 4 == 0 && year % 100 != 0 || year % 400 == 0;
}
}