Field Detail

• public static final String dateFmt

  时间格式:yyyy-MM-dd

• public static final String datetimeFmt

  时间格式:yyyy-MM-dd HH:mm

• public static final String monthFmt

  时间格式:yyyy-MM

• public static final String msOfficeDatetimeFmt

  时间格式:yyyy-MM-dd'T'HH:mm:ss

• public static final String timeFmt

  时间格式:HH:mm

Method Detail

• static Date convertSqlDate(Object date)

  将对象转换成日期类型，主要用于转换sql返回的日期类型

  Parameters:

  date

  Returns:

• static int daysBetween(Date startDate, Date endDate)

  计算两个日期之间的天数

  Parameters:

  startdate - 开始日期（含）

  enddate - 结束日期（不含）

  Returns:

  相差的天数

• static Date firstDayOfWeek(Date day, Integer weekOffset = 0, int firstDay = Calendar.MONDAY )

  根据日期，获得周的第一天（默认为周一）的日期

  Parameters:

  day - 要计算的日期

  weekOffset - 周的偏差，比如 -1 为上周一，2为下下周一

  firstDay - 周的第一天，默认为 Calendar.MONDAY

  Returns:

  周一0点

• static String format(Date date, String format, String defaultVal = "")

  按照自定义个格式格式化日期。

  如果日期或格式为空，则返回defaultVal，默认为空字符串。

  Parameters:

  date - 需要格式化的日期

  format - 格式化的形式，如"yyyy-MM-dd"

  defaultVal

• static String formatDate(Date day)

  格式化日期

  Parameters:

  day - 需要格式化的日期

  Returns:

  格式化后的日期字符串（yyyy-MM-dd）

• static String formatDatetime(Date datetime)

  格式化时间

  Parameters:

  datetime - 需要格式化的时间

  Returns:

  格式化后的时间字符串（yyyy-MM-dd HH:mm）

• static String formatMSOfficeDatetime(Date datetime)

  格式化时间（微软Office）

  Parameters:

  datetime - 需要格式化的时间

  Returns:

  格式化后的时间字符串（yyyy-MM-dd'T'HH:mm:ss）

• static String formatMonth(Date month)

  格式化月份

  Parameters:

  month - 需要格式化的月份

  Returns:

  格式化后的月份字符串（yyyy-MM）

• static String formatTime(Date datetime)

  格式化时间

  Parameters:

  datetime - 需要格式化的时间

  Returns:

  格式化后的时间字符串（HH:mm）

• static Map getWeekInfo(Date date = null)

  获得日期所对应该年的周信息

  Parameters:

  date - 日期，默认取当前日期

  Returns:

  [year:年份，week：第几周，startDate：本周的开始日期，endDate：本周的结束日期]

• static int hoursBetween(Date startDate, Date endDate)

  计算两个日期之间的小时数

  Parameters:

  startdate - 开始日期（含）

  enddate - 结束日期（不含）

  Returns:

  相差的小时数

• static boolean inMonth(Date day, Date month)

  判断日期是否在某个月份之中

  Parameters:

  day - 需要判断的日期

  month - 月份

  Returns:

  true/false

• static Date lastDayOfWeek(Date day, Integer weekOffset = 0, int firstDay = Calendar.MONDAY )

  根据日期，获得周的最后一天（默认为周日）的日期

  Parameters:

  day - 要计算的日期

  weekOffset - 周的偏差，比如 -1 为上周日，2为下下周日

  firstDay - 周的第一天，默认为 Calendar.MONDAY

  Returns:

  周日0点

• static int monthesBetween(Date startDate, Date endDate)

  计算两个日期间的月数

  Parameters:

  startdate - 开始日期

  enddate - 结束日期

  Returns:

  相差的月数

• static Date nextMonth(Date month, Boolean keepEndOfMonth = false )

  根据月份取下个月

  Parameters:

  month - 月份

  keepEndOfMonth - 返回结果不超过下个月的月底。如3月31日的nextMonth为4月30日，否则为5月1日。默认为否。

  Returns:

  下个月的一日

• static Date nextYear(Date year, Boolean keepEndOfMonth = false )

  根据年度取下一年

  Parameters:

  year - 年度

  keepEndOfMonth - 返回结果不超过下年同月的月底。如14年3月31日的nextYear为15年4月30日，否则为5月1日。默认为否。

  Returns:

  下一年的一月一日

• static Date parse(String date, String format, Date defaultVal = null)

  按照自定义格式解析日期字符串。

  如果字符串或格式为空，或者解析失败，则返回defaultVal，默认为null。

  Parameters:

  date - 日期字符串

  format - 日期格式，如"yyyy-MM-dd"

  defaultVal

• static Date parse(String date)

  解析字符串为日期

  Parameters:

  date - 需要解析的字符串

  Returns:

  解析后的日期

• @Deprecated static Date parseDate(String date)

  同 parse(String Date)

• static Date preMonth(Date month, Boolean keepEndOfMonth = false )

  根据月份取上个月

  Parameters:

  month - 月份

  keepEndOfMonth - 返回结果不超过上个月的月底。如3月31日的preMonth为2月28或29日，否则为3月2日。默认为否。

  Returns:

  上个月

• static Date toDay(Date datetime)

  将时间的精度转换为日期（小时、分钟、秒等都设为0）

  Parameters:

  datetime - 需要转换的时间

  Returns:

  转换后的日期

• static Date toMonday(Date datetime)

  将时间转换为精度为日期的周一

  Parameters:

  datetime - 需要转换的时间

  Returns:

  转换后的日期

• static Date toMonth(Date datetime)

  将时间转换为月份（精度）

  Parameters:

  datetime - 需要转换的时间

  Returns:

  转换后的月份

• static javax.xml.datatype.XMLGregorianCalendar toXMLGregorianCalendar(Date date)

  转换成 XMLGregorianCalendar 类型。常用于 WebService Client。

  throws:

  Exception

• static Date toYear(Date datetime)

  将时间转换为年份（精度）

  Parameters:

  datetime - 需要转换的时间

  Returns:

  转换后的年份的1月1日0时

• static Date today()

  今天