com.tsongkha.spinnerdatepicker

Class DateUtils

java.lang.Object

com.tsongkha.spinnerdatepicker.DateUtils

public class DateUtils
extends java.lang.Object

Utility methods for processing dates.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NO_YEAR_DATE_FEB29TH When parsing a date without a year, the system assumes 1970, which wasn't a leap-year.
static java.util.TimeZone	UTC_TIMEZONE

Constructor Summary

Constructors

Constructor and Description
DateUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	formatDate(android.content.Context context, java.lang.String string) Same as formatDate(Context context, String string, boolean longForm), with longForm set to true by default.
static java.lang.String	formatDate(android.content.Context context, java.lang.String string, boolean longForm) Parses the supplied string to see if it looks like a date.
static int	getDayDifference(android.text.format.Time time, long date1, long date2) Determine the difference, in days between two dates.
static java.text.DateFormat	getLocalizedDateFormatWithoutYear(android.content.Context context) Returns a SimpleDateFormat object without the year fields by using a regular expression to eliminate the year in the string pattern.
static java.util.Date	getNextAnnualDate(java.util.Calendar target) Given a calendar (possibly containing only a day of the year), returns the earliest possible anniversary of the date that is equal to or after the current point in time if the date does not contain a year, or the date converted to the local time zone (if the date contains a year.
static boolean	isMonthBeforeDay(android.content.Context context)
static boolean	isYearSet(java.util.Calendar cal)
static java.util.Calendar	parseDate(java.lang.String string, boolean mustContainYear) Parses the supplied string to see if it looks like a date.

Methods inherited from class java.lang.Object

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

Field Detail

UTC_TIMEZONE

public static final java.util.TimeZone UTC_TIMEZONE

NO_YEAR_DATE_FEB29TH

public static final java.lang.String NO_YEAR_DATE_FEB29TH

When parsing a date without a year, the system assumes 1970, which wasn't a leap-year. Let's add a one-off hack for that day of the year

See Also:

Constant Field Values

Constructor Detail

DateUtils

public DateUtils()

Method Detail

parseDate

public static java.util.Calendar parseDate(java.lang.String string,
                                           boolean mustContainYear)

Parses the supplied string to see if it looks like a date.

Parameters:

string - The string representation of the provided date

mustContainYear - If true, the string is parsed as a date containing a year. If false, the string is parsed into a valid date even if the year field is missing.

Returns:

A Calendar object corresponding to the date if the string is successfully parsed. If not, null is returned.

isYearSet

public static boolean isYearSet(java.util.Calendar cal)

formatDate

public static java.lang.String formatDate(android.content.Context context,
                                          java.lang.String string)

Same as formatDate(Context context, String string, boolean longForm), with longForm set to true by default.

Parameters:

context - Valid context

string - String representation of a date to parse

Returns:

Returns the same date in a cleaned up format. If the supplied string does not look like a date, return it unchanged.

formatDate

public static java.lang.String formatDate(android.content.Context context,
                                          java.lang.String string,
                                          boolean longForm)

Parses the supplied string to see if it looks like a date.

Parameters:

context - Valid context

string - String representation of a date to parse

longForm - If true, return the date formatted into its long string representation. If false, return the date formatted using its short form representation (i.e. 12/11/2012)

Returns:

Returns the same date in a cleaned up format. If the supplied string does not look like a date, return it unchanged.

isMonthBeforeDay

public static boolean isMonthBeforeDay(android.content.Context context)

getLocalizedDateFormatWithoutYear

public static java.text.DateFormat getLocalizedDateFormatWithoutYear(android.content.Context context)

Returns a SimpleDateFormat object without the year fields by using a regular expression to eliminate the year in the string pattern. In the rare occurence that the resulting pattern cannot be reconverted into a SimpleDateFormat, it uses the provided context to determine whether the month field should be displayed before the day field, and returns either "MMMM dd" or "dd MMMM" converted into a SimpleDateFormat.

getNextAnnualDate

public static java.util.Date getNextAnnualDate(java.util.Calendar target)

Given a calendar (possibly containing only a day of the year), returns the earliest possible anniversary of the date that is equal to or after the current point in time if the date does not contain a year, or the date converted to the local time zone (if the date contains a year.

Parameters:

target - The date we wish to convert(in the UTC time zone).

Returns:

If date does not contain a year (year < 1900), returns the next earliest anniversary that is after the current point in time (in the local time zone). Otherwise, returns the adjusted Date in the local time zone.

getDayDifference

public static int getDayDifference(android.text.format.Time time,
                                   long date1,
                                   long date2)

Determine the difference, in days between two dates. Uses similar logic as the {android.text.format.DateUtils.getRelativeTimeSpanString} method.

Parameters:

time - Instance of time object to use for calculations.

date1 - First date to check.

date2 - Second date to check.

Returns:

The absolute difference in days between the two dates.