com.seeyon.ctp.util
类 DateUtil

java.lang.Object
  com.seeyon.ctp.util.DateUtil

public class DateUtil
extends java.lang.Object

Title: T1开发框架

Description: 日期处理相关工具类。

Copyright: Copyright (c) 2012

Company: seeyon.com

从以下版本开始：

CTP2.0

字段摘要

static java.lang.String	HOUR_MINUTE_SECOND_PATTERN 时分秒模式字符串
static java.lang.String	YEAR_MONTH_DAY_HOUR_MINUTE_SECOND_PATTERN 年月日 时分秒模式字符串
static java.lang.String	YEAR_MONTH_DAY_PATTERN 年月日模式字符串
static java.lang.String	YMDHMS_PATTERN 年月日时分秒模式字符串

构造方法摘要

DateUtil()

方法摘要

static java.util.Date	addDay(java.util.Date date, int ammount) 将某个日期增加指定天数，并返回结果。
static java.util.Date	addMonth(java.util.Date date, int ammount) 将某个日期增加指定月数，并返回结果。
static java.lang.Integer	addMonth(java.lang.Integer yearMonth, int ammount) 将给定整数形式的年月增加指定月数，并返回结果。
static java.util.Date	addYear(java.util.Date date, int ammount) 将某个日期增加指定年数，并返回结果。
static int	beforeDays(java.util.Date beforeDate, java.util.Date afterDate) 返回给定的beforeDate比afterDate早的天数。
static int	beforeMonths(java.util.Date beforeDate, java.util.Date afterDate) 返回给定的beforeDate比afterDate早的月数。
static int	beforeRoundAges(java.util.Date beforeDate, java.util.Date afterDate) 获取beforeDate和afterDate之间相差的完整年数，精确到月。
static int	beforeRoundMonths(java.util.Date beforeDate, java.util.Date afterDate) 获取beforeDate和afterDate之间相差的完整月数，精确到天。
static int	beforeRoundYears(java.util.Date beforeDate, java.util.Date afterDate) 获取beforeDate和afterDate之间相差的完整年数，精确到天。
static int	beforeYears(java.util.Date beforeDate, java.util.Date afterDate) 返回给定的beforeDate比afterDate早的年数。
static java.util.Date	currentDate() 从数据库服务器获取当前时间。
static java.lang.String	currentDateDefaultString() 从数据库服务器获取当前时间并转换成默认字符串形式（yyyy-MM-dd）。
static java.lang.String	currentDateString(java.lang.String pattern) 从数据库服务器获取当前时间并根据传入的patter转换成字符串形式。
static java.sql.Timestamp	currentTimestamp() 从数据库服务器获取当前时间 并返回Timestamp类型时间。
static java.lang.String	format(java.util.Date date) 将传入的日期按照默认形势转换成字符串（yyyy-MM-dd）
static java.lang.String	format(java.util.Date date, java.lang.String pattern) 根据传入的日期格式化pattern将传入的日期格式化成字符串。
static java.lang.String	formatDateTime(java.util.Date date) 获取（yyyy-MM-dd HH:mm:ss）格式的日期时间
static java.lang.String	get19DateAndTime() 得到以yyyy-MM-dd HH:mm:ss显示的当前系统时间
static java.util.Date	getByStandard19DateAndTime(java.lang.String dateStr) 将标准的19为日期格式字符串转换成日期对象
static java.lang.String	getDate() 获取当前系统日期
static java.lang.String	getDate(java.util.Date d) 得到指定日期的格式化字符串
static java.lang.String	getDate(java.util.Date date, java.lang.String format) 将日期按指定的格式字符串格式化
static java.util.Date	getDate(int year, int month, int date) 根据传入的年、月、日构造日期对象
static java.lang.String	getDate(java.lang.String format) 获取指定输出格式的当前系统日期
static java.lang.String	getDateAndTime() 获取系统时间的格式化日期与时间
static java.lang.String	getDateAndTime(java.util.Date d) 获取指定Date的格式化日期与时间
static int	getDay() 得到当前日
static int	getDay(java.util.Date date) 获取给定日期对象的天
static int	getHour(java.util.Date date) 获取给定日期对象的时
static java.lang.String	getLocalDate() 获取当前日期的中文显示名
static java.lang.String	getLocalDate(java.util.Date d) 获取指定日期的中文显示名
static java.lang.String	getLocalDateAndTime() 获取系统时间的格式化日期与时间
static java.lang.String	getLocalDateAndTime(java.util.Date d) 获取指定Date的中文日期与时间
static java.lang.String	getLocalTime() 获取当前时间的中文显示名
static java.lang.String	getLocalTime(java.util.Date d) 获取指定时间的中文显示名
static int	getMinute(java.util.Date date) 获取给定日期对象的分
static int	getMonth() 得到当前月
static int	getMonth(java.util.Date date) 获取给定日期对象的月
static int	getSecond(java.util.Date date) 获取给定日期对象的秒
static java.lang.String	getStandard19DateAndTime(java.util.Date date) 将日期转换为标准的19位日期格式字符串
static java.lang.String	getTime() 获取系统时间的格式化时间
static java.lang.String	getTime(java.util.Date d) 获取格式化时间
static int	getYear() 得到当前年
static int	getYear(java.util.Date date) 获取给定日期对象的年
static java.lang.Integer	getYearMonth(java.util.Date date) 获取传入日期的年和月的Integer形式（yyyyMM）。
static java.util.List	getYearMonths(java.lang.Integer from, java.lang.Integer to) 获取从from到to的年月Integer形式值的列表
static boolean	isYearMonth(java.lang.Integer yearMonth) 要进行合法性验证的年月数值
static boolean	isYearMonth(java.lang.String yearMonthStr) 要进行合法性验证的年月字符串
static java.util.Date	newDate() 取得应用服务器的当前时间，与new Date()得到的值的差别时。
static java.util.Date	parse(java.lang.String dateStr) 将传入的字符串按照默认格式转换为日期对象（yyyy-MM-dd）
static java.util.Date	parse(java.lang.String dateStr, java.lang.String pattern) 根据传入的日期格式化patter将传入的字符串转换成日期对象
static java.sql.Timestamp	parseTimestamp(java.lang.String dateStr) 将传入的字符串按照默认格式转换为Timestamp对象（yyyy-MM-dd）
static java.sql.Timestamp	parseTimestamp(java.lang.String dateStr, java.lang.String pattern) 根据传入的日期格式化patter将传入的字符串转换成Timstamp对象
static java.util.Date	parseYearMonth(java.lang.Integer yearMonth) 将年月的整数形式（yyyyMM）转换为日期对象返回。
static java.util.Date	toDate(java.lang.String date)
static java.util.Date	toDate(java.lang.String date, java.lang.String pattern) 将字符串转换为指定格式的时间

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

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

字段详细信息

YEAR_MONTH_DAY_HOUR_MINUTE_SECOND_PATTERN

public static final java.lang.String YEAR_MONTH_DAY_HOUR_MINUTE_SECOND_PATTERN

年月日 时分秒模式字符串

另请参见：

常量字段值

YEAR_MONTH_DAY_PATTERN

public static final java.lang.String YEAR_MONTH_DAY_PATTERN

年月日模式字符串

另请参见：

常量字段值

HOUR_MINUTE_SECOND_PATTERN

public static final java.lang.String HOUR_MINUTE_SECOND_PATTERN

时分秒模式字符串

另请参见：

常量字段值

YMDHMS_PATTERN

public static final java.lang.String YMDHMS_PATTERN

年月日时分秒模式字符串

另请参见：

常量字段值

构造方法详细信息

DateUtil

public DateUtil()

方法详细信息

newDate

public static java.util.Date newDate()

取得应用服务器的当前时间，与new Date()得到的值的差别时。按在当前线程的调用顺序与当前真实时间有一定偏移，以体现顺序。

返回：

当前时间。

currentDate

public static java.util.Date currentDate()

从数据库服务器获取当前时间。

返回：

返回当前时间

currentDateString

public static java.lang.String currentDateString(java.lang.String pattern)

从数据库服务器获取当前时间并根据传入的patter转换成字符串形式。

参数：

pattern - 日期pattern

返回：

返回当前时间根据传入pattern转换后的字符串

currentDateDefaultString

public static java.lang.String currentDateDefaultString()

从数据库服务器获取当前时间并转换成默认字符串形式（yyyy-MM-dd）。

返回：

返回当前时间的默认字符串形式（yyyy-MM-dd）

getYear

public static int getYear(java.util.Date date)

获取给定日期对象的年

参数：

date - 日期对象

返回：

年

getMonth

public static int getMonth(java.util.Date date)

获取给定日期对象的月

参数：

date - 日期对象

返回：

月

getDay

public static int getDay(java.util.Date date)

获取给定日期对象的天

参数：

date - 日期对象

返回：

天

getHour

public static int getHour(java.util.Date date)

获取给定日期对象的时

参数：

date - 日期对象

返回：

时

getMinute

public static int getMinute(java.util.Date date)

获取给定日期对象的分

参数：

date - 日期对象

返回：

分

getSecond

public static int getSecond(java.util.Date date)

获取给定日期对象的秒

参数：

date - 日期对象

返回：

秒

getYearMonth

public static java.lang.Integer getYearMonth(java.util.Date date)

获取传入日期的年和月的Integer形式（yyyyMM）。

参数：

date - 要转换的日期对象

返回：

转换后的Integer对象

parseYearMonth

public static java.util.Date parseYearMonth(java.lang.Integer yearMonth)
                                     throws java.text.ParseException

将年月的整数形式（yyyyMM）转换为日期对象返回。

参数：

yearMonth - 年月的整数形式（yyyyMM）

返回：

日期类型

抛出：

java.text.ParseException

addYear

public static java.util.Date addYear(java.util.Date date,
                                     int ammount)

将某个日期增加指定年数，并返回结果。如果传入负数，则为减。

参数：

date - 要操作的日期对象

ammount - 要增加年的数目

返回：

结果日期对象

addMonth

public static java.util.Date addMonth(java.util.Date date,
                                      int ammount)

将某个日期增加指定月数，并返回结果。如果传入负数，则为减。

参数：

date - 要操作的日期对象

ammount - 要增加月的数目

返回：

结果日期对象

addDay

public static java.util.Date addDay(java.util.Date date,
                                    int ammount)

将某个日期增加指定天数，并返回结果。如果传入负数，则为减。

参数：

date - 要操作的日期对象

ammount - 要增加天的数目

返回：

结果日期对象

addMonth

public static java.lang.Integer addMonth(java.lang.Integer yearMonth,
                                         int ammount)
                                  throws java.text.ParseException

将给定整数形式的年月增加指定月数，并返回结果。如果传入负数，则为减。

参数：

yearMonth - 要操作的年月

ammount - 要增加的月数

返回：

结果年月

抛出：

java.text.ParseException

beforeYears

public static int beforeYears(java.util.Date beforeDate,
                              java.util.Date afterDate)

返回给定的beforeDate比afterDate早的年数。如果beforeDate晚于afterDate，则 返回负数。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的年数，负数表示晚。

beforeMonths

public static int beforeMonths(java.util.Date beforeDate,
                               java.util.Date afterDate)

返回给定的beforeDate比afterDate早的月数。如果beforeDate晚于afterDate，则 返回负数。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的月数，负数表示晚。

beforeDays

public static int beforeDays(java.util.Date beforeDate,
                             java.util.Date afterDate)

返回给定的beforeDate比afterDate早的天数。如果beforeDate晚于afterDate，则 返回负数。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的天数，负数表示晚。

beforeRoundYears

public static int beforeRoundYears(java.util.Date beforeDate,
                                   java.util.Date afterDate)

获取beforeDate和afterDate之间相差的完整年数，精确到天。负数表示晚。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的完整年数，负数表示晚。

beforeRoundAges

public static int beforeRoundAges(java.util.Date beforeDate,
                                  java.util.Date afterDate)

获取beforeDate和afterDate之间相差的完整年数，精确到月。负数表示晚。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的完整年数，负数表示晚。

beforeRoundMonths

public static int beforeRoundMonths(java.util.Date beforeDate,
                                    java.util.Date afterDate)

获取beforeDate和afterDate之间相差的完整月数，精确到天。负数表示晚。

参数：

beforeDate - 要比较的早的日期

afterDate - 要比较的晚的日期

返回：

beforeDate比afterDate早的完整月数，负数表示晚。

getDate

public static java.util.Date getDate(int year,
                                     int month,
                                     int date)

根据传入的年、月、日构造日期对象

参数：

year - 年

month - 月

date - 日

返回：

返回根据传入的年、月、日构造的日期对象

format

public static java.lang.String format(java.util.Date date,
                                      java.lang.String pattern)

根据传入的日期格式化pattern将传入的日期格式化成字符串。

参数：

date - 要格式化的日期对象

pattern - 日期格式化pattern

返回：

格式化后的日期字符串

format

public static java.lang.String format(java.util.Date date)

将传入的日期按照默认形势转换成字符串（yyyy-MM-dd）

参数：

date - 要格式化的日期对象

返回：

格式化后的日期字符串

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date)

获取（yyyy-MM-dd HH:mm:ss）格式的日期时间

参数：

date - 要格式化的日期对象

返回：

格式化后的日期字符串

parse

public static java.util.Date parse(java.lang.String dateStr,
                                   java.lang.String pattern)
                            throws java.text.ParseException

根据传入的日期格式化patter将传入的字符串转换成日期对象

参数：

dateStr - 要转换的字符串

pattern - 日期格式化pattern

返回：

转换后的日期对象

抛出：

java.text.ParseException - 如果传入的字符串格式不合法

parse

public static java.util.Date parse(java.lang.String dateStr)
                            throws java.text.ParseException

将传入的字符串按照默认格式转换为日期对象（yyyy-MM-dd）

参数：

dateStr - 要转换的字符串

返回：

转换后的日期对象

抛出：

java.text.ParseException - 如果传入的字符串格式不符合默认格式（如果传入的字符串格式不合法）

isYearMonth

public static boolean isYearMonth(java.lang.Integer yearMonth)

要进行合法性验证的年月数值

参数：

yearMonth - 验证年月数值

返回：

年月是否合法

isYearMonth

public static boolean isYearMonth(java.lang.String yearMonthStr)

要进行合法性验证的年月字符串

参数：

yearMonthStr - 验证年月字符串

返回：

年月是否合法

getYearMonths

public static java.util.List getYearMonths(java.lang.Integer from,
                                           java.lang.Integer to)
                                    throws java.text.ParseException

获取从from到to的年月Integer形式值的列表

参数：

from - 从

to - 到

返回：

年月Integer形式值列表

抛出：

java.text.ParseException

parseTimestamp

public static java.sql.Timestamp parseTimestamp(java.lang.String dateStr,
                                                java.lang.String pattern)
                                         throws java.text.ParseException

根据传入的日期格式化patter将传入的字符串转换成Timstamp对象

参数：

dateStr - 要转换的字符串

pattern - 日期格式化pattern

返回：

转换后的日期对象

抛出：

java.text.ParseException - 如果传入的字符串格式不合法

parseTimestamp

public static java.sql.Timestamp parseTimestamp(java.lang.String dateStr)
                                         throws java.text.ParseException

将传入的字符串按照默认格式转换为Timestamp对象（yyyy-MM-dd）

参数：

dateStr - 要转换的字符串

返回：

转换后的日期对象

抛出：

java.text.ParseException - 如果传入的字符串格式不符合默认格式（如果传入的字符串格式不合法）

currentTimestamp

public static java.sql.Timestamp currentTimestamp()

从数据库服务器获取当前时间 并返回Timestamp类型时间。

返回：

返回当前时间

getStandard19DateAndTime

public static java.lang.String getStandard19DateAndTime(java.util.Date date)

将日期转换为标准的19位日期格式字符串

参数：

date - 要转换的日期

返回：

转换成的日期格式字符串（如果date为null，那么结果是""）

getByStandard19DateAndTime

public static java.util.Date getByStandard19DateAndTime(java.lang.String dateStr)

将标准的19为日期格式字符串转换成日期对象

参数：

dateStr - 要转换的日期字符串

返回：

转换后的日期

getDate

public static java.lang.String getDate()

获取当前系统日期

返回：

日期字符串

getDate

public static java.lang.String getDate(java.lang.String format)

获取指定输出格式的当前系统日期

参数：

format - 格式字符串

返回：

当前系统日期

getDate

public static java.lang.String getDate(java.util.Date date,
                                       java.lang.String format)

将日期按指定的格式字符串格式化

参数：

date - 日期

format - 格式化字符串

返回：

日期字符串

getDate

public static java.lang.String getDate(java.util.Date d)

得到指定日期的格式化字符串

参数：

d - 日期

返回：

格式化日期

getLocalDate

public static java.lang.String getLocalDate(java.util.Date d)

获取指定日期的中文显示名

参数：

d - 日期

返回：

中文日期

getLocalDate

public static java.lang.String getLocalDate()

获取当前日期的中文显示名

返回：

中文显示名

getLocalTime

public static java.lang.String getLocalTime()

获取当前时间的中文显示名

返回：

中文显示时间

getLocalTime

public static java.lang.String getLocalTime(java.util.Date d)

获取指定时间的中文显示名

参数：

d - 时间

返回：

中文时间

getTime

public static java.lang.String getTime(java.util.Date d)

获取格式化时间

参数：

d - 时间

返回：

格式化时间

getTime

public static java.lang.String getTime()

获取系统时间的格式化时间

返回：

格式化时间

get19DateAndTime

public static java.lang.String get19DateAndTime()

得到以yyyy-MM-dd HH:mm:ss显示的当前系统时间

返回：

系统时间字符串

getDateAndTime

public static java.lang.String getDateAndTime()

获取系统时间的格式化日期与时间

返回：

格式化日期与时间

getDateAndTime

public static java.lang.String getDateAndTime(java.util.Date d)

获取指定Date的格式化日期与时间

参数：

d - 时间

返回：

格式化日期与时间

getLocalDateAndTime

public static java.lang.String getLocalDateAndTime()

获取系统时间的格式化日期与时间

返回：

中文日期与时间

getLocalDateAndTime

public static java.lang.String getLocalDateAndTime(java.util.Date d)

获取指定Date的中文日期与时间

参数：

d - 时间

返回：

中文日期与时间

getYear

public static int getYear()

得到当前年

返回：

年

getMonth

public static int getMonth()

得到当前月

返回：

月

getDay

public static int getDay()

得到当前日

返回：

日

toDate

public static java.util.Date toDate(java.lang.String date,
                                    java.lang.String pattern)

将字符串转换为指定格式的时间

参数：

date - 时间字符串

pattern - 格式

返回：

时间对象

toDate

public static java.util.Date toDate(java.lang.String date)