This commit is contained in:
Looly
2023-02-09 20:49:41 +08:00
parent 719f1c4071
commit a1868f4834
2 changed files with 37 additions and 17 deletions

View File

@@ -134,7 +134,7 @@ public class DateTime extends Date {
/** /**
* 当前时间 * 当前时间
* *
* @param timeZone 时区 * @param timeZone 时区{@code null}表示默认时区
* @since 4.1.2 * @since 4.1.2
*/ */
public DateTime(final TimeZone timeZone) { public DateTime(final TimeZone timeZone) {
@@ -156,8 +156,8 @@ public class DateTime extends Date {
/** /**
* 给定日期的构造 * 给定日期的构造
* *
* @param date 日期 * @param date 日期{@code null}表示当前时间
* @param timeZone 时区 * @param timeZone 时区{@code null}表示默认时区
* @since 4.1.2 * @since 4.1.2
*/ */
public DateTime(final Date date, final TimeZone timeZone) { public DateTime(final Date date, final TimeZone timeZone) {
@@ -167,7 +167,7 @@ public class DateTime extends Date {
/** /**
* 给定日期的构造 * 给定日期的构造
* *
* @param calendar {@link Calendar} * @param calendar {@link Calendar},不能为{@code null}
*/ */
public DateTime(final Calendar calendar) { public DateTime(final Calendar calendar) {
this(calendar.getTime(), calendar.getTimeZone()); this(calendar.getTime(), calendar.getTimeZone());
@@ -177,7 +177,7 @@ public class DateTime extends Date {
/** /**
* 给定日期Instant的构造 * 给定日期Instant的构造
* *
* @param instant {@link Instant} 对象 * @param instant {@link Instant} 对象,不能为{@code null}
* @since 5.0.0 * @since 5.0.0
*/ */
public DateTime(final Instant instant) { public DateTime(final Instant instant) {
@@ -945,6 +945,7 @@ public class DateTime extends Date {
/** /**
* 是否为本月最后一天 * 是否为本月最后一天
*
* @return 是否为本月最后一天 * @return 是否为本月最后一天
* @since 5.8.8 * @since 5.8.8
*/ */
@@ -954,6 +955,7 @@ public class DateTime extends Date {
/** /**
* 获得本月的最后一天 * 获得本月的最后一天
*
* @return 天 * @return 天
* @since 5.8.8 * @since 5.8.8
*/ */

View File

@@ -89,11 +89,14 @@ public class DateUtil extends CalendarUtil {
* {@link Date}类型时间转为{@link DateTime}<br> * {@link Date}类型时间转为{@link DateTime}<br>
* 如果date本身为DateTime对象则返回强转后的对象否则新建一个DateTime对象 * 如果date本身为DateTime对象则返回强转后的对象否则新建一个DateTime对象
* *
* @param date {@link Date} * @param date {@link Date},如果传入{@code null},返回{@code null}
* @return 时间对象 * @return 时间对象
* @since 3.0.7 * @since 3.0.7
*/ */
public static DateTime date(final Date date) { public static DateTime date(final Date date) {
if (date == null) {
return null;
}
if (date instanceof DateTime) { if (date instanceof DateTime) {
return (DateTime) date; return (DateTime) date;
} }
@@ -103,33 +106,42 @@ public class DateUtil extends CalendarUtil {
/** /**
* {@link XMLGregorianCalendar}类型时间转为{@link DateTime} * {@link XMLGregorianCalendar}类型时间转为{@link DateTime}
* *
* @param date {@link XMLGregorianCalendar} * @param date {@link XMLGregorianCalendar},如果传入{@code null},返回{@code null}
* @return 时间对象 * @return 时间对象
* @since 6.0.0 * @since 6.0.0
*/ */
public static DateTime date(final XMLGregorianCalendar date) { public static DateTime date(final XMLGregorianCalendar date) {
if (date == null) {
return null;
}
return date(date.toGregorianCalendar()); return date(date.toGregorianCalendar());
} }
/** /**
* 根据已有{@link Date} 产生新的{@link DateTime}对象 * 根据已有{@link Date} 产生新的{@link DateTime}对象
* *
* @param date Date对象 * @param date Date对象,如果传入{@code null},返回{@code null}
* @return {@link DateTime}对象 * @return {@link DateTime}对象
* @since 4.3.1 * @since 4.3.1
*/ */
public static DateTime dateNew(final Date date) { public static DateTime dateNew(final Date date) {
if (date == null) {
return null;
}
return new DateTime(date); return new DateTime(date);
} }
/** /**
* 根据已有{@link Date} 产生新的{@link DateTime}对象,并根据指定时区转换 * 根据已有{@link Date} 产生新的{@link DateTime}对象,并根据指定时区转换
* *
* @param date Date对象 * @param date Date对象,如果传入{@code null},返回{@code null}
* @param timeZone 时区 * @param timeZone 时区,传入{@code null}则使用默认时区
* @return {@link DateTime}对象 * @return {@link DateTime}对象
*/ */
public static DateTime date(final Date date, final TimeZone timeZone) { public static DateTime date(final Date date, final TimeZone timeZone) {
if (date == null) {
return null;
}
return new DateTime(date, timeZone); return new DateTime(date, timeZone);
} }
@@ -148,10 +160,13 @@ public class DateUtil extends CalendarUtil {
* {@link Calendar}类型时间转为{@link DateTime}<br> * {@link Calendar}类型时间转为{@link DateTime}<br>
* 始终根据已有{@link Calendar} 产生新的{@link DateTime}对象 * 始终根据已有{@link Calendar} 产生新的{@link DateTime}对象
* *
* @param calendar {@link Calendar} * @param calendar {@link Calendar},如果传入{@code null},返回{@code null}
* @return 时间对象 * @return 时间对象
*/ */
public static DateTime date(final Calendar calendar) { public static DateTime date(final Calendar calendar) {
if (calendar == null) {
return null;
}
return new DateTime(calendar); return new DateTime(calendar);
} }
@@ -159,11 +174,14 @@ public class DateUtil extends CalendarUtil {
* {@link TemporalAccessor}类型时间转为{@link DateTime}<br> * {@link TemporalAccessor}类型时间转为{@link DateTime}<br>
* 始终根据已有{@link TemporalAccessor} 产生新的{@link DateTime}对象 * 始终根据已有{@link TemporalAccessor} 产生新的{@link DateTime}对象
* *
* @param temporalAccessor {@link TemporalAccessor},常用子类: {@link LocalDateTime}、 LocalDate * @param temporalAccessor {@link TemporalAccessor},常用子类: {@link LocalDateTime}、 LocalDate,如果传入{@code null},返回{@code null}
* @return 时间对象 * @return 时间对象
* @since 5.0.0 * @since 5.0.0
*/ */
public static DateTime date(final TemporalAccessor temporalAccessor) { public static DateTime date(final TemporalAccessor temporalAccessor) {
if (temporalAccessor == null) {
return null;
}
return new DateTime(temporalAccessor); return new DateTime(temporalAccessor);
} }