com.centit.support.algorithm

类 DatetimeOpt

java.lang.Object

com.centit.support.algorithm.DatetimeOpt

public abstract class DatetimeOpt
extends Object

几乎每一个框架都有重写这个类，这个类中的方法比较多，可以归纳为一下几类： 1. create* 这类方法式创建一个日期类，不同的方法有不同的参数 2. current* 获取当前时间，不同的方法返回不同的类型，可能是 utils.Date、sql.Data、timeStamp等等 3. convert* 在土工日期类型、日期和时间 等等之间进行转换 4. equal* 判断两个日期在不同时间精度上是否相等，比如是否是同一月、同一天、同一分钟等等。 5. calc* 一组关于日期的计算函数，比如：计算两个日期之间的时机差calcSpanDays， 计算两个日期之间的工作日 calcWeekDays， 计算两个日期之间的周末天数 calcWeekendDays， 计算一周的第一天和最后一天等等。 6. add* 给日期做加减计算，参数为负数就是减。 7. get* 获得日期的属性，比如星期几、是一年的第几天、当前时分秒等等。 8. seek* 移动到这个月的最后一天、这年的最后一天等等。 9. truncate* 截取日期到天、周、月等等，和seek*操作相对。 10. smartPraseDate 和 castObjectToDate 前者将字符串转换为日期，后者将object转换为日期

作者:

codefan

字段概要

字段

限定符和类型	字段和说明
static String	datetimePattern
static String	defaultDatePattern
static String	gmtDatePattern
static String	timePattern
static String	timestampPattern
static String	timeWithSecondPattern

方法概要

限定符和类型	方法和说明
static Date	addDays(Date date, float nDays)
static Date	addDays(Date date, int nDays)
static Date	addHours(Date date, int nHours)
static Date	addMinutes(Date date, int nMinutes)
static Date	addMonths(Date date, int nMonths)
static Date	addSeconds(Date date, int nSeconds)
static Date	addYears(Date date, int nYears)
static double	calcDateSpan(Date beginDate, Date endDate)
static int	calcSpanDays(Date beginDate, Date endDate)
static Date	calcWeek1stDay(int nYear, int nWeekNo)
static int	calcWeekDays(Date beginDate, Date endDate, int weekDay) 计算这个周期中 工作日的天数,不包括 周六和周日，但是因为不知道其他的假期，所以只是去掉周末
static int	calcWeekendDays(Date beginDate, Date endDate) 计算这个周期中的周六和周日的天数，周末的天数
static Date	calcWeekLastDay(int nYear, int nWeekNo)
static Date	castObjectToDate(Object obj)
static Date	castObjectToSqlDate(Object date)
static Timestamp	castObjectToSqlTimestamp(Object date)
static int	compareTwoDate(Date oneDate, Date otherDate) 比较两个日期大小 ,避免 发生 NullPointerException 异常 Compares two Dates for ordering.
static String	convertDatetimeToString(Date aDate) 返回日期字符串 "yyyy-MM-dd HH:mm:ss"
static String	convertDateToGMTString(Date aDate) 返回日期字符串 toUTCString( ) 和 javaScript 一致 // d MMM yyyy HH:mm:ss 'GMT'
static String	convertDateToSmartString(Date aDate)
static String	convertDateToSmartString(Date aDate, boolean withSecond)
static String	convertDateToString(Date aDate) 返回日期字符串 "yyyy-MM-dd"
static String	convertDateToString(Date aDate, String aMask) This method generates a string representation of a date's date/time in the format you specify on input
static Date	convertStringToDate(String strDate) This method converts a String to a date using the datePattern
static Date	convertStringToDate(String strDate, String sMask) This method generates a string representation of a date/time in the format you specify on input
static String	convertTimestampToString(Date aDate)
static String	convertTimeToString(Date aDate) This method generates a string representation of a date based on the System Property 'dateFormat' in the format you specify on input
static String	convertTimeWithSecondToString(Date aDate)
static Date	convertToSqlDate(Date date) 日期类型转换 从 java.util.Date 转换为 java.sql.Date 这个会截断时间
static Timestamp	convertToSqlTimestamp(Date date) 日期类型转换 从 java.util.Date 转换为 java.sql.Timestamp
static Date	convertToUtilDate(Date date) 日期类型转换 从 java.sql.Date 转换为 java.util.Date 这个会截断时间
static Date	createUtilDate(int year, int month, int date) 根据 年、月、日 创建一个日期 类型为 java.util.Date
static Date	createUtilDate(int year, int month, int date, int hourOfDay, int minute) 根据 年、月、日、时、分 创建一个日期 类型为 java.util.Date
static Date	createUtilDate(int year, int month, int date, int hourOfDay, int minute, int second) 根据 年、月、日、时、分、秒 创建一个日期 类型为 java.util.Date
static Date	createUtilDate(int year, int month, int date, int hourOfDay, int minute, int second, int milliSecond)
static Calendar	currentCalendarDate()
static String	currentDate() 获得当前日期的字符串 ，格式为 "yyyy-MM-dd" 示例 2015-08-24
static String	currentDatetime() 获得当前日期的字符串 ，格式为 "yyyy-MM-dd HH:mm:ss"
static Date	currentSqlDate()
static Timestamp	currentSqlTimeStamp()
static String	currentTime()
static String	currentTimeWithSecond()
static Date	currentUtilDate()
static boolean	equalOnDay(Date oneDate, Date otherDate)
static boolean	equalOnHour(Date oneDate, Date otherDate)
static boolean	equalOnMinute(Date oneDate, Date otherDate)
static boolean	equalOnSecond(Date oneDate, Date otherDate)
static Locale	fetchLangLocal(String lang)
static TimeZone	fetchTimeZone(String zone) 时区转换
static String	getDatePattern() 返回常量字符串 "yyyy-MM-dd"
static String	getDateTimePattern()
static int	getDay(Date date)
static int	getDayOfWeek(Date date) 获得 指定日期 是星期几 星期日 到星期六 为 0-6
static int	getDayOfWeek(int y, int m, int d) 获得 年月日 对应的日期 是星期几 星期日 到星期六 为 0-6
static String	getDayOfWeekCN(Date date) 获得 指定日期 是星期几 星期日 到星期六 为 "星期日","星期一","星期二","星期三","星期四","星期五","星期六"
static int	getDayOfYear(Date date)
static int	getHour(Date date)
static int	getMilliSecond(Date date)
static int	getMinute(Date date)
static int	getMonth(Date date)
static String	getNowDateTime4String() 获得当前时间字符串，格式为 "yyyy-MM-dd HH:mm:ss"
static int	getSecond(Date date)
static int	getWeekOfMonth(Date date)
static int	getWeekOfYear(Date date)
static int	getYear(Date date)
static Date	seekEndOfMonth(Date date)
static Date	seekEndOfWeek(Date date) 获取一周最后一天（周日凌晨零点）
static Date	seekEndOfYear(Date date)
static Date	smartPraseDate(String sDate)
static Date	truncateToDay(Date date)
static Date	truncateToMonth(Date date)
static Date	truncateToSecond(Date date)
static Date	truncateToWeek(Date date) 获取一周第一天（周一凌晨零点）
static Date	truncateToYear(Date date)

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

defaultDatePattern

public static final String defaultDatePattern

另请参阅:

常量字段值

timePattern

public static final String timePattern

另请参阅:

常量字段值

timeWithSecondPattern

public static final String timeWithSecondPattern

另请参阅:

常量字段值

datetimePattern

public static final String datetimePattern

另请参阅:

常量字段值

timestampPattern

public static final String timestampPattern

另请参阅:

常量字段值

gmtDatePattern

public static final String gmtDatePattern

另请参阅:

常量字段值

方法详细资料

currentDate

public static String currentDate()

获得当前日期的字符串 ，格式为 "yyyy-MM-dd" 示例 2015-08-24

返回:

当前时间`

currentTime

public static String currentTime()

currentTimeWithSecond

public static String currentTimeWithSecond()

currentDatetime

public static String currentDatetime()

获得当前日期的字符串 ，格式为 "yyyy-MM-dd HH:mm:ss"

返回:

当前时间

createUtilDate

public static Date createUtilDate(int year,
                                  int month,
                                  int date,
                                  int hourOfDay,
                                  int minute,
                                  int second,
                                  int milliSecond)

createUtilDate

public static Date createUtilDate(int year,
                                  int month,
                                  int date,
                                  int hourOfDay,
                                  int minute,
                                  int second)

根据 年、月、日、时、分、秒 创建一个日期 类型为 java.util.Date

参数:

year - 年

month - 月

date - 日

hourOfDay - 时 （24小时制）

minute - 分

second - 秒

返回:

时间

createUtilDate

public static Date createUtilDate(int year,
                                  int month,
                                  int date,
                                  int hourOfDay,
                                  int minute)

根据 年、月、日、时、分 创建一个日期 类型为 java.util.Date

参数:

year - 年

month - 月

date - 日

hourOfDay - 时 （24小时制）

minute - 分

返回:

时间

createUtilDate

public static Date createUtilDate(int year,
                                  int month,
                                  int date)

根据 年、月、日 创建一个日期 类型为 java.util.Date

参数:

year - 年

month - 月

date - 日

返回:

时间

convertToUtilDate

public static Date convertToUtilDate(Date date)

日期类型转换 从 java.sql.Date 转换为 java.util.Date 这个会截断时间

参数:

date - 时间

返回:

时间

convertToSqlDate

public static Date convertToSqlDate(Date date)

日期类型转换 从 java.util.Date 转换为 java.sql.Date 这个会截断时间

参数:

date - 时间

返回:

时间

castObjectToSqlDate

public static Date castObjectToSqlDate(Object date)

convertToSqlTimestamp

public static Timestamp convertToSqlTimestamp(Date date)

日期类型转换 从 java.util.Date 转换为 java.sql.Timestamp

参数:

date - 时间

返回:

时间

castObjectToSqlTimestamp

public static Timestamp castObjectToSqlTimestamp(Object date)

currentSqlDate

public static Date currentSqlDate()

currentUtilDate

public static Date currentUtilDate()

currentSqlTimeStamp

public static Timestamp currentSqlTimeStamp()

currentCalendarDate

public static Calendar currentCalendarDate()

getDatePattern

public static String getDatePattern()

返回常量字符串 "yyyy-MM-dd"

返回:

a string representing the date pattern on the UI

getDateTimePattern

public static String getDateTimePattern()

返回:

返回常量字符串 "yyyy-MM-dd HH:mm:ss"

fetchLangLocal

public static Locale fetchLangLocal(String lang)

fetchTimeZone

public static TimeZone fetchTimeZone(String zone)

时区转换

参数:

zone - 长度为3的时区

返回:

TimeZone Zone offect

convertStringToDate

public static Date convertStringToDate(String strDate,
                                       String sMask)

This method generates a string representation of a date/time in the format you specify on input

参数:

sMask - the date pattern the string is in

strDate - a string representation of a date

返回:

a converted Date object

另请参阅:

的说明

convertDateToString

public static String convertDateToString(Date aDate,
                                         String aMask)

This method generates a string representation of a date's date/time in the format you specify on input

参数:

aMask - the date pattern the string is in

aDate - a date object

返回:

a formatted string representation of the date

另请参阅:

的说明

convertTimeToString

public static String convertTimeToString(Date aDate)

This method generates a string representation of a date based on the System Property 'dateFormat' in the format you specify on input

参数:

aDate - A date to convert

返回:

a string representation of the date

convertTimeWithSecondToString

public static String convertTimeWithSecondToString(Date aDate)

convertDateToString

public static String convertDateToString(Date aDate)

返回日期字符串 "yyyy-MM-dd"

参数:

aDate - 时间

返回:

字符串

convertDateToSmartString

public static String convertDateToSmartString(Date aDate)

convertDateToSmartString

public static String convertDateToSmartString(Date aDate,
                                              boolean withSecond)

convertDateToGMTString

public static String convertDateToGMTString(Date aDate)

返回日期字符串 toUTCString( ) 和 javaScript 一致 // d MMM yyyy HH:mm:ss 'GMT'

参数:

aDate - 时间

返回:

字符串

convertDatetimeToString

public static String convertDatetimeToString(Date aDate)

返回日期字符串 "yyyy-MM-dd HH:mm:ss"

参数:

aDate - 时间

返回:

字符串

convertTimestampToString

public static String convertTimestampToString(Date aDate)

getNowDateTime4String

public static String getNowDateTime4String()

获得当前时间字符串，格式为 "yyyy-MM-dd HH:mm:ss"

返回:

string

convertStringToDate

public static Date convertStringToDate(String strDate)

This method converts a String to a date using the datePattern

参数:

strDate - the date to convert (in format yyyy-mm-dd)

返回:

a date object

getDayOfWeek

public static int getDayOfWeek(int y,
                               int m,
                               int d)

获得 年月日 对应的日期 是星期几 星期日 到星期六 为 0-6

参数:

y - 年

m - 月

d - 日

返回:

星期几

getDayOfWeek

public static int getDayOfWeek(Date date)

获得 指定日期 是星期几 星期日 到星期六 为 0-6

参数:

date - 日期

返回:

星期几

getDayOfWeekCN

public static String getDayOfWeekCN(Date date)

获得 指定日期 是星期几 星期日 到星期六 为 "星期日","星期一","星期二","星期三","星期四","星期五","星期六"

参数:

date - 日期

返回:

星期几

getSecond

public static int getSecond(Date date)

getMilliSecond

public static int getMilliSecond(Date date)

getMinute

public static int getMinute(Date date)

getHour

public static int getHour(Date date)

getWeekOfYear

public static int getWeekOfYear(Date date)

getWeekOfMonth

public static int getWeekOfMonth(Date date)

getDay

public static int getDay(Date date)

getDayOfYear

public static int getDayOfYear(Date date)

getMonth

public static int getMonth(Date date)

getYear

public static int getYear(Date date)

truncateToSecond

public static Date truncateToSecond(Date date)

truncateToDay

public static Date truncateToDay(Date date)

truncateToMonth

public static Date truncateToMonth(Date date)

truncateToYear

public static Date truncateToYear(Date date)

seekEndOfYear

public static Date seekEndOfYear(Date date)

truncateToWeek

public static Date truncateToWeek(Date date)

获取一周第一天（周一凌晨零点）

参数:

date - 输入时间

返回:

周一凌晨0点

seekEndOfWeek

public static Date seekEndOfWeek(Date date)

获取一周最后一天（周日凌晨零点）

参数:

date - 输入时间

返回:

周日凌晨零点

seekEndOfMonth

public static Date seekEndOfMonth(Date date)

addSeconds

public static Date addSeconds(Date date,
                              int nSeconds)

addMinutes

public static Date addMinutes(Date date,
                              int nMinutes)

addHours

public static Date addHours(Date date,
                            int nHours)

addDays

public static Date addDays(Date date,
                           int nDays)

addDays

public static Date addDays(Date date,
                           float nDays)

addMonths

public static Date addMonths(Date date,
                             int nMonths)

addYears

public static Date addYears(Date date,
                            int nYears)

calcSpanDays

public static int calcSpanDays(Date beginDate,
                               Date endDate)

参数:

beginDate - beginTime

endDate - endTime

返回:

计算这个周期中的天数, 包括 beginTime，endTime

calcDateSpan

public static double calcDateSpan(Date beginDate,
                                  Date endDate)

参数:

beginDate - beginTime

endDate - endTime

返回:

计算这个周期中的天数, 不足一天用小数表示

calcWeek1stDay

public static Date calcWeek1stDay(int nYear,
                                  int nWeekNo)

calcWeekLastDay

public static Date calcWeekLastDay(int nYear,
                                   int nWeekNo)

calcWeekendDays

public static int calcWeekendDays(Date beginDate,
                                  Date endDate)

计算这个周期中的周六和周日的天数，周末的天数

参数:

beginDate - beginTime

endDate - endTime

返回:

计算这个周期中的周六和周日的天数, 包括 beginTime，endTime

calcWeekDays

public static int calcWeekDays(Date beginDate,
                               Date endDate,
                               int weekDay)

计算这个周期中 工作日的天数,不包括 周六和周日，但是因为不知道其他的假期，所以只是去掉周末

参数:

beginDate - beginTime

endDate - endTime

weekDay - 0~6 "星期日","星期一","星期二","星期三","星期四","星期五","星期六"

返回:

计算这个周期中 某个工作日的天数, 包括 beginTime，endTime

equalOnSecond

public static boolean equalOnSecond(Date oneDate,
                                    Date otherDate)

equalOnMinute

public static boolean equalOnMinute(Date oneDate,
                                    Date otherDate)

equalOnHour

public static boolean equalOnHour(Date oneDate,
                                  Date otherDate)

equalOnDay

public static boolean equalOnDay(Date oneDate,
                                 Date otherDate)

compareTwoDate

public static int compareTwoDate(Date oneDate,
                                 Date otherDate)

比较两个日期大小 ,避免 发生 NullPointerException 异常 Compares two Dates for ordering.

参数:

oneDate - the Date to be compared.

otherDate - the Date to be compared.

返回:

the value 0 if the argument otherDate is equal to oneDate ; a value less than 0 if this Date is before the Date argument; and a value greater than if oneDate is after the otherDate.

smartPraseDate

public static Date smartPraseDate(String sDate)

castObjectToDate

public static final Date castObjectToDate(Object obj)