pt.jcodeutil.core.util
Class DateUtils

java.lang.Object
  |
  +--pt.jcodeutil.core.util.DateUtils

public final class DateUtils

extends java.lang.Object

Title: DateUtils Description: Provide some utilities to manage dates.

Version:

1.0

Author:

Marco Samuel (samuelbb@sapo.pt)

Field Summary

static java.lang.String	DATE_FORMAT1
static java.lang.String	DATE_FORMAT2
static java.lang.String	DATE_FORMAT3
static java.lang.String	DATE_FORMAT4
static java.lang.String	DATE_FORMAT5
static java.lang.String	DATETIME_TO_MINUTE
static java.lang.String	DATETIME_TO_MINUTE1
static java.lang.String	DATETIME_TO_SECOND
static java.lang.String	DATETIME_TO_SECOND1
static java.lang.String	DATETIME_TO_SECOND2
static java.lang.String	TIME_TO_MINUTE
static java.lang.String	TIME_TO_SECOND

Constructor Summary

DateUtils()

Method Summary

static java.sql.Timestamp	addDaysToTimestamp(java.sql.Timestamp time, int numberOfdays) Adds a value to the Day of a given Timestamp, return the new changed Timestamp
static java.util.Date	addDaysToUtilDate(java.util.Date date, int numberOfdays) Adds a value to the Day of a given Date, return the new changed Date
static java.sql.Timestamp	addMonthToTimestamp(java.sql.Timestamp time, int numberOfMonths) Adds a value to the Month of a given Timestamp, return the new changed Timestamp
static java.util.Date	addMonthToUtilDate(java.util.Date date, int numberOfMonths) Adds a value to the Month of a given Date, return the new changed Date
static java.sql.Timestamp	addValueToTimestamp(java.sql.Timestamp time, int value, int field) Adds a a value to a field , returning the changed Timestamp.
static java.util.Date	addValueToUtilDate(java.util.Date date, int value, int field) Adds a a value to a field , returning the changed java.util.Date.
static java.sql.Timestamp	addYearToTimestamp(java.sql.Timestamp time, int numberOfYears) Adds a value to the Year of a given Timestamp, return the new changed Timestamp
static java.util.Date	addYearToUtilDate(java.util.Date date, int numberOfYears) Adds a value to the Year of a given Date, return the new changed Date
static java.lang.String	dateToString(java.util.Date date, java.lang.String dateFormat) Converts an Util Date to a String with a given format
static java.sql.Date	separatedTimeToSQLDate(java.lang.String yField, java.lang.String mField, java.lang.String dField) Converts a separated date to a SQL Date.
static java.lang.String	separatedTimeToString(int year, int month, int day, int hour, int min, java.lang.String dateFormat) Joins the field representing a date into a String with the specified format.
static java.lang.String	separatedTimeToString(java.lang.String year, java.lang.String month, java.lang.String day, java.lang.String hour, java.lang.String min, java.lang.String dateFormat) Joins the field representing a date into a String with the specified format.
static java.sql.Timestamp	separatedTimeToTimestamp(java.lang.String yField, java.lang.String mField, java.lang.String dField, java.lang.String hourField, java.lang.String minField) Converts a separated date to a Timestamp.
static java.sql.Timestamp	stringToSQLTimestamp(java.lang.String date, java.lang.String dateFormat) Converts a String with a given format, to a SQL Timestamp.
static java.lang.String	stringToString(java.lang.String date, java.lang.String dateFormatIn, java.lang.String dateFormatOut) Converts a String with dateFormatIn, to another String with dateFormatOut
static java.util.Date	stringToUtilDate(java.lang.String date, java.lang.String dateFormat) Converts a String with a given format, to an Util Date
static java.util.Calendar	timestampToCalendar(java.sql.Timestamp time) Converts a java.sql.Timestamp to a java.util.Calendar
static java.lang.String	timestampToString(java.sql.Timestamp date, java.lang.String dateFormat) Converts a SQL Timestamp to a String with a given format
static java.util.Date	timestampToUtilDate(java.sql.Timestamp time) Converts a java.sql.Timestamp to a java.util.Date
static java.sql.Date	utilDateToSQLDate(java.util.Date dt) Converts a java.util.Date to a java.sql.Date
static java.sql.Timestamp	utilDateToSQLTimestamp(java.util.Date dt) Converts a java.util.Date to a java.sql.Timestamp

Methods inherited from class java.lang.Object

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

Field Detail

DATETIME_TO_SECOND

public static final java.lang.String DATETIME_TO_SECOND

DATETIME_TO_SECOND1

public static final java.lang.String DATETIME_TO_SECOND1

DATETIME_TO_SECOND2

public static final java.lang.String DATETIME_TO_SECOND2

DATETIME_TO_MINUTE

public static final java.lang.String DATETIME_TO_MINUTE

DATETIME_TO_MINUTE1

public static final java.lang.String DATETIME_TO_MINUTE1

TIME_TO_SECOND

public static final java.lang.String TIME_TO_SECOND

TIME_TO_MINUTE

public static final java.lang.String TIME_TO_MINUTE

DATE_FORMAT1

public static final java.lang.String DATE_FORMAT1

DATE_FORMAT2

public static final java.lang.String DATE_FORMAT2

DATE_FORMAT3

public static final java.lang.String DATE_FORMAT3

DATE_FORMAT4

public static final java.lang.String DATE_FORMAT4

DATE_FORMAT5

public static final java.lang.String DATE_FORMAT5

Constructor Detail

DateUtils

public DateUtils()

Method Detail

separatedTimeToSQLDate

public static final java.sql.Date separatedTimeToSQLDate(java.lang.String yField,
                                                         java.lang.String mField,
                                                         java.lang.String dField)
                                                  throws java.lang.NumberFormatException

Converts a separated date to a SQL Date.

Parameters:

yField -

mField -

dField -

Returns:

a SQL Date

Throws:

java.lang.NumberFormatException -

separatedTimeToTimestamp

public static final java.sql.Timestamp separatedTimeToTimestamp(java.lang.String yField,
                                                                java.lang.String mField,
                                                                java.lang.String dField,
                                                                java.lang.String hourField,
                                                                java.lang.String minField)
                                                         throws java.lang.NumberFormatException

Converts a separated date to a Timestamp.

Parameters:

yField -

mField -

dField -

hourField -

minField -

Returns:

the Timestamp that corresponds to the arguments given.

Throws:

java.lang.NumberFormatException -

separatedTimeToString

public static java.lang.String separatedTimeToString(java.lang.String year,
                                                     java.lang.String month,
                                                     java.lang.String day,
                                                     java.lang.String hour,
                                                     java.lang.String min,
                                                     java.lang.String dateFormat)
                                              throws java.lang.NumberFormatException

Joins the field representing a date into a String with the specified format.

Parameters:

year -

month -

day -

hour -

min -

dateFormat -

Returns:

String representing the time given by argument.

Throws:

java.lang.NumberFormatException -

separatedTimeToString

public static java.lang.String separatedTimeToString(int year,
                                                     int month,
                                                     int day,
                                                     int hour,
                                                     int min,
                                                     java.lang.String dateFormat)
                                              throws java.lang.NumberFormatException

Joins the field representing a date into a String with the specified format.

Parameters:

year -

month -

day -

hour -

min -

dateFormat -

Returns:

String representing the time given by argument.

Throws:

java.lang.NumberFormatException -

utilDateToSQLDate

public static final java.sql.Date utilDateToSQLDate(java.util.Date dt)

Converts a java.util.Date to a java.sql.Date

Parameters:

dt -

Returns:

the sql date

utilDateToSQLTimestamp

public static final java.sql.Timestamp utilDateToSQLTimestamp(java.util.Date dt)

Converts a java.util.Date to a java.sql.Timestamp

Parameters:

dt -

Returns:

the Timestamp

stringToString

public static final java.lang.String stringToString(java.lang.String date,
                                                    java.lang.String dateFormatIn,
                                                    java.lang.String dateFormatOut)
                                             throws java.text.ParseException

Converts a String with dateFormatIn, to another String with dateFormatOut

Parameters:

date -

dateFormatIn -

dateFormatOut -

stringToSQLTimestamp

public static final java.sql.Timestamp stringToSQLTimestamp(java.lang.String date,
                                                            java.lang.String dateFormat)
                                                     throws java.text.ParseException

Converts a String with a given format, to a SQL Timestamp.

Parameters:

date -

dateFormat -

Returns:

timestamp representing the date

stringToUtilDate

public static final java.util.Date stringToUtilDate(java.lang.String date,
                                                    java.lang.String dateFormat)
                                             throws java.text.ParseException

Converts a String with a given format, to an Util Date

Parameters:

date -

dateFormat -

Returns:

java.util.Date

timestampToString

public static final java.lang.String timestampToString(java.sql.Timestamp date,
                                                       java.lang.String dateFormat)

Converts a SQL Timestamp to a String with a given format

Parameters:

date -

dateFormat -

Returns:

a String representing the Date

dateToString

public static final java.lang.String dateToString(java.util.Date date,
                                                  java.lang.String dateFormat)

Converts an Util Date to a String with a given format

Parameters:

date -

dateFormat -

Returns:

a String representing the Date

timestampToUtilDate

public static final java.util.Date timestampToUtilDate(java.sql.Timestamp time)

Converts a java.sql.Timestamp to a java.util.Date

Parameters:

time -

Returns:

java.util.Date

timestampToCalendar

public static final java.util.Calendar timestampToCalendar(java.sql.Timestamp time)

Converts a java.sql.Timestamp to a java.util.Calendar

Parameters:

time -

Returns:

a Calendar

addDaysToTimestamp

public static final java.sql.Timestamp addDaysToTimestamp(java.sql.Timestamp time,
                                                          int numberOfdays)

Adds a value to the Day of a given Timestamp, return the new changed Timestamp

Parameters:

time -

numberOfdays -

Returns:

the timestamp with the extra days

addDaysToUtilDate

public static final java.util.Date addDaysToUtilDate(java.util.Date date,
                                                     int numberOfdays)

Adds a value to the Day of a given Date, return the new changed Date

Parameters:

date -

numberOfdays -

Returns:

the new date with the extra days

addMonthToTimestamp

public static final java.sql.Timestamp addMonthToTimestamp(java.sql.Timestamp time,
                                                           int numberOfMonths)

Adds a value to the Month of a given Timestamp, return the new changed Timestamp

Parameters:

time -

numberOfMonths -

Returns:

the new date with the extra months

addMonthToUtilDate

public static final java.util.Date addMonthToUtilDate(java.util.Date date,
                                                      int numberOfMonths)

Adds a value to the Month of a given Date, return the new changed Date

Parameters:

date -

numberOfMonths -

Returns:

the new date with the extra months

addYearToTimestamp

public static final java.sql.Timestamp addYearToTimestamp(java.sql.Timestamp time,
                                                          int numberOfYears)

Adds a value to the Year of a given Timestamp, return the new changed Timestamp

Parameters:

time -

numberOfYears -

Returns:

the new date with the extra years

addYearToUtilDate

public static final java.util.Date addYearToUtilDate(java.util.Date date,
                                                     int numberOfYears)

Adds a value to the Year of a given Date, return the new changed Date

Parameters:

date -

numberOfYears -

Returns:

the new date with the extra years

addValueToUtilDate

public static final java.util.Date addValueToUtilDate(java.util.Date date,
                                                      int value,
                                                      int field)

Adds a a value to a field , returning the changed java.util.Date. The field could be obtain through the class Calendar

Parameters:

date -

value -

field -

Returns:

the new date with the extra value (dependant on the field)

See Also:

Calendar

addValueToTimestamp

public static final java.sql.Timestamp addValueToTimestamp(java.sql.Timestamp time,
                                                           int value,
                                                           int field)

Adds a a value to a field , returning the changed Timestamp. The field could be obtain through the class Calendar

Parameters:

time -

value -

field -

Returns:

the new date with the extra value

See Also:

Calendar