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 Description

static class DateUtils.DateFields

Field Summary

Fields
Modifier and Type	Field	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 Description

DateUtils()

Method Summary

Modifier and Type	Method	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(int year, int month, int day)`
`static Date`	`getDate(DateUtils.DateFields f)`
`static Date`	`getDate(DateUtils.DateFields f, String timezone)`
`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 Details
- 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 Details
- DateUtils
  
  public DateUtils()
Method Details
- 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)

Class DateUtils

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Details

Constructor Details

Method Details