DateTime (jexx-core 1.0.13-RELEASE API)

java.lang.Object
- java.util.Date
- - jexx.time.DateTime

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<java.util.Date>
```
public class DateTime
extends java.util.Date
```
包装java.util.Date

另请参阅:

序列化表格

构造器概要

构造器
构造器和说明
`DateTime()` 当前时间
`DateTime(java.util.Calendar calendar)` 给定日期的构造
`DateTime(java.util.Date date)` 给定日期的构造
`DateTime(java.util.Date date, java.util.TimeZone timeZone)` 给定日期的构造
`DateTime(long timeMillis)` 给定日期毫秒数的构造
`DateTime(long timeMillis, java.util.TimeZone timeZone)` 给定日期毫秒数的构造
`DateTime(java.lang.String dateStr, java.text.DateFormat dateFormat)` 构造
`DateTime(java.lang.String dateStr, DateParser dateParser)` 构造
`DateTime(java.lang.String dateStr, java.lang.String format)` 构造
`DateTime(java.util.TimeZone timeZone)` 当前时间

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`DateBetween`	`between(java.util.Date date)` 计算相差时长
`long`	`between(java.util.Date date, DateUnit unit)` 计算相差时长
`java.lang.String`	`between(java.util.Date date, DateUnit unit, BetweenFormater.Level formatLevel)` 计算相差时长
`int`	`dayOfMonth()` 获得指定日期是这个日期所在月份的第几天
`int`	`dayOfWeek()` 获得指定日期是星期几，1表示周日，2表示周一
`Week`	`dayOfWeekEnum()` 获得指定日期是星期几
`int`	`dayOfWeekInMonth()` 获得天所在的周是这个月的第几周
`int`	`getField(DateField field)` 获得日期的某个部分例如获得年的部分，则使用 getField(DatePart.YEAR)
`int`	`getField(int field)` 获得日期的某个部分例如获得年的部分，则使用 getField(Calendar.YEAR)
`Week`	`getFirstDayOfWeek()` 获得一周的第一天，默认为周一
`int`	`hour()` 返回二十四小时制的小时数
`int`	`hour(boolean is24HourClock)` 获得指定日期的小时数部分
`boolean`	`isAfter(java.util.Date date)` 是否在给定日期之后或与给定日期相等
`boolean`	`isAfterOrEquals(java.util.Date date)` 是否在给定日期之后或与给定日期相等
`boolean`	`isAM()` 是否为上午
`boolean`	`isBefore(java.util.Date date)` 是否在给定日期之前
`boolean`	`isBeforeOrEquals(java.util.Date date)` 是否在给定日期之前或与给定日期相等
`boolean`	`isIn(java.util.Date beginDate, java.util.Date endDate)` 当前日期是否在日期指定范围内起始日期和结束日期可以互换
`boolean`	`isLeapYear()` 是否闰年
`boolean`	`isMutable()` 对象是否可变如果为不可变对象，以下方法将返回新方法： `offset(DateField, int)` `setField(DateField, int)` `setField(int, int)` 如果为不可变对象，`setTime(long)`将抛出异常
`boolean`	`isPM()` 是否为下午
`int`	`millsecond()` 获得指定日期的毫秒数部分
`int`	`minute()` 获得指定日期的分钟数部分例如：10:04:15.250 =》 4
`int`	`month()` 获得月份，从0开始计数
`Month`	`monthEnum()` 获得月份
`int`	`monthStartFromOne()` 获得月份，从1开始计数由于`Calendar` 中的月份按照0开始计数，导致某些需求容易误解，因此如果想用1表示一月，2表示二月则调用此方法
`static DateTime`	`now()` 现在的时间
`static DateTime`	`of(java.util.Calendar calendar)` 转换 `Calendar` 为 DateTime
`static DateTime`	`of(java.util.Date date)` 转换JDK date为 DateTime
`static DateTime`	`of(java.util.Date date, java.util.TimeZone timeZone)`
`static DateTime`	`of(java.lang.String dateStr, java.lang.String format)` 构造
`DateTime`	`offset(DateField datePart, int offset)` 调整日期和时间如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	`offsetNew(DateField datePart, int offset)` 调整日期和时间返回调整后的新`DateTime`，不影响原对象
`int`	`quarter()` 获得当前日期所属季度，从1开始计数
`Quarter`	`quarterEnum()` 获得当前日期所属季度
`int`	`season()` 已过时。请使用`Quarter`代替
`int`	`second()` 获得指定日期的秒数部分
`DateTime`	`setField(DateField field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	`setField(int field, int value)` 设置日期的某个部分如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见`setMutable(boolean)`
`DateTime`	`setFirstDayOfWeek(Week firstDayOfWeek)` 设置一周的第一天 JDK的Calendar中默认一周的第一天是周日，Hutool中将此默认值设置为周一设置一周的第一天主要影响`weekOfMonth()`和`weekOfYear()` 两个方法
`DateTime`	`setMutable(boolean mutable)` 设置对象是否可变如果为不可变对象，以下方法将返回新方法： `offset(DateField, int)` `setField(DateField, int)` `setField(int, int)` 如果为不可变对象，`setTime(long)`将抛出异常
`void`	`setTime(long time)`
`DateTime`	`setTimeZone(java.util.TimeZone timeZone)` 设置时区
`java.util.Calendar`	`toCalendar()` 转换为Calendar, 默认 `Locale`
`java.util.Calendar`	`toCalendar(java.util.Locale locale)` 转换为Calendar
`java.util.Calendar`	`toCalendar(java.util.TimeZone zone)` 转换为Calendar
`java.util.Calendar`	`toCalendar(java.util.TimeZone zone, java.util.Locale locale)` 转换为Calendar
`java.lang.String`	`toDateStr()` 转为"yyyy-MM-dd " 格式字符串
`java.util.Date`	`toJdkDate()` 转换为 `Date` 考虑到很多框架（例如Hibernate）的兼容性，提供此方法返回JDK原生的Date对象
`java.lang.String`	`toMsStr()`
`java.sql.Date`	`toSqlDate()` 转为 `Date`
`java.lang.String`	`toString()` 转为"yyyy-MM-dd HH:mm:ss " 格式字符串
`java.lang.String`	`toString(java.text.DateFormat format)` 转为字符串
`java.lang.String`	`toString(DatePrinter format)` 转为字符串
`java.lang.String`	`toString(java.lang.String format)` 转为字符串
`java.sql.Timestamp`	`toTimestamp()` 转为`Timestamp`
`java.lang.String`	`toTimeStr()` 转为"HH:mm:ss" 格式字符串
`int`	`weekOfMonth()` 获得指定日期是所在月份的第几周此方法返回值与一周的第一天有关，比如： 2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）如果一周的第一天为周一，那这天是第一周（返回1）
`int`	`weekOfYear()` 获得指定日期是所在年份的第几周此方法返回值与一周的第一天有关，比如： 2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）如果一周的第一天为周一，那这天是第一周（返回1）
`int`	`year()` 获得年的部分

从类继承的方法 java.util.Date
after, before, clone, compareTo, equals, from, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toInstant, toLocaleString, UTC

从类继承的方法 java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - DateTime
```
public DateTime()
```
    当前时间
  - DateTime
```
public DateTime(java.util.TimeZone timeZone)
```
    当前时间
    
    参数:
    
    timeZone - 时区
    
    从以下版本开始:
    
    4.1.2
  - DateTime
```
public DateTime(java.util.Date date)
```
    给定日期的构造
    
    参数:
    
    date - 日期
  - DateTime
```
public DateTime(java.util.Date date,
                java.util.TimeZone timeZone)
```
    给定日期的构造
    
    参数:
    
    date - 日期
    
    timeZone - 时区
    
    从以下版本开始:
    
    4.1.2
  - DateTime
```
public DateTime(java.util.Calendar calendar)
```
    给定日期的构造
    
    参数:
    
    calendar - Calendar
  - DateTime
```
public DateTime(long timeMillis)
```
    给定日期毫秒数的构造
    
    参数:
    
    timeMillis - 日期毫秒数
    
    从以下版本开始:
    
    4.1.2
  - DateTime
```
public DateTime(long timeMillis,
                java.util.TimeZone timeZone)
```
    给定日期毫秒数的构造
    
    参数:
    
    timeMillis - 日期毫秒数
    
    timeZone - 时区
    
    从以下版本开始:
    
    4.1.2
  - DateTime
```
public DateTime(java.lang.String dateStr,
                java.lang.String format)
```
    构造
    
    参数:
    
    dateStr - Date字符串
    
    format - 格式
    
    另请参阅:
    
    DatePattern
  - DateTime
```
public DateTime(java.lang.String dateStr,
                java.text.DateFormat dateFormat)
```
    构造
    
    参数:
    
    dateStr - Date字符串
    
    dateFormat - 格式化器 SimpleDateFormat
    
    另请参阅:
    
    DatePattern
  - DateTime
```
public DateTime(java.lang.String dateStr,
                DateParser dateParser)
```
    构造
    
    参数:
    
    dateStr - Date字符串
    
    dateParser - 格式化器 DateParser，可以使用 FastDateFormat
    
    另请参阅:
    
    DatePattern
- 方法详细资料
  - of
```
public static DateTime of(java.util.Date date)
```
    转换JDK date为 DateTime
    
    参数:
    
    date - JDK Date
    
    返回:
    
    DateTime
  - of
```
public static DateTime of(java.util.Date date,
                          java.util.TimeZone timeZone)
```
  - of
```
public static DateTime of(java.util.Calendar calendar)
```
    转换 Calendar 为 DateTime
    
    参数:
    
    calendar - Calendar
    
    返回:
    
    DateTime
  - of
```
public static DateTime of(java.lang.String dateStr,
                          java.lang.String format)
```
    构造
    
    参数:
    
    dateStr - Date字符串
    
    format - 格式
    
    返回:
    
    DateTime
    
    另请参阅:
    
    DatePattern
  - now
```
public static DateTime now()
```
    现在的时间
    
    返回:
    
    现在的时间
  - offset
```
public DateTime offset(DateField datePart,
                       int offset)
```
    调整日期和时间
    如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见setMutable(boolean)
    
    参数:
    
    datePart - 调整的部分 DateField
    
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    
    如果此对象为可变对象，返回自身，否则返回新对象
  - offsetNew
```
public DateTime offsetNew(DateField datePart,
                          int offset)
```
    调整日期和时间
    返回调整后的新DateTime，不影响原对象
    
    参数:
    
    datePart - 调整的部分 DateField
    
    offset - 偏移量，正数为向后偏移，负数为向前偏移
    
    返回:
    
    如果此对象为可变对象，返回自身，否则返回新对象
    
    从以下版本开始:
    
    3.0.9
  - getField
```
public int getField(DateField field)
```
    获得日期的某个部分
    例如获得年的部分，则使用 getField(DatePart.YEAR)
    
    参数:
    
    field - 表示日期的哪个部分的枚举 DateField
    
    返回:
    
    某个部分的值
  - getField
```
public int getField(int field)
```
    获得日期的某个部分
    例如获得年的部分，则使用 getField(Calendar.YEAR)
    
    参数:
    
    field - 表示日期的哪个部分的int值 Calendar
    
    返回:
    
    某个部分的值
  - setField
```
public DateTime setField(DateField field,
                         int value)
```
    设置日期的某个部分
    如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见setMutable(boolean)
    
    参数:
    
    field - 表示日期的哪个部分的枚举 DateField
    
    value - 值
    
    返回:
    
    DateTime
  - setField
```
public DateTime setField(int field,
                         int value)
```
    设置日期的某个部分
    如果此对象为可变对象，返回自身，否则返回新对象，设置是否可变对象见setMutable(boolean)
    
    参数:
    
    field - 表示日期的哪个部分的int值 Calendar
    
    value - 值
    
    返回:
    
    DateTime
  - setTime
```
public void setTime(long time)
```
    覆盖:
    
    setTime 在类中 java.util.Date
  - year
```
public int year()
```
    获得年的部分
    
    返回:
    
    年的部分
  - season
```
@Deprecated
public int season()
```
    已过时。请使用Quarter代替
    
    获得当前日期所属季度
    1：第一季度
    2：第二季度
    3：第三季度
    4：第四季度
    
    返回:
    
    第几个季度
  - quarter
```
public int quarter()
```
    获得当前日期所属季度，从1开始计数
    
    返回:
    
    第几个季度 Quarter
  - quarterEnum
```
public Quarter quarterEnum()
```
    获得当前日期所属季度
    
    返回:
    
    第几个季度 Quarter
  - month
```
public int month()
```
    获得月份，从0开始计数
    
    返回:
    
    月份
  - monthStartFromOne
```
public int monthStartFromOne()
```
    获得月份，从1开始计数
    由于Calendar 中的月份按照0开始计数，导致某些需求容易误解，因此如果想用1表示一月，2表示二月则调用此方法
    
    返回:
    
    月份
  - monthEnum
```
public Month monthEnum()
```
    获得月份
    
    返回:
    
    Month
  - weekOfYear
```
public int weekOfYear()
```
    获得指定日期是所在年份的第几周
    此方法返回值与一周的第一天有关，比如：
    2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）
    如果一周的第一天为周一，那这天是第一周（返回1）
    
    返回:
    
    周
    
    另请参阅:
    
    setFirstDayOfWeek(Week)
  - weekOfMonth
```
public int weekOfMonth()
```
    获得指定日期是所在月份的第几周
    此方法返回值与一周的第一天有关，比如：
    2016年1月3日为周日，如果一周的第一天为周日，那这天是第二周（返回2）
    如果一周的第一天为周一，那这天是第一周（返回1）
    
    返回:
    
    周
    
    另请参阅:
    
    setFirstDayOfWeek(Week)
  - dayOfMonth
```
public int dayOfMonth()
```
    获得指定日期是这个日期所在月份的第几天
    
    返回:
    
    天
  - dayOfWeek
```
public int dayOfWeek()
```
    获得指定日期是星期几，1表示周日，2表示周一
    
    返回:
    
    星期几
  - dayOfWeekInMonth
```
public int dayOfWeekInMonth()
```
    获得天所在的周是这个月的第几周
    
    返回:
    
    天
  - dayOfWeekEnum
```
public Week dayOfWeekEnum()
```
    获得指定日期是星期几
    
    返回:
    
    Week
  - hour
```
public int hour()
```
    返回二十四小时制的小时数
  - hour
```
public int hour(boolean is24HourClock)
```
    获得指定日期的小时数部分
    
    参数:
    
    is24HourClock - 是否24小时制
    
    返回:
    
    小时数
  - minute
```
public int minute()
```
    获得指定日期的分钟数部分
    例如：10:04:15.250 =》 4
    
    返回:
    
    分钟数
  - second
```
public int second()
```
    获得指定日期的秒数部分
    
    返回:
    
    秒数
  - millsecond
```
public int millsecond()
```
    获得指定日期的毫秒数部分
    
    返回:
    
    毫秒数
  - isAM
```
public boolean isAM()
```
    是否为上午
    
    返回:
    
    是否为上午
  - isPM
```
public boolean isPM()
```
    是否为下午
    
    返回:
    
    是否为下午
  - isLeapYear
```
public boolean isLeapYear()
```
    是否闰年
    
    返回:
    
    是否闰年
    
    另请参阅:
    
    DateUtil.isLeapYear(int)
  - toCalendar
```
public java.util.Calendar toCalendar()
```
    转换为Calendar, 默认 Locale
    
    返回:
    
    Calendar
  - toCalendar
```
public java.util.Calendar toCalendar(java.util.Locale locale)
```
    转换为Calendar
    
    参数:
    
    locale - 地域 Locale
    
    返回:
    
    Calendar
  - toCalendar
```
public java.util.Calendar toCalendar(java.util.TimeZone zone)
```
    转换为Calendar
    
    参数:
    
    zone - 时区 TimeZone
    
    返回:
    
    Calendar
  - toCalendar
```
public java.util.Calendar toCalendar(java.util.TimeZone zone,
                                     java.util.Locale locale)
```
    转换为Calendar
    
    参数:
    
    zone - 时区 TimeZone
    
    locale - 地域 Locale
    
    返回:
    
    Calendar
  - toJdkDate
```
public java.util.Date toJdkDate()
```
    转换为 Date
    考虑到很多框架（例如Hibernate）的兼容性，提供此方法返回JDK原生的Date对象
    
    返回:
    
    Date
    
    从以下版本开始:
    
    3.2.2
  - toTimestamp
```
public java.sql.Timestamp toTimestamp()
```
    转为Timestamp
    
    返回:
    
    Timestamp
  - toSqlDate
```
public java.sql.Date toSqlDate()
```
    转为 Date
    
    返回:
    
    Date
  - between
```
public DateBetween between(java.util.Date date)
```
    计算相差时长
    
    参数:
    
    date - 对比的日期
    
    返回:
    
    DateBetween
  - between
```
public long between(java.util.Date date,
                    DateUnit unit)
```
    计算相差时长
    
    参数:
    
    date - 对比的日期
    
    unit - 单位 DateUnit
    
    返回:
    
    相差时长
  - between
```
public java.lang.String between(java.util.Date date,
                                DateUnit unit,
                                BetweenFormater.Level formatLevel)
```
    计算相差时长
    
    参数:
    
    date - 对比的日期
    
    unit - 单位 DateUnit
    
    formatLevel - 格式化级别
    
    返回:
    
    相差时长
  - isIn
```
public boolean isIn(java.util.Date beginDate,
                    java.util.Date endDate)
```
    当前日期是否在日期指定范围内
    起始日期和结束日期可以互换
    
    参数:
    
    beginDate - 起始日期
    
    endDate - 结束日期
    
    返回:
    
    是否在范围内
    
    从以下版本开始:
    
    3.0.8
  - isBefore
```
public boolean isBefore(java.util.Date date)
```
    是否在给定日期之前
    
    参数:
    
    date - 日期
    
    返回:
    
    是否在给定日期之前或与给定日期相等
    
    从以下版本开始:
    
    4.1.3
  - isBeforeOrEquals
```
public boolean isBeforeOrEquals(java.util.Date date)
```
    是否在给定日期之前或与给定日期相等
    
    参数:
    
    date - 日期
    
    返回:
    
    是否在给定日期之前或与给定日期相等
    
    从以下版本开始:
    
    3.0.9
  - isAfter
```
public boolean isAfter(java.util.Date date)
```
    是否在给定日期之后或与给定日期相等
    
    参数:
    
    date - 日期
    
    返回:
    
    是否在给定日期之后或与给定日期相等
    
    从以下版本开始:
    
    4.1.3
  - isAfterOrEquals
```
public boolean isAfterOrEquals(java.util.Date date)
```
    是否在给定日期之后或与给定日期相等
    
    参数:
    
    date - 日期
    
    返回:
    
    是否在给定日期之后或与给定日期相等
    
    从以下版本开始:
    
    3.0.9
  - isMutable
```
public boolean isMutable()
```
    对象是否可变
    如果为不可变对象，以下方法将返回新方法：
    如果为不可变对象，setTime(long)将抛出异常
    返回:
    
    对象是否可变
  - setMutable
```
public DateTime setMutable(boolean mutable)
```
    设置对象是否可变如果为不可变对象，以下方法将返回新方法：
    如果为不可变对象，setTime(long)将抛出异常
    参数:
    
    mutable - 是否可变
    
    返回:
    
    this
  - getFirstDayOfWeek
```
public Week getFirstDayOfWeek()
```
    获得一周的第一天，默认为周一
    
    返回:
    
    一周的第一天
  - setFirstDayOfWeek
```
public DateTime setFirstDayOfWeek(Week firstDayOfWeek)
```
    设置一周的第一天
    JDK的Calendar中默认一周的第一天是周日，Hutool中将此默认值设置为周一
    设置一周的第一天主要影响weekOfMonth()和weekOfYear() 两个方法
    
    参数:
    
    firstDayOfWeek - 一周的第一天
    
    返回:
    
    this
    
    另请参阅:
    
    weekOfMonth(), weekOfYear()
  - setTimeZone
```
public DateTime setTimeZone(java.util.TimeZone timeZone)
```
    设置时区
    
    参数:
    
    timeZone - 时区
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.1.2
  - toString
```
public java.lang.String toString()
```
    转为"yyyy-MM-dd HH:mm:ss " 格式字符串
    
    覆盖:
    
    toString 在类中 java.util.Date
    
    返回:
    
    "yyyy-MM-dd yyyy-MM-dd HH:mm:ss " 格式字符串
  - toDateStr
```
public java.lang.String toDateStr()
```
    转为"yyyy-MM-dd " 格式字符串
    
    返回:
    
    "yyyy-MM-dd " 格式字符串
  - toTimeStr
```
public java.lang.String toTimeStr()
```
    转为"HH:mm:ss" 格式字符串
    
    返回:
    
    "HH:mm:ss" 格式字符串
  - toString
```
public java.lang.String toString(java.lang.String format)
```
    转为字符串
    
    参数:
    
    format - 日期格式，常用格式见： DatePattern
    
    返回:
    
    String
  - toString
```
public java.lang.String toString(DatePrinter format)
```
    转为字符串
    
    参数:
    
    format - DatePrinter 或 FastDateFormat
    
    返回:
    
    String
  - toString
```
public java.lang.String toString(java.text.DateFormat format)
```
    转为字符串
    
    参数:
    
    format - SimpleDateFormat
    
    返回:
    
    String
  - toMsStr
```
public java.lang.String toMsStr()
```
    返回:
    
    输出精确到毫秒的标准日期形式

类 DateTime

构造器概要

方法概要

从类继承的方法 java.util.Date

从类继承的方法 java.lang.Object

构造器详细资料

DateTime

DateTime

DateTime

DateTime

DateTime

DateTime

DateTime

DateTime

DateTime

DateTime

方法详细资料

of

of

of

of

now

offset

offsetNew

getField

getField

setField

setField

setTime

year

season

quarter

quarterEnum

month

monthStartFromOne

monthEnum

weekOfYear

weekOfMonth

dayOfMonth

dayOfWeek

dayOfWeekInMonth

dayOfWeekEnum

hour

hour

minute

second

millsecond

isAM

isPM

isLeapYear

toCalendar

toCalendar

toCalendar

toCalendar

toJdkDate

toTimestamp

toSqlDate

between

between

between

isIn

isBefore

isBeforeOrEquals

isAfter

isAfterOrEquals

isMutable

setMutable

getFirstDayOfWeek

setFirstDayOfWeek

setTimeZone

toString

toDateStr

toTimeStr

toString

toString

toString

toMsStr