org.nanoj.util

Class DateUtil

java.lang.Object

org.nanoj.util.DateUtil

public final class DateUtil
extends Object

Utility class for DATE operations ( set of static methods )

Author:

Laurent GUERIN

Method Summary

Methods

Modifier and Type	Method and Description
static String	dateISO(Date date) Returns the given date as an ISO date string ( "YYYY-MM-DD" )
static String	dateTimeISO(Date date) Returns the given date as an ISO date and time string ( "YYYY-MM-DD HH:MM:SS" )
static String	format(Date date, String sFormat) Format the given date using the given format
static String	format(int iDay, int iMonth, int iYear) Format the given day, month and year ( in ISO format )
static String	format(int iDay, int iMonth, int iYear, String sFormat) Format the given day, month and year
static int	getDay(Date date) Returns the day of the month for the given date
static int	getMonth(Date date) Returns the month of the given date
static Date	getSqlDate(int iDay, int iMonth, int iYear) Returns a java.sql.Date instance for the given day, month and year
static Date	getUtilDate(int iDay, int iMonth, int iYear) Returns a standard java.util.Date instance for the given day, month and year
static int	getYear(Date date) Returns the year of the given date
static Date	parse(String sDate) Returns the Date instance corresponding to the given date/time/datetime parameter in ISO format : . "" or null : returns null .
static Date	parseDate(String sDate) Parse the given date ( supposed to be in ISO format : "YYYY-MM-DD" )
static Date	parseDateTime(String sDateTime) Parse the given date & time ( supposed to be in ISO format : "YYYY-MM-DD HH:MM:SS" )
static Date	parseTime(String sTime) Parse the given time ( supposed to be in ISO format : "HH:MM:SS" )
static String	timeISO(Date date) Returns the given date as an ISO time string ( "HH:MM:SS" )
static Date	todaySqlDate() Returns the current date as java.sql.Date
static String	todayString(String sFormat) Returns the current date as a String formated with the given format
static Date	todayUtilDate() Returns the current date as java.util.Date

Methods inherited from class java.lang.Object

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

Method Detail

todaySqlDate

public static Date todaySqlDate()

Returns the current date as java.sql.Date

Returns:

the current date

todayUtilDate

public static Date todayUtilDate()

Returns the current date as java.util.Date

Returns:

the current date

todayString

public static String todayString(String sFormat)

Returns the current date as a String formated with the given format

Parameters:

sFormat - the format to apply

Returns:

the current date

format

public static String format(int iDay,
            int iMonth,
            int iYear,
            String sFormat)

Format the given day, month and year

Parameters:

iDay - the day ( 1 to 31 )

iMonth - the month ( 1 to 12 )

iYear - the year

sFormat - the format string usable to build a SimpleDateFormat

Returns:

the formated date ( using the given format )

format

public static String format(int iDay,
            int iMonth,
            int iYear)

Format the given day, month and year ( in ISO format )

Parameters:

iDay - the day ( 1 to 31 )

iMonth - ( 1 to 12 )

iYear - the year

Returns:

the formated date ( using the default ISO format )

format

public static String format(Date date,
            String sFormat)

Format the given date using the given format

Parameters:

date -

sFormat -

Returns:

the formated date

Since:

1.0.3

getSqlDate

public static Date getSqlDate(int iDay,
              int iMonth,
              int iYear)

Returns a java.sql.Date instance for the given day, month and year

Parameters:

iDay - the day ( 1 to 31 )

iMonth - the month ( 1 to 12 )

iYear - the year

Returns:

the resulting date

getUtilDate

public static Date getUtilDate(int iDay,
               int iMonth,
               int iYear)

Returns a standard java.util.Date instance for the given day, month and year

Parameters:

iDay - the day ( 1 to 31 )

iMonth - the month ( 1 to 12 )

iYear - the year

Returns:

the resulting date

getDay

public static int getDay(Date date)

Returns the day of the month for the given date

Parameters:

date -

Returns:

the day ( from 1 to 31 )

getMonth

public static int getMonth(Date date)

Returns the month of the given date

Parameters:

date - :

Returns:

the month ( from 1 to 12 )

getYear

public static int getYear(Date date)

Returns the year of the given date

Parameters:

date - :

Returns:

the year

dateISO

public static String dateISO(Date date)

Returns the given date as an ISO date string ( "YYYY-MM-DD" )

Parameters:

date -

Returns:

the date in ISO string format ( or "" if null )

timeISO

public static String timeISO(Date date)

Returns the given date as an ISO time string ( "HH:MM:SS" )

Parameters:

date -

Returns:

the time in ISO string format ( or "" if null )

dateTimeISO

public static String dateTimeISO(Date date)

Returns the given date as an ISO date and time string ( "YYYY-MM-DD HH:MM:SS" )

Parameters:

date -

Returns:

the date and time in ISO string format ( or "" if null )

parse

public static Date parse(String sDate)

Returns the Date instance corresponding to the given date/time/datetime parameter in ISO format :
. "" or null : returns null
. "YYYY-MM-DD" : returns date
. "HH:MM:SS" : returns time
. "YYYY-MM-DD HH:MM:SS" : returns date and time

Parameters:

sDate -

Returns:

java.util.Date instance or null if the given String is null or void

Throws:

RuntimeException - if the given string cannot be converted

Since:

1.0.2

parseDate

public static Date parseDate(String sDate)

Parse the given date ( supposed to be in ISO format : "YYYY-MM-DD" )

Parameters:

sDate -

Returns:

date or null if the given string is null or void

Throws:

TelosysRuntimeException - if the date is invalid

Since:

1.0.2

parseTime

public static Date parseTime(String sTime)

Parse the given time ( supposed to be in ISO format : "HH:MM:SS" )

Parameters:

sTime -

Returns:

time or null if the given string is null or void

Throws:

TelosysRuntimeException - if the time is invalid

Since:

1.0.2

parseDateTime

public static Date parseDateTime(String sDateTime)

Parse the given date & time ( supposed to be in ISO format : "YYYY-MM-DD HH:MM:SS" )

Parameters:

sDateTime -

Returns:

date with time or null if the given string is null or void

Throws:

TelosysRuntimeException - if the time is invalid

Since:

1.0.2