public class DateTime
extends 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(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()
是否为下午
|
boolean |
isWeekend()
是否为周末,周末指周六或者周日
|
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.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代替 |
Season |
seasonEnum()
已过时。
请使用
quarterEnum()代替 |
int |
second()
获得指定日期的秒数部分
|
DateTime |
setField(DateField field,
int value)
设置日期的某个部分
如果此对象为可变对象,返回自身,否则返回新对象,设置是否可变对象见 setMutable(boolean) |
DateTime |
setField(int field,
int value)
设置日期的某个部分
如果此对象为可变对象,返回自身,否则返回新对象,设置是否可变对象见 setMutable(boolean) |
DateTime |
setFirstDayOfWeek(Week firstDayOfWeek)
|
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 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.lang.String |
toString(java.util.TimeZone timeZone)
转为"yyyy-MM-dd yyyy-MM-dd HH:mm:ss " 格式字符串
如果时区不为 null,会转换为其时区对应的时间,否则转换为当前时间对应的时区 |
java.lang.String |
toStringDefaultTimeZone()
转为"yyyy-MM-dd yyyy-MM-dd HH:mm:ss " 格式字符串
时区使用当前地区的默认时区 |
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) 跨年的那个星期得到的结果总是1 |
int |
year()
获得年的部分
|
public DateTime()
public DateTime(java.util.TimeZone timeZone)
timeZone - 时区public DateTime(java.util.Date date)
date - 日期public DateTime(java.util.Date date,
java.util.TimeZone timeZone)
date - 日期timeZone - 时区public DateTime(java.util.Calendar calendar)
calendar - Calendarpublic DateTime(long timeMillis)
timeMillis - 日期毫秒数public DateTime(long timeMillis,
java.util.TimeZone timeZone)
timeMillis - 日期毫秒数timeZone - 时区public DateTime(java.lang.String dateStr,
java.lang.String format)
dateStr - Date字符串format - 格式DatePatternpublic DateTime(java.lang.String dateStr,
java.text.DateFormat dateFormat)
dateStr - Date字符串dateFormat - 格式化器 SimpleDateFormatDatePatternpublic DateTime(java.lang.String dateStr,
DateParser dateParser)
dateStr - Date字符串dateParser - 格式化器 DateParser,可以使用 FastDateFormatDatePatternpublic static DateTime of(java.util.Date date)
date - JDK Datepublic static DateTime of(java.util.Calendar calendar)
Calendar 为 DateTimecalendar - Calendarpublic static DateTime of(java.lang.String dateStr, java.lang.String format)
dateStr - Date字符串format - 格式DateTimeDatePatternpublic static DateTime now()
public DateTime offset(DateField datePart, int offset)
setMutable(boolean)datePart - 调整的部分 DateFieldoffset - 偏移量,正数为向后偏移,负数为向前偏移public DateTime offsetNew(DateField datePart, int offset)
DateTime,不影响原对象datePart - 调整的部分 DateFieldoffset - 偏移量,正数为向后偏移,负数为向前偏移public int getField(DateField field)
field - 表示日期的哪个部分的枚举 DateFieldpublic int getField(int field)
field - 表示日期的哪个部分的int值 Calendarpublic DateTime setField(DateField field, int value)
setMutable(boolean)public DateTime setField(int field, int value)
setMutable(boolean)field - 表示日期的哪个部分的int值 Calendarvalue - 值DateTimepublic void setTime(long time)
setTime 在类中 java.util.Datepublic int year()
@Deprecated public int season()
Quarter代替@Deprecated public Season seasonEnum()
quarterEnum()代替Seasonpublic int quarter()
Quarterpublic int month()
public int monthStartFromOne()
Calendar 中的月份按照0开始计数,导致某些需求容易误解,因此如果想用1表示一月,2表示二月则调用此方法public int weekOfYear()
setFirstDayOfWeek(Week)public int weekOfMonth()
setFirstDayOfWeek(Week)public int dayOfMonth()
public int dayOfWeek()
public int dayOfWeekInMonth()
public int hour(boolean is24HourClock)
is24HourClock - 是否24小时制public int minute()
public int second()
public int millsecond()
public boolean isAM()
public boolean isPM()
public boolean isWeekend()
public boolean isLeapYear()
DateUtil.isLeapYear(int)public java.util.Calendar toCalendar()
LocaleCalendarpublic java.util.Calendar toCalendar(java.util.Locale locale)
locale - 地域 LocaleCalendarpublic java.util.Calendar toCalendar(java.util.TimeZone zone)
zone - 时区 TimeZoneCalendarpublic java.util.Calendar toCalendar(java.util.TimeZone zone,
java.util.Locale locale)
zone - 时区 TimeZonelocale - 地域 LocaleCalendarpublic java.util.Date toJdkDate()
DateDatepublic java.sql.Timestamp toTimestamp()
TimestampTimestamppublic java.sql.Date toSqlDate()
DateDatepublic DateBetween between(java.util.Date date)
date - 对比的日期DateBetweenpublic long between(java.util.Date date,
DateUnit unit)
date - 对比的日期unit - 单位 DateUnitpublic java.lang.String between(java.util.Date date,
DateUnit unit,
BetweenFormater.Level formatLevel)
date - 对比的日期unit - 单位 DateUnitformatLevel - 格式化级别public boolean isIn(java.util.Date beginDate,
java.util.Date endDate)
beginDate - 起始日期endDate - 结束日期public boolean isBefore(java.util.Date date)
date - 日期public boolean isBeforeOrEquals(java.util.Date date)
date - 日期public boolean isAfter(java.util.Date date)
date - 日期public boolean isAfterOrEquals(java.util.Date date)
date - 日期public boolean isMutable()
setTime(long)将抛出异常public DateTime setMutable(boolean mutable)
setTime(long)将抛出异常mutable - 是否可变public Week getFirstDayOfWeek()
public DateTime setFirstDayOfWeek(Week firstDayOfWeek)
firstDayOfWeek - 一周的第一天weekOfMonth(),
weekOfYear()public DateTime setTimeZone(java.util.TimeZone timeZone)
timeZone - 时区public java.lang.String toString()
toString 在类中 java.util.Datepublic java.lang.String toStringDefaultTimeZone()
public java.lang.String toString(java.util.TimeZone timeZone)
null,会转换为其时区对应的时间,否则转换为当前时间对应的时区timeZone - 时区public java.lang.String toDateStr()
public java.lang.String toTimeStr()
public java.lang.String toString(java.lang.String format)
format - 日期格式,常用格式见: DatePatternpublic java.lang.String toString(DatePrinter format)
format - DatePrinter 或 FastDateFormatpublic java.lang.String toString(java.text.DateFormat format)
format - SimpleDateFormatpublic java.lang.String toMsStr()
Copyright © 2018. All rights reserved.