DateUtil

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

```
public class DateUtil
extends com.seeyon.ctp.util.DateFormatFactory
```
Title: T1开发框架

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

Copyright: Copyright (c) 2012

Company: seeyon.com

从以下版本开始:

CTP2.0

字段概要
- 从类继承的字段 com.seeyon.ctp.util.DateFormatFactory
  cstDateFormatter, dateStyle, dateStyleWithoutYear, datetimeAllStyle, datetimeStartWithMonthStyle, datetimeStyle, datetimeStyleNoSeparator, datetimeWithoutSecondStyle, HOUR_MINUTE_SECOND_PATTERN, RFC822_PATTERN, YEAR_MONTH_DAY_HOUR_MINUTE_PATTERN, YEAR_MONTH_DAY_HOUR_MINUTE_SECOND_PATTERN, YEAR_MONTH_DAY_PATTERN, YMDHMS_PATTERN

构造器概要

构造器
构造器和说明

DateUtil()

构造器
构造器和说明
`DateUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static java.util.Date`	`addDay(java.util.Date date, int amount)` 将某个日期增加指定天数，并返回结果。
`static java.util.Date`	`addMonth(java.util.Date date, int amount)` 将某个日期增加指定月数，并返回结果。
`static java.lang.Integer`	`addMonth(java.lang.Integer yearMonth, int ammount)` 将给定整数形式的年月增加指定月数，并返回结果。
`static java.util.Date`	`addYear(java.util.Date date, int amount)` 将某个日期增加指定年数，并返回结果。
`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`	`getWeek(java.util.Date date)` 获取给定日期的星期数
`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`	`isValidDate(java.lang.String str)` 判断字符串是否为指定格式的时间
`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)` 将字符串转换为指定格式的时间

从类继承的方法 com.seeyon.ctp.util.DateFormatFactory
getDateInstance, getDateTimeInstance, getFullDateInstance, getLongShortDateTimeInstance, getLongTimeInstance, getSimpleDateFormat, getSimpleDateFormat, getTimeInstance

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

- 构造器详细资料
  - 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 - 日期对象
    
    返回:
    
    秒
  - getWeek
```
public static int getWeek(java.util.Date date)
```
    获取给定日期的星期数
    
    参数:
    
    date -
    
    返回:
    
    星期一返回1，星期二返回2，依次类推星期天返回7
    
    从以下版本开始:
    
    6.1
  - 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 amount)
```
    将某个日期增加指定年数，并返回结果。如果传入负数，则为减。
    
    参数:
    
    date - 要操作的日期对象
    
    amount - 要增加年的数目
    
    返回:
    
    结果日期对象
  - addMonth
```
public static java.util.Date addMonth(java.util.Date date,
                                      int amount)
```
    将某个日期增加指定月数，并返回结果。如果传入负数，则为减。
    
    参数:
    
    date - 要操作的日期对象
    
    amount - 要增加月的数目
    
    返回:
    
    结果日期对象
  - addDay
```
public static java.util.Date addDay(java.util.Date date,
                                    int amount)
```
    将某个日期增加指定天数，并返回结果。如果传入负数，则为减。
    
    参数:
    
    date - 要操作的日期对象
    
    amount - 要增加天的数目
    
    返回:
    
    结果日期对象
  - 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)
```
  - isValidDate
```
public static boolean isValidDate(java.lang.String str)
```
    判断字符串是否为指定格式的时间
    
    参数:
    
    str - 时间字符串
    
    返回:
    
    true/false

类 DateUtil

字段概要

从类继承的字段 com.seeyon.ctp.util.DateFormatFactory

构造器概要

方法概要

从类继承的方法 com.seeyon.ctp.util.DateFormatFactory

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

构造器详细资料

DateUtil

方法详细资料

newDate

currentDate

currentDateString

currentDateDefaultString

getYear

getMonth

getDay

getHour

getMinute

getSecond

getWeek

getYearMonth

parseYearMonth

addYear

addMonth

addDay

addMonth

beforeYears

beforeMonths

beforeDays

beforeRoundYears

beforeRoundAges

beforeRoundMonths

getDate

format

format

formatDateTime

parse

parse

isYearMonth

isYearMonth

getYearMonths

parseTimestamp

parseTimestamp

currentTimestamp

getStandard19DateAndTime

getByStandard19DateAndTime

getDate

getDate

getDate

getDate

getLocalDate

getLocalDate

getLocalTime

getLocalTime

getTime

getTime

get19DateAndTime

getDateAndTime

getDateAndTime

getLocalDateAndTime

getLocalDateAndTime

getYear

getMonth

getDay

toDate

toDate

isValidDate