com.qcadoo.localization.api.utils

Class DateUtils

java.lang.Object

com.qcadoo.localization.api.utils.DateUtils

public final class DateUtils
extends Object

Utility for date localization.

Since:

0.4.0

Field Summary

Fields

Modifier and Type	Field and Description
static String	L_DATE_FORMAT Date format.
static String	L_DATE_TIME_FORMAT Date-time format.
static String	L_REPORT_DATE_TIME_FORMAT Date-time format for report files.

Method Summary

Modifier and Type	Method and Description
static Date	copy(Date date)
static Date	parseAndComplete(String dateExpression, boolean upComplete) Parse string into date, with autocomplete missing month, day, hour, minute and second.
static Date	parseDate(Object value) Parse date from object
static String	toDateString(Date date) Get date's String value in format
static String	toDateTimeString(Date date) Get date's String value in format
static <any>	tryParse(Object value)

Methods inherited from class java.lang.Object

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

Field Detail

L_DATE_FORMAT

public static final String L_DATE_FORMAT

Date format.

See Also:

Constant Field Values

L_DATE_TIME_FORMAT

public static final String L_DATE_TIME_FORMAT

Date-time format.

See Also:

Constant Field Values

L_REPORT_DATE_TIME_FORMAT

public static final String L_REPORT_DATE_TIME_FORMAT

Date-time format for report files.

See Also:

Constant Field Values

Method Detail

copy

public static Date copy(Date date)

parseAndComplete

public static Date parseAndComplete(String dateExpression,
                                    boolean upComplete)
                             throws ParseException

Parse string into date, with autocomplete missing month, day, hour, minute and second. Examples with up-complete:

• 2010: 2010-12-31 23:59:59
• 2010-03: 2010-03-31 23:59:59
• 2010-03-06: 2010-03-06 23:59:59
• 2010-03-06 19: 2010-03-06 19:59:59
• 2010-03-06 19:30: 2010-03-06 19:30:59
• 2010-03-06 19:30:20: 2010-03-06 19:30:20

Examples with down-complete:

• 2010: 2010-01-01 00:00:00
• 2010-03: 2010-03-01 00:00:00
• 2010-03-06: 2010-03-06 00:00:00
• 2010-03-06 19: 2010-03-06 19:00:00
• 2010-03-06 19:30: 2010-03-06 19:30:00
• 2010-03-06 19:30:20: 2010-03-06 19:30:20

Parameters:

dateExpression - string with date expression

upComplete - true if up-complete, otherwise down-complete

Returns:

parsed date

Throws:

ParseException - if year, month, day, hour, minute or second is invalid or when year is < 1500 or > 2500

parseDate

public static Date parseDate(Object value)

Parse date from object

Parameters:

value - object to be parsed. Supported argument types:

• String - representing date in or format
• Date
• Number - containing number of milliseconds from 1st January 1970 00:00:00.000 GMT

Returns:

Date parsed from given object or null if object is null

Throws:

IllegalArgumentException - if value is unsupported or has incorrect format

toDateString

public static String toDateString(Date date)

Get date's String value in format

Parameters:

date - date to be formatted

Returns:

date as String in format or empty string if date is null

toDateTimeString

public static String toDateTimeString(Date date)

Get date's String value in format

Parameters:

date - date to be formatted

Returns:

date as String in format or empty string if date is null

tryParse

public static <any> tryParse(Object value)