org.javarosa.core.model.utils

Class DateUtils

java.lang.Object

org.javarosa.core.model.utils.DateUtils

public class DateUtils
extends Object

Static utility methods for Dates in j2me

Author:

Clayton Sims

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DateUtils.DateFields

Field Summary

Fields

Modifier and Type	Field and Description
static long	DAY_IN_MS
static int	FORMAT_HUMAN_READABLE_DAYS_FROM_TODAY
static int	FORMAT_HUMAN_READABLE_SHORT
static int	FORMAT_ISO8601
static int	FORMAT_TIMESTAMP_HTTP RFC 822
static int	FORMAT_TIMESTAMP_SUFFIX

Constructor Summary

Constructors

Constructor and Description
DateUtils()

Method Summary

Modifier and Type	Method and Description
static Date	dateAdd(Date d, int n) add n days to date d
static int	dateDiff(Date a, Date b) return the number of days between a and b, positive if b is later than a
static int	daysInMonth(int month, int year) Returns the number of days in the month given for a given year.
static int	daysSinceEpoch(Date date)
static double	decimalTimeOfLocalDay(Date d) Returns the fractional time within the local day.
static String	format(Date d, String format)
static String	format(DateUtils.DateFields f, String format)
static String	formatDate(Date d, int format)
static String	formatDateTime(Date d, int format)
static String	formatDateToTimeStamp(Date date)
static String	formatTime(Date d, int format)
static Double	fractionalDaysSinceEpoch(Date a)
static String	get24HourTimeFromDate(Date d)
static Date	getDate(DateUtils.DateFields f)
static Date	getDate(DateUtils.DateFields f, String timezone)
static Date	getDate(int year, int month, int day)
static Date	getDateFromString(String value)
static Date	getDateTimeFromString(String value)
static DateUtils.DateFields	getFields(Date d)
static DateUtils.DateFields	getFields(Date d, String timezone)
static int	getMonthsDifference(Date earlierDate, Date laterDate) Gets the number of months separating the two dates.
static Date	getPastPeriodDate(Date ref, String type, String start, boolean beginning, boolean includeToday, int nAgo) Creates a Date object representing the amount of time between the reference date, and the given parameters.
static String	getShortStringValue(Date val)
static String	getXMLStringValue(Date val)
static String	intPad(int n, int pad) Converts an integer to a string, ensuring that the string contains a certain number of digits
static boolean	isLeap(int year) Determines whether a year is a leap year in the proleptic Gregorian calendar.
static Date	parseDate(String str)
static Date	parseDateTime(String str)
static Date	parseTime(String str)
static Date	parseTimeWithFixedDate(String str, DateUtils.DateFields fields)
static Date	roundDate(Date d)
static List<String>	split(String str, String delimiter, boolean combineMultipleDelimiters) Tokenizes a string based on the given delimiter string
static boolean	stringContains(String string, String substring)
static Date	today()

Methods inherited from class java.lang.Object

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

Field Detail

FORMAT_ISO8601

public static final int FORMAT_ISO8601

See Also:

Constant Field Values

FORMAT_HUMAN_READABLE_SHORT

public static final int FORMAT_HUMAN_READABLE_SHORT

See Also:

Constant Field Values

FORMAT_HUMAN_READABLE_DAYS_FROM_TODAY

public static final int FORMAT_HUMAN_READABLE_DAYS_FROM_TODAY

See Also:

Constant Field Values

FORMAT_TIMESTAMP_SUFFIX

public static final int FORMAT_TIMESTAMP_SUFFIX

See Also:

Constant Field Values

FORMAT_TIMESTAMP_HTTP

public static final int FORMAT_TIMESTAMP_HTTP

RFC 822

See Also:

Constant Field Values

DAY_IN_MS

public static final long DAY_IN_MS

See Also:

Constant Field Values

Constructor Detail

DateUtils

public DateUtils()

Method Detail

getFields

public static DateUtils.DateFields getFields(Date d)

getFields

public static DateUtils.DateFields getFields(Date d,
                                             String timezone)

getDate

public static Date getDate(DateUtils.DateFields f)

getDate

public static Date getDate(DateUtils.DateFields f,
                           String timezone)

formatDateTime

public static String formatDateTime(Date d,
                                    int format)

formatDate

public static String formatDate(Date d,
                                int format)

formatTime

public static String formatTime(Date d,
                                int format)

format

public static String format(Date d,
                            String format)

format

public static String format(DateUtils.DateFields f,
                            String format)

parseDateTime

public static Date parseDateTime(String str)

parseDate

public static Date parseDate(String str)

parseTime

public static Date parseTime(String str)

parseTimeWithFixedDate

public static Date parseTimeWithFixedDate(String str,
                                          DateUtils.DateFields fields)

getDate

public static Date getDate(int year,
                           int month,
                           int day)

roundDate

public static Date roundDate(Date d)

Returns:

new Date object with same date but time set to midnight (in current timezone)

today

public static Date today()

decimalTimeOfLocalDay

public static double decimalTimeOfLocalDay(Date d)

Returns the fractional time within the local day.

Parameters:

d -

Returns:

daysInMonth

public static int daysInMonth(int month,
                              int year)

Returns the number of days in the month given for a given year.

Parameters:

month - The month to be tested

year - The year in which the month is to be tested

Returns:

the number of days in the given month on the given year.

isLeap

public static boolean isLeap(int year)

Determines whether a year is a leap year in the proleptic Gregorian calendar.

Parameters:

year - The year to be tested

Returns:

True, if the year given is a leap year, false otherwise.

getPastPeriodDate

public static Date getPastPeriodDate(Date ref,
                                     String type,
                                     String start,
                                     boolean beginning,
                                     boolean includeToday,
                                     int nAgo)

Creates a Date object representing the amount of time between the reference date, and the given parameters.

Parameters:

ref - The starting reference date

type - "week", or "month", representing the time period which is to be returned.

start - "sun", "mon", ... etc. representing the start of the time period.

beginning - true=return first day of period, false=return last day of period

includeToday - Whether to include the current date in the returned calculation

nAgo - How many periods ago. 1=most recent period, 0=period in progress

Returns:

a Date object representing the amount of time between the reference date, and the given parameters.

getMonthsDifference

public static int getMonthsDifference(Date earlierDate,
                                      Date laterDate)

Gets the number of months separating the two dates.

Parameters:

earlierDate - The earlier date, chronologically

laterDate - The later date, chronologically

Returns:

the number of months separating the two dates.

daysSinceEpoch

public static int daysSinceEpoch(Date date)

Parameters:

date - the date object to be analyzed

Returns:

The number of days (as a double precision floating point) since the Epoch

fractionalDaysSinceEpoch

public static Double fractionalDaysSinceEpoch(Date a)

dateAdd

public static Date dateAdd(Date d,
                           int n)

add n days to date d

Parameters:

d -

n -

Returns:

dateDiff

public static int dateDiff(Date a,
                           Date b)

return the number of days between a and b, positive if b is later than a

Parameters:

a -

b -

Returns:

# days difference

split

public static List<String> split(String str,
                                 String delimiter,
                                 boolean combineMultipleDelimiters)

Tokenizes a string based on the given delimiter string

Parameters:

str - The string to be split

delimiter - The delimeter to be used

Returns:

An array of strings contained in original which were seperated by the delimeter

intPad

public static String intPad(int n,
                            int pad)

Converts an integer to a string, ensuring that the string contains a certain number of digits

Parameters:

n - The integer to be converted

pad - The length of the string to be returned

Returns:

A string representing n, which has pad - #digits(n) 0's preceding the number.

formatDateToTimeStamp

public static String formatDateToTimeStamp(Date date)

getShortStringValue

public static String getShortStringValue(Date val)

getXMLStringValue

public static String getXMLStringValue(Date val)

get24HourTimeFromDate

public static String get24HourTimeFromDate(Date d)

getDateFromString

public static Date getDateFromString(String value)

getDateTimeFromString

public static Date getDateTimeFromString(String value)

stringContains

public static boolean stringContains(String string,
                                     String substring)