com.aquafold.openapi.type

Interface AQDate

public interface AQDate

AQDate represents an immutable calendar date value, based on GregorianCalendar.

An instance of this interface can be obtained via one of the newDate() methods in AQDateFactory, or one of the addXXX() methods of AQDate.

Example:
var date = aqua.type.date.newDate(1776,7,4,12,0,0,'GMT-0500'); var now = aqua.type.date.newDate();

Method Summary

Modifier and Type	Method and Description
AQDate	add(int years, int months, int days, int hours, int minutes, int seconds, int milliseconds) Returns a new AQDate instance which differs by the specified amount of time.
AQDate	addDays(int days) Returns a new AQDate instance which differs by the number of days.
AQDate	addHours(int hours) Returns a new AQDate instance which differs by the number of hours.
AQDate	addMilliseconds(int ms) Returns a new AQDate instance which differs by the number of milliseconds.
AQDate	addMinutes(int minutes) Returns a new AQDate instance which differs by the number of minutes.
AQDate	addMonths(int months) Returns a new AQDate instance which differs by the number of months.
AQDate	addSeconds(int seconds) Returns a new AQDate instance which differs by the number of seconds.
AQDate	addTimeZoneOffset(int ms) Returns a new AQDate instance which time zone offset differs by the specified number of milliseconds.
AQDate	addYears(int years) Returns a new AQDate instance which differs by the number of years.
AQDate	convertTimeZone(java.lang.String timezone) Returns a new AQDate instance where time zone is adjusted to the specified value, without changing the actual UTC time.
java.lang.String	format(java.lang.String pattern) Converts the date to a string according to the specified pattern.
java.lang.String	format(java.lang.String pattern, java.lang.Object locale) Converts the date to a string according to the specified pattern and locale.
int	getDay() Returns day of month (1...31) for this date instance.
int	getHours() Returns hour of day (0..23) for this date instance.
java.util.Date	getJavaDate() Returns Date value
int	getMilliseconds() Returns the millisecond within the second for this date instance.
int	getMinutes() Returns the minute within the hour for this date instance.
int	getMonth() Returns month (1..12, January is 1) for this date instance.
int	getSeconds() Returns the second within the minute for this date instance.
long	getTimeMilliseconds() Returns UTC time in milliseconds since January 1, 1970 00:00:00.000 GMT
java.util.TimeZone	getTimeZone() Returns TimeZone value.
int	getTimeZoneOffset() Returns time zone offset in milliseconds relative to GMT
int	getYear() Returns Gregorian year for this date instance.
boolean	isEarlier(AQDate date) Returns true if the date is earlier than the specified date.
boolean	isInRange(AQDate start, AQDate end) Returns true if the date is within the specified range (inclusive).
boolean	isLater(AQDate date) Returns true if the date is later than the specified date.

Method Detail

getYear

int getYear()

Returns Gregorian year for this date instance.

Returns:

the year

getMonth

int getMonth()

Returns month (1..12, January is 1) for this date instance.

Returns:

the mont

getDay

int getDay()

Returns day of month (1...31) for this date instance.

Returns:

the day

getHours

int getHours()

Returns hour of day (0..23) for this date instance.

Returns:

the hours

getMinutes

int getMinutes()

Returns the minute within the hour for this date instance.

Returns:

the minutes

getSeconds

int getSeconds()

Returns the second within the minute for this date instance.

Returns:

the seconds

getMilliseconds

int getMilliseconds()

Returns the millisecond within the second for this date instance.

Returns:

the milliseconds

getTimeMilliseconds

long getTimeMilliseconds()

Returns UTC time in milliseconds since January 1, 1970 00:00:00.000 GMT

Returns:

the milliseconds

getJavaDate

java.util.Date getJavaDate()

Returns Date value

Returns:

the date

getTimeZone

java.util.TimeZone getTimeZone()

Returns TimeZone value.

Returns:

the time zone

getTimeZoneOffset

int getTimeZoneOffset()

Returns time zone offset in milliseconds relative to GMT

Returns:

the time zone offset

isInRange

boolean isInRange(AQDate start,
                  AQDate end)

Returns true if the date is within the specified range (inclusive).

Parameters:

start - Interval start.

end - Interval end.

Returns:

TRUE if is in range

isEarlier

boolean isEarlier(AQDate date)

Returns true if the date is earlier than the specified date.

Parameters:

date - the specified date

Returns:

TRUE if is earlier

isLater

boolean isLater(AQDate date)

Returns true if the date is later than the specified date.

Parameters:

date - the specified date

Returns:

TRUE if is later

add

AQDate add(int years,
           int months,
           int days,
           int hours,
           int minutes,
           int seconds,
           int milliseconds)

Returns a new AQDate instance which differs by the specified amount of time.

Parameters:

years - the years

months - the months

days - the days

hours - the hours

minutes - the minutes

seconds - the seconds

milliseconds - the milliseconds

Returns:

the date

addYears

AQDate addYears(int years)

Returns a new AQDate instance which differs by the number of years.

Parameters:

years - the years

Returns:

the date

addMonths

AQDate addMonths(int months)

Returns a new AQDate instance which differs by the number of months.

Parameters:

months - the months

Returns:

the date

addDays

AQDate addDays(int days)

Returns a new AQDate instance which differs by the number of days.

Parameters:

days - the days

Returns:

the date

addHours

AQDate addHours(int hours)

Returns a new AQDate instance which differs by the number of hours.

Parameters:

hours - the hours

Returns:

the date

addMinutes

AQDate addMinutes(int minutes)

Returns a new AQDate instance which differs by the number of minutes.

Parameters:

minutes - the minutes

Returns:

the date

addSeconds

AQDate addSeconds(int seconds)

Returns a new AQDate instance which differs by the number of seconds.

Parameters:

seconds - the seconds

Returns:

the date

addMilliseconds

AQDate addMilliseconds(int ms)

Returns a new AQDate instance which differs by the number of milliseconds.

Parameters:

ms - the milliseconds

Returns:

the date

addTimeZoneOffset

AQDate addTimeZoneOffset(int ms)

Returns a new AQDate instance which time zone offset differs by the specified number of milliseconds.

Parameters:

ms - Time zone offset in milliseconds.

Returns:

the date

convertTimeZone

AQDate convertTimeZone(java.lang.String timezone)

Returns a new AQDate instance where time zone is adjusted to the specified value, without changing the actual UTC time.

Parameters:

timezone - Time zone specification as defined in TimeZone. Example: "GMT-08:00"

Returns:

An AQDate object.

format

java.lang.String format(java.lang.String pattern)

Converts the date to a string according to the specified pattern.

Parameters:

pattern - Pattern as specified in SimpleDateFormat. Example: "yyyy/MM/dd HH.mm.ss"

Returns:

A string representation of the AQDate object as specified by the pattern.

format

java.lang.String format(java.lang.String pattern,
                        java.lang.Object locale)

Converts the date to a string according to the specified pattern and locale.

Parameters:

pattern - Pattern as specified in SimpleDateFormat. Example: "yyyy/MM/dd HH.mm.ss"

locale - Locale string as specified in Locale. Example: "en_US"

Returns:

A string representation of the AQDate object as specified by the pattern.