com.github.javaclub.sword.util.DateUtil Maven / Gradle / Ivy
/*
* @(#)TimeHelper.java 2009-2-19
*
* Copyright (c) 2009 by gerald. All Rights Reserved.
*/
package com.github.javaclub.sword.util;
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.TimeZone;
import com.github.javaclub.sword.core.Numbers;
import com.github.javaclub.sword.core.Strings;
import com.github.javaclub.sword.domain.dto.range.DateTimeRange;
import com.github.javaclub.sword.domain.dto.range.StringDateRange;
/**
* A utilities class for processing datetime
*
* @author Gerald Chen
* @version $Id: DateUtil.java 56 2011-06-27 02:11:24Z [email protected] $
*/
public final class DateUtil {
public static final String DATE_SEPARATOR = "-";
public static final String TIME_SEPARATOR = ":";
public static final String DATE_TIME_SEPARATOR = " ";
public static final String DATE_FORMAT_STR = "yyyy-MM-dd";
public static final String TIME_FORMAT_STR = "HH:mm:ss";
public static final String TIMESTAMP_STR = "yyyy-MM-dd HH:mm:ss";
public static final String MSEL_FORMAT_STR_1 = "yyyy-MM-dd HH:mm:ss,SSS";
public static final String MSEL_FORMAT_STR_2 = "yyyy-MM-dd HH:mm:ss.SSS";
public static final String DATE_TIME_FORMAT_3 = "yyyy-MM-dd'T'HH:mm:ss.SSSZ"; // 格式型如：2014-01-02T13:00:51.000+0800
public static final int DATE_FORMAT_STR_LENGTH = 10; // (yyyy-MM-dd) 10
public static final int TIMESTAMP_STR_LENGTH = 19; // (yyyy-MM-dd HH:mm:ss) 19
public static final int MSEL_FORMAT_STR_LENGTH = 23; // (yyyy-MM-dd HH:mm:ss,SSS) 23
public static final int NUMERIC_TIMESTAMP_STR_LENGTH = 14; // (yyyyMMddHHmmss) 14
public static final long MILLIS_IN_ONE_MIN = 60000;// 1000 * 60
public static final long MILLIS_IN_ONE_HOUR = 3600000;// MILLIS_IN_ONE_MIN * 60
public static final long MILLIS_IN_ONE_DAY = 86400000;// MILLIS_IN_ONE_HOUR * 24
/** 日期/时间的各个部分标识：年（1） */
public final static int YEAR = 1;
/** 日期/时间的各个部分标识：月（2） */
public final static int MONTH = 2;
/** 日期/时间的各个部分标识：日（3） */
public final static int DAY = 3;
/** 日期/时间的各个部分标识：时（4） */
public final static int HOUR = 4;
/** 日期/时间的各个部分标识：分（5） */
public final static int MINUTE = 5;
/** 日期/时间的各个部分标识：秒（6） */
public final static int SECOND = 6;
/** 日期/时间的各个部分标识：毫秒（7） */
public final static int MILLISECOND = 7;
/** 日期/时间的各个部分标识：一刻钟（11） */
public final static int QUATER = 11;
/** 日期/时间的各个部分标识：一周（12） */
public final static int WEEK = 12;
/** 当月天数（13） */
public final static int DAYS_OF_MONTH = 13;
/** 当月周数（14） */
public final static int WEEKS_OF_MONTH = 14;
/** 当年天数（15） */
public final static int DAYS_OF_YEAR = 15;
/** 当年周数（16） */
public final static int WEEKS_OF_YEAR = 16;
/** The days in months of a year, which is not a leap year */
public static final int[] DAYS = { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 };
public static enum Duration {
SECOND(1L), MINUTE(60L), QUATER(15L * MINUTE.getSeconds()), HOUR(60L * MINUTE.getSeconds()),
DAY(24L * HOUR.getSeconds()), WEEK(7L * DAY.getSeconds()), MONTH(31L * DAY.getSeconds()),
YEAR(52L * WEEK.getSeconds());
private final long seconds;
public long getSeconds() {
return this.seconds;
}
public long getMilliseconds() {
return 1000L * getSeconds();
}
private Duration(long seconds) {
this.seconds = seconds;
}
}
/**
* Converts a java.sql.Date to java.util.Date
*
* In fact, this method is unnecessary because java.sql.Date extends from java.util.Date
*
* @param date a java.sql.Date
* @return a java.util.Date
*/
public static java.util.Date toDate(java.sql.Date date) {
return new java.util.Date(date.getTime());
}
/**
* Converts a java.sql.Timestamp to java.util.Date
*
* In fact, this method is unnecessary because java.sql.Timestamp extends from java.util.Date
*
* @param timestamp a java.sql.Timestamp
* @return a java.util.Date
*/
public static java.util.Date toDate(java.sql.Timestamp timestamp) {
return new java.util.Date(timestamp.getTime());
}
/**
* parse string of format to java.util.Date.
*
* 'yyyy-MM-dd'、'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd HH:mm:ss,SSS' is supported.
*
* @param obj the input.
* @return a java.util.Date
*/
public static java.util.Date toDate(Object obj) {
if(obj == null) {
return null;
}
if (obj instanceof java.util.Date || obj instanceof java.sql.Date
|| obj instanceof java.sql.Timestamp) {
return (java.util.Date) obj;
}
if (obj instanceof String) {
return toDate(obj.toString());
}
throw new RuntimeException("the parameter [" + obj + " can't be converted to java.util.Date");
}
/**
* parse string of format to java.util.Date.
*
* 'yyyy-MM-dd'、'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd HH:mm:ss,SSS' is supported.
*
* @param input the input string.
* @return a java.util.Date
*/
public static java.util.Date toDate(String input) {
if(Strings.isBlank(input)) {
return null;
}
String dealStr = input.trim();
// if the first character is '''
int pos = dealStr.indexOf("'");
if (pos == 0) {
dealStr = dealStr.substring(1, dealStr.length());
}
// if the last character is '''
pos = dealStr.lastIndexOf("'");
if (pos == dealStr.length() - 1) {
dealStr = dealStr.substring(0, dealStr.length() - 1);
}
int length = dealStr.length();
SimpleDateFormat sdf = null;
if(4 < length &&length < DATE_FORMAT_STR_LENGTH && dealStr.charAt(4) == '-') {
String[] array = Strings.split(dealStr, "-");
if(null == array || 3 != array.length) {
return null;
}
if(!Numbers.areNumeric(array)) {
return null;
}
StringBuffer sbf = new StringBuffer(array[0]).append("-");
sbf.append(array[1].length()==1 ? ("0" + array[1]) : array[1]).append("-");
sbf.append(array[2].length()==1 ? ("0" + array[2]) : array[2]);
sdf = new SimpleDateFormat("yyyy-MM-dd");
dealStr = sbf.toString();
} else if (length == DATE_FORMAT_STR_LENGTH && dealStr.charAt(4) == '-' && dealStr.charAt(7) == '-') {
sdf = new SimpleDateFormat("yyyy-MM-dd");
} else if (length == TIMESTAMP_STR_LENGTH && dealStr.charAt(4) == '-' && dealStr.charAt(7) == '-'
&& dealStr.charAt(10) == ' ' && dealStr.charAt(13) == ':' && dealStr.charAt(16) == ':') {
sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
} else if (length == MSEL_FORMAT_STR_LENGTH && dealStr.charAt(4) == '-' && dealStr.charAt(7) == '-'
&& dealStr.charAt(10) == ' ' && dealStr.charAt(13) == ':' && dealStr.charAt(16) == ':'
&& (dealStr.charAt(19) == ',' || dealStr.charAt(19) == '.')) {
sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss,SSS");
if (dealStr.charAt(19) == '.') {
sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS");
}
} else if (length == NUMERIC_TIMESTAMP_STR_LENGTH && !dealStr.contains(" ") && !dealStr.contains(":")
&& Strings.isNumeric(dealStr)) {
sdf = new SimpleDateFormat("yyyyMMddHHmmss");
}
if (null == sdf) {
throw new IllegalArgumentException("The format of [" + input + "] is not supported.");
}
try {
return sdf.parse(dealStr);
} catch (ParseException e) {
System.err.println("Error occured when parsing String [" + input + "] to java.util.Date with the format [" + sdf.toPattern() + "].");
}
return null;
}
/**
* parse a java.util.Date by the given date string and format pattern
*
* @param date the given date string
* @param pattern the given format pattern
* @return a java.util.Date
*/
public static java.util.Date toDate(String date, String pattern) {
try {
return new SimpleDateFormat(pattern).parse(date);
} catch (ParseException e) {
}
return null;
}
/**
* 将Date类型的字符串从一种格式转换到另一种格式
*
* @param datestr Date类型的字符串
* @param fromPattern 原始的format
* @param toPattern 最终要转换的format
* @return
*/
public static String toFormat(String datestr, String fromPattern, String toPattern) {
if(Strings.isBlank(datestr)) {
return null;
}
Date date = toDate(datestr, fromPattern);
if(null == date) {
return null;
}
return getFormat(date, toPattern);
}
/**
* Converts a java.util.Date to java.sql.Date
*
* @param date a java.util.Date
* @return a java.sql.Date
*/
public static java.sql.Date toSqlDate(java.util.Date date) {
return new java.sql.Date(date.getTime());
}
/**
* Converts a java.lang.Object to java.sql.Date
*
* @param obj a java.lang.Object
* @return a java.sql.Date
*/
public static java.sql.Date toSqlDate(Object obj) {
if(obj == null) {
return null;
}
if (obj instanceof java.sql.Date) {
return (java.sql.Date) obj;
}
Date date = toDate(obj);
return new java.sql.Date(date.getTime());
}
/**
* Converts a java.util.Date to java.sql.Timestamp
*
* @param date a java.util.Date
* @return a java.sql.Timestamp
*/
public static java.sql.Timestamp toTimestamp(java.util.Date date) {
return new java.sql.Timestamp(date.getTime());
}
/**
* Converts a java.lang.Object to java.sql.Timestamp
*
* @param obj a java.lang.Object
* @return a java.sql.Timestamp
*/
public static java.sql.Timestamp toTimestamp(Object obj) {
if(obj == null) {
return null;
}
if (obj instanceof java.sql.Timestamp) {
return (java.sql.Timestamp) obj;
}
Date date = toDate(obj);
return new java.sql.Timestamp(date.getTime());
}
public static java.sql.Time toTime(Object obj) {
if(obj == null) {
return null;
}
if (obj instanceof java.sql.Time) {
return (java.sql.Time) obj;
} else if (obj instanceof java.sql.Timestamp) {
return new java.sql.Time(((java.sql.Timestamp) obj).getTime());
} else if (obj instanceof java.sql.Date) {
return new java.sql.Time(((java.sql.Timestamp) obj).getTime());
} else if(obj instanceof java.util.Date) {
return new java.sql.Time(((java.util.Date) obj).getTime());
} else if(obj instanceof String) {
return java.sql.Time.valueOf(obj.toString());
} else {
throw new IllegalArgumentException("the parameter {@obj[" + obj + "]} is a bad Argument, which can't be converted to java.sql.Time.");
}
}
/**
* Returns the current datetime.
*
* @return the current datetime.
*/
public static Date now() {
return new Date(System.currentTimeMillis());
}
/**
* Returns the current identity like '20090831182858668'
*
* @return
*/
public static String nowIdentity() {
return getFormat(now(), "yyyyMMddHHmmssSSS");
}
/**
* getting a date string like 'yyyy-MM-dd' from a java.util.Date or java.sql.Date
*
* @param date a java.util.Date or java.sql.Date
* @return a string like 'yyyy-MM-dd'
*/
public static String getDateFormat(java.util.Date date) {
return getFormat(date, DATE_FORMAT_STR);
}
/**
* 从java.util.Date得到时间串"HH:mm:ss"
*
* @param date 日期参数，类型可以是java.util.Date或java.sql.Date
* @return
*/
public static String getTimeFormat(java.util.Date date) {
return getFormat(date, TIME_FORMAT_STR);
}
/**
* 从java.util.Date得到时间戳"yyyy-MM-dd HH:mm:ss"
*
* @param date 日期参数，类型可以是java.util.Date或java.sql.Date
* @return
*/
public static String getTimestampFormat(java.util.Date date) {
return getFormat(date, TIMESTAMP_STR);
}
/**
* gets current time's string format like "yyyy-MM-dd"
*
* @return
*/
public static String currentDate() {
return getDateFormat(now());
}
/**
* gets current time's string format like "HH:mm:ss"
*
* @return
*/
public static String currentTime() {
return getTimeFormat(now());
}
/**
* gets current time's string format like "yyyy-MM-dd HH:mm:ss"
*
* @return
*/
public static String currentTimestamp() {
return getTimestampFormat(now());
}
/**
* gets current time's string format like "yyyy-MM-dd HH:mm:ss,SSS"
*
* @return
*/
public static String currentMselFormat() {
return getFormat(now(), "yyyy-MM-dd HH:mm:ss,SSS");
}
/**
* 取得java.util.Date类型日期的格式化串，格式化格式为parseFormat
*
* @param date 日期参数，类型可以是java.util.Date或java.sql.Date
* @param parseFormat 日期格式化串
* @return 当date为null时，返回null;当parseFormat为null时，默认返回date.toString()
*/
public static String getFormat(java.util.Date date, String parseFormat) {
if (null == date) {
return null;
}
if (null == parseFormat || "".equalsIgnoreCase(parseFormat)) {
return date.toString();
}
return new SimpleDateFormat(parseFormat).format(date);
}
/**
* 计算两个任意时间中间的间隔天数
*
* @param startday 起始时间
* @param endday 结束时间
* @return
*/
public static long getIntervalDays(Calendar startday, Calendar endday) {
if (startday.after(endday)) {
Calendar cal = startday;
startday = endday;
endday = cal;
}
long sl = startday.getTimeInMillis();
long el = endday.getTimeInMillis();
long cl = el - sl;
return (cl / (1000 * 60 * 60 * 24));
}
/**
* 计算两个任意时间中间的间隔天数
*
* @param startday 起始时间
* @param endday 结束时间
* @return
*/
public static long getIntervalDays(java.util.Date startday, java.util.Date endday) {
if (startday.after(endday)) {
java.util.Date cal = startday;
startday = endday;
endday = cal;
}
long sl = startday.getTime();
long el = endday.getTime();
long cl = el - sl;
return (cl / (1000 * 60 * 60 * 24));
}
/**
* 判断指定年份是否为闰年
*
* @param year 需要被判断的年份
* @return true or false
*/
public static boolean isLeapYear(int year) {
return (year % 4 == 0 && year % 100 != 0) || (year % 400 == 0);
}
public static java.util.Date yesterday() {
return backward(now(), MILLIS_IN_ONE_DAY);
}
public static boolean isTodayTime(Date date) {
String todayDateFormat = DateUtil.currentDate();
String paramDateFormat = DateUtil.getDateFormat(date);
return Strings.equals(todayDateFormat, paramDateFormat);
}
public static boolean isTimeInRange(Date time, Date left, Date right) {
return (null != time && null != left && null != right
&& time.getTime() >= left.getTime()
&& time.getTime() <= right.getTime());
}
public static java.util.Date tomorrow() {
return forward(now(), MILLIS_IN_ONE_DAY);
}
/**
* 从某个具体日期java.util.Date倒退millis毫秒
*
* @param date
* @param millis
* @return
*/
public static java.util.Date backward(java.util.Date date, long millis) {
java.util.Date d = new java.util.Date();
d.setTime(date.getTime() - millis);
return d;
}
/**
* 从某个具体日期java.util.Date向前推进millis毫秒
*
* @param date
* @param millis
* @return
*/
public static java.util.Date forward(java.util.Date date, long millis) {
java.util.Date d = new java.util.Date();
d.setTime(date.getTime() + millis);
return d;
}
/**
* Gets the field of a date.
*
* @param date a date given
* @param field the date field
* @return the field value
* @throws JRuntimeException if the field is invalid.
*/
public static int get(Date date, int field) {
if (date == null) {
throw new RuntimeException("date is null");
}
GregorianCalendar cal = toCalendar(date);
switch (field) {
case YEAR: {
return cal.get(Calendar.YEAR);
}
case MONTH: {
return cal.get(Calendar.MONTH) + 1;
}
case DAY: {
return cal.get(Calendar.DAY_OF_MONTH);
}
case HOUR: {
return cal.get(Calendar.HOUR_OF_DAY);
}
case MINUTE: {
return cal.get(Calendar.MINUTE);
}
case SECOND: {
return cal.get(Calendar.SECOND);
}
case MILLISECOND: {
return cal.get(Calendar.MILLISECOND);
}
case WEEK: {
//REM: cal.setFirstDayOfWeek( Calendar.MONDAY )
// is not used, because it doesn't work!
return (cal.get(Calendar.DAY_OF_WEEK) - Calendar.MONDAY + 7) % 7;
}
case DAYS_OF_MONTH: {
return cal.getActualMaximum(Calendar.DAY_OF_MONTH);
}
case WEEKS_OF_MONTH: {
return cal.getActualMaximum(Calendar.WEEK_OF_MONTH);
}
case DAYS_OF_YEAR: {
return cal.getActualMaximum(Calendar.DAY_OF_YEAR);
}
case WEEKS_OF_YEAR: {
return cal.getActualMaximum(Calendar.WEEK_OF_YEAR);
}
default: {
throw new RuntimeException("invalid date field " + field);
}
}//end case
}
/**
* Adds the specified (signed) amount of time to the given time field, based
* on the calendar's rules.
*
* @param date the datetime value to be added.
* @param field the time field.
* @param amount the amount of date or time to be added to the field.
*/
public static Date add(Date date, int field, int amount) {
Calendar cal = toCalendar(date);
int nCalendarField;
switch (field) {
case YEAR:
nCalendarField = Calendar.YEAR;
break;
case MONTH:
nCalendarField = Calendar.MONTH;
break;
case WEEK:
nCalendarField = Calendar.WEEK_OF_YEAR;
break;
case DAY:
nCalendarField = Calendar.DAY_OF_YEAR;
break;
case HOUR:
nCalendarField = Calendar.HOUR;
break;
case MINUTE:
nCalendarField = Calendar.MINUTE;
break;
case SECOND:
nCalendarField = Calendar.SECOND;
break;
case MILLISECOND:
nCalendarField = Calendar.MILLISECOND;
break;
default:
throw new RuntimeException("invalid date time field: " + field);
}
cal.add(nCalendarField, amount);
return cal.getTime();
}
/**
* 增加n天后的日期时间
* @param date
* @param day
* @return
*/
public static Date plusDay(Date date, int day) {
Date newDate = null;
// 使用默认时区和语言环境获得一个日历
Calendar cal = Calendar.getInstance();
cal.setTime(date);// 设置日历时间
// 设置增加的时间:当day为负数时-为设置时间的前几天，正数则为增加的天数
cal.add(Calendar.DAY_OF_MONTH, day);
newDate = cal.getTime();
return newDate;
}
public static Date plusHour(Date date, int hour) {
return DateUtil.add(date, DateUtil.HOUR, hour);
}
public static Date plusSeconds(Date date, int secs) {
return DateUtil.add(date, DateUtil.SECOND, secs);
}
public static Date plusMillis(Date date, int millis) {
return DateUtil.add(date, DateUtil.MILLISECOND, millis);
}
/**
* 取当前时间，并自定义：时／分／秒／毫秒
*
* @param hour 时(0~23)
* @param minute 分(0~59)
* @param second 秒(0~59)
* @param millisecond 毫秒(0~999)
* @return
*/
public static Date newDate(int hour, int minute, int second, int millisecond) {
Calendar c = Calendar.getInstance();
c.setTime(now());// 设置日历时间
c.set(Calendar.HOUR_OF_DAY, hour);
c.set(Calendar.MINUTE, minute);
c.set(Calendar.SECOND, second);
c.set(Calendar.MILLISECOND, millisecond);
return c.getTime();
}
/**
* Get Calendar instance by specified year, month and day.
*
* @param year 4-digit year.
* @param month Month range is 1-12.
* @param day Day range is 1-?, end depends on year and month.
* @return A Calendar instance.
*/
public static Calendar getCalendar(int year, int month, int day) {
if (year < 2000 || year > 2100)
throw new IllegalArgumentException("Invalid year value => " + year);
if (month < 1 || month > 12)
throw new IllegalArgumentException("Invalid month value => " + month);
if (day < 1)
throw new IllegalArgumentException("Invalid day value => " + day);
if (month == 2 && isLeapYear(year)) {
if (day > 29)
throw new IllegalArgumentException("Invalid day value => " + day + " for month=" + month);
} else {
if (day > DAYS[month - 1])
throw new IllegalArgumentException("Invalid day value => " + day);
}
month--;
Calendar c = Calendar.getInstance();
c.set(Calendar.YEAR, year);
c.set(Calendar.MONTH, month);
c.set(Calendar.DAY_OF_MONTH, day);
c.set(Calendar.HOUR_OF_DAY, 0);
c.set(Calendar.MINUTE, 0);
c.set(Calendar.SECOND, 0);
c.set(Calendar.MILLISECOND, 0);
return c;
}
/**
* Return today's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT).
*/
public static int[] getToday() {
return getDate(Calendar.getInstance());
}
/**
* Return day's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT).
*/
public static int[] getDate(long t) {
Calendar c = Calendar.getInstance();
c.setTimeInMillis(t);
return getDate(c);
}
/**
* Return day's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT).
*/
public static int[] getDate(Calendar c) {
int week = c.get(Calendar.DAY_OF_WEEK) - 1;
if (week == 0)
week = 7;
return new int[] { c.get(Calendar.YEAR), c.get(Calendar.MONTH) + 1, c.get(Calendar.DAY_OF_MONTH), week };
}
/**
* Return day's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT), hour, minute, second.
*/
public static int[] getTime(long t) {
Calendar c = Calendar.getInstance();
c.setTimeInMillis(t);
return getTime(c);
}
/**
* Return day's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT), hour, minute, second.
*
* @param date
* @return
*/
public static int[] getTime(Date date) {
return getTime(date.getTime());
}
/**
* Return day's year, month(1-12), day(1-31), week(0-6, for SUN, MON, ... SAT), hour, minute, second.
*/
public static int[] getTime(Calendar c) {
int week = c.get(Calendar.DAY_OF_WEEK) - 1;
if (week == 0)
week = 7;
return new int[] { c.get(Calendar.YEAR), c.get(Calendar.MONTH) + 1, c.get(Calendar.DAY_OF_MONTH), week,
c.get(Calendar.HOUR_OF_DAY), c.get(Calendar.MINUTE), c.get(Calendar.SECOND) };
}
/**
* 取时间的hour字段
*/
public static int getHourOfDay(Date date) {
return getTime(date)[4];
}
/**
* 得到昨天的年月日值
*
* @param year
* @param month
* @param day
* @return
*/
public static int[] getPreviousDay(int year, int month, int day) {
day--;
if (day < 1) {
month--;
if (month < 1) {
year--;
month = 12;
}
int lastDay = DAYS[month - 1];
if (month == 2 && isLeapYear(year))
lastDay++;
day = lastDay;
}
return new int[] { year, month, day };
}
/**
* 得到明天的年月日值
*
* @param year
* @param month
* @param day
* @return
*/
public static int[] getNextDay(int year, int month, int day) {
day++;
int max = DAYS[month - 1];
if (month == 2 && isLeapYear(year))
max++;
if (day > max) {
day = 1;
month++;
if (month > 12) {
year++;
month = 1;
}
}
return new int[] { year, month, day };
}
/**
* Converts date to calendar.
*
* @param date a date given
* @return the related calendar
*/
public static GregorianCalendar toCalendar(Date date) {
GregorianCalendar cal = new java.util.GregorianCalendar();
cal.setTimeZone(TimeZone.getDefault());
cal.setTime(date);
return cal;
}
/**
* Generates a random java.util.Date between two long data.
*
* @param begin a long type data.
* @param end a long type data, must be greater than begin.
* @return a random java.util.Date
*/
public static java.util.Date randomDate(long begin, long end) {
if (begin >= end) {
throw new IllegalArgumentException("end must greater than begin...");
}
long rtn = begin + (long) (Math.random() * (end - begin));
if (rtn == begin || rtn == end) {
return randomDate(begin, end);
}
return new Date(rtn);
}
/**
* Generates a random java.util.Date between two date format strings.
*
* @param beginDate a date format string.
* @param endDate a date format string.
* @return a random java.util.Date
*/
public static java.util.Date randomDate(String beginDate, String endDate) {
Date begin = toDate(beginDate);
Date end = toDate(endDate);
if (null == begin || null == end || begin.getTime() >= end.getTime()) {
return null;
}
return randomDate(begin.getTime(), end.getTime());
}
/**
* 检查一个时间是否接近于另一个时间。
*
* @param date 要比较的时间
* @param baseDate 基础时间
* @param seconds 秒数
*
* @return 如果 date 在 baseDate前后 seonds 秒数，则返回true，否则返回false。
*/
public static boolean isClosely(Date date, Date baseDate, int seconds) {
long m_time = date.getTime();
long b_time = baseDate.getTime();
long ms = seconds * 1000L;
if (m_time == b_time)
return true;
if (m_time > b_time) { // 现在时间在基础时间之前
return b_time + ms > m_time;
} else if (m_time < b_time) { // 现在时间在基础时间之后
return m_time + ms > b_time;
} else { // 同一个时间
return true;
}
}
/**
* 将使用的毫秒数转化为可读的字符串, 如1天1小时1分1秒.
* assertEquals("1天1小时1分1秒", DateUtil.timeToString(90061000));
* @param msUsed 使用的毫秒数.
* @return 可读的字符串, 如1天1小时1分1秒.
*/
public static String timeSpan(long msUsed) {
if (msUsed < 0) {
return String.valueOf(msUsed);
}
if (msUsed < 1000) {
return String.valueOf(msUsed) + "毫秒";
}
// 长于1秒的过程，毫秒不计
msUsed /= 1000;
if (msUsed < 60) {
return String.valueOf(msUsed) + "秒";
}
if (msUsed < 3600) {
long nMinute = msUsed / 60;
long nSecond = msUsed % 60;
return String.valueOf(nMinute) + "分" + String.valueOf(nSecond)
+ "秒";
}
// 3600 * 24 = 86400
if (msUsed < 86400) {
long nHour = msUsed / 3600;
long nMinute = (msUsed - nHour * 3600) / 60;
long nSecond = (msUsed - nHour * 3600) % 60;
return String.valueOf(nHour) + "小时" + String.valueOf(nMinute) + "分"
+ String.valueOf(nSecond) + "秒";
}
long nDay = msUsed / 86400;
long nHour = (msUsed - nDay * 86400) / 3600;
long nMinute = (msUsed - nDay * 86400 - nHour * 3600) / 60;
long nSecond = (msUsed - nDay * 86400 - nHour * 3600) % 60;
return String.valueOf(nDay) + "天" + String.valueOf(nHour) + "小时"
+ String.valueOf(nMinute) + "分" + String.valueOf(nSecond) + "秒";
}
/**
* 取UNIX时间戳的起始时间，是以1970年1月1日0点为计时起点时间的
*/
public static Date getUnixStartTime() {
String format = "1970-01-01 00:00:00";
return toDate(format);
}
public static Date getFirstDayOfMonth(Date date) {
Calendar calendar = Calendar.getInstance();
calendar.setTime(date);
calendar.set(Calendar.DAY_OF_MONTH, 1); // 第1天
Date firstDate = calendar.getTime();
return getStartTimeOfDate(firstDate);
}
public static Date getLastDayOfMonth(Date date) {
Calendar calendar = Calendar.getInstance();
calendar.setTime(date);
final int lastDay = calendar.getActualMaximum(Calendar.DAY_OF_MONTH);
calendar.set(Calendar.DAY_OF_MONTH, lastDay); // 当月最后一天
Date lastDate = calendar.getTime();
return getEndTimeOfDate(lastDate);
}
public static Date getFirstDayOfCurrentMonth() {
Date now = new Date();
String _1stDay = getDateFormat(getFirstDayOfMonth(now)) + " 00:00:00";
return toDate(_1stDay);
}
public static Date getLastDayOfCurrentMonth() {
Date now = new Date();
String _lastDay = getDateFormat(getLastDayOfMonth(now)) + " 23:59:59";
return toDate(_lastDay);
}
/**
* 取一天24小时制的开始时间，如：2017-08-01 00:00:00
*/
public static Date getStartTimeOfDate(Date date) {
String startTime = getDateFormat(date) + " 00:00:00";
return toDate(startTime);
}
/**
* 取一天24小时制的结束时间，如：2017-08-01 23:59:59
*/
public static Date getEndTimeOfDate(Date date) {
String endTime = getDateFormat(date) + " 23:59:59";
return toDate(endTime);
}
/**
* 判断两个时间范围是否有交集
*/
public static boolean isHaveIntersection(DateTimeRange time1, DateTimeRange time2) {
long point1Start = time1.getStart().getTime();
long point1End = time1.getEnd().getTime();
long point2Start = time2.getStart().getTime();
long point2End = time2.getEnd().getTime();
if(point1Start > point1End) {
long tmp = point1Start;
point1Start = point1End;
point1End = tmp;
}
if((point2Start < point1Start && point2End < point1Start) || (point2Start > point1End && point2End > point1End)) {
return false;
}
return true;
}
/**
* 判断某天是否介与两天之内
*/
public static boolean isBetweenDays(Date date, Date from, Date to) {
if (from == null) return false;
if (to == null) return false;
if (date == null) return false;
long start = from.getTime();
long end = to.getTime();
long target = date.getTime();
if (target >= start && target <= end) {
return true;
}
return false;
}
/**
* 获取当前时间所在自然周的开始和结束日期(自然周起始天按周一计算)
*/
public static StringDateRange getWeeklyStartAndEndDay() {
//获取当前自然周中每天的日期集合
Date date = new Date();
DateFormat format = new SimpleDateFormat("yyyy-MM-dd");
Calendar c = new GregorianCalendar();
c.setFirstDayOfWeek(Calendar.MONDAY); //这里设置一周开始时间是星期一
c.setTime(date);
c.set(Calendar.DAY_OF_WEEK, c.getFirstDayOfWeek()); // Monday
String beginTime = format.format(c.getTime()) + " 00:00:00"; //获取当前自然周的起始时间
c.set(Calendar.DAY_OF_WEEK, c.getFirstDayOfWeek() + 6); // Sunday
String endTime = format.format(c.getTime()) + " 23:59:59"; //当前自然周的截止时间
return new StringDateRange(beginTime, endTime);
}
public static StringDateRange getWeeklyStartUtilNow() {
String nowTime = getTimestampFormat(new Date());
StringDateRange weekly = getWeeklyStartAndEndDay();
return new StringDateRange(weekly.getStart(), nowTime);
}
public static void main(String[] args) {
Date now = new Date(); // N=3;
Date startTime = now;
System.out.println("startTime=" + DateUtil.getTimestampFormat(startTime));
Date endDate = DateUtil.plusDay(startTime, 3-1);
Date endTime = DateUtil.getEndTimeOfDate(endDate);
System.out.println("endTime=" + DateUtil.getTimestampFormat(endTime));
Date time = randomDate("2023-06-05 08:11:23", "2023-06-05 23:11:23");
System.out.println(isTodayTime(time));
System.out.println(getWeeklyStartAndEndDay());
System.out.println(getWeeklyStartUtilNow());
}
}