JDateTime (Jodd API Documentation)

java.lang.Object
- jodd.datetime.JDateTime

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable
```
public class JDateTime
extends java.lang.Object
implements java.lang.Comparable, java.lang.Cloneable, java.io.Serializable
```
Universal all-in-one date and time class that uses Astronomical Julian Dates for time calculations. Guaranteed precision for all manipulations and calculations is up to 1 ms (0.001 sec).
The Julian day or Julian day number (JDN) is the (integer) number of days that have elapsed since Monday, January 1, 4713 BC in the proleptic Julian calendar 1. That day is counted as Julian day zero. Thus the multiples of 7 are Mondays. Negative values can also be used.
The Julian Date (JD) is the number of days (with decimal fraction of the day) that have elapsed since 12 noon Greenwich Mean Time (UT or TT) of that day. Rounding to the nearest integer gives the Julian day number.
JDateTime contains date/time information for current day. By default, behaviour and formats are set to ISO standard, although this may be changed.
JDateTime can be set in many different ways by using setXxx() methods or equivalent constructors. Moreover, date time information may be loaded from an instance of any available java date-time class. This functionality can be easily enhanced for any custom date/time class. Furthermore, JDateTime can be converted to any such date/time class.
Rolling dates with JDateTime is easy. For this JDateTime contains many addXxx() methods. Time can be added or subtracted with any value or more values at once. All combinations are valid. Calculations also performs month fixes by default.
JDateTime behaviour is set by several attributes (or parameters). Each one contains 2 values: one is the default value, used by all instances of JDateTime and the other one is just for a specific instance of JDateTime. This means that it is possible to set behaviour of all instances at once or of one particular instance.
Bellow is the list of behaviour attributes:
- monthFix - since months do not have the same number of days, adding months and years may be calculated in two different ways: with or without month fix. when month fix is on, JDateTime will additionally fix all time adding and fix the date. For example, adding one month to 2003-01-31 will give 2003-02-28 and not 2003-03-03. By default, monthFix is turned on and set to true.
- locale - current locale, used for getting names during formatting the output string.
- timezone - current timezone
- format - is String that describes how time is converted and parsed to and from a String. Default format matches ISO standard. An instance of JdtFormatter parses and uses this template.
- week definition - is used for specifying the definition of the week. Week is defined with first day of the week and with the must have day. A must have day is a day that must exist in the 1st week of the year. For example, default value is Thursday (4) as specified by ISO standard. Alternatively, instead of must have day, minimal days of week may be used, since this two numbers are in relation.
Optimization: although based on heavy calculations, JDateTime works significantly faster then java's Calendars. Since JDateTime doesn't use lazy initialization, setXxx() method is slower. However, this doesn't have much effect to the global performances: settings are usually not used without gettings:) As soon as any other method is used (getXxx() or addXxx()) performances of JDateTime becomes significantly better.
Year 1582 is (almost:) working: after 1582-10-04 (Thursday) is 1582-10-15 (Friday). Users must be aware of this when doing time rolling before across this period.
More info: Julian Date on Wikipedia
See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`APRIL`
`static int`	`AUGUST`
`protected int`	`dayofweek` Day of week, range: [1-7] == [Monday - Sunday]
`protected int`	`dayofyear` Day of year, range: [1-365] or [1-366]
`static int`	`DECEMBER`
`static java.lang.String`	`DEFAULT_FORMAT`
`static int`	`FEBRUARY`
`protected int`	`firstDayOfWeek`
`protected java.lang.String`	`format`
`static int`	`FRIDAY`
`static int`	`JANUARY`
`static JulianDateStamp`	`JD_1970` Julian Date for 1970-01-01T00:00:00 (Thursday).
`static JulianDateStamp`	`JD_2001` Julian Date for 2001-01-01T00:00:00 (Monday).
`protected JulianDateStamp`	`jdate` Current Julian Date.
`protected JdtFormatter`	`jdtFormatter`
`static int`	`JULY`
`static int`	`JUNE`
`protected boolean`	`leap` Leap year flag.
`protected java.util.Locale`	`locale`
`static int`	`MARCH`
`static int`	`MAY`
`protected int`	`minDaysInFirstWeek`
`static int`	`MONDAY`
`protected boolean`	`monthFix`
`protected int`	`mustHaveDayOfFirstWeek`
`static int`	`NOVEMBER`
`static int`	`OCTOBER`
`static int`	`SATURDAY`
`static int`	`SEPTEMBER`
`static int`	`SUNDAY`
`static int`	`THURSDAY`
`protected DateTimeStamp`	`time` `DateTimeStamp` for current date.
`protected java.util.TimeZone`	`timezone`
`protected boolean`	`trackDST`
`static int`	`TUESDAY`
`static int`	`WEDNESDAY`
`protected int`	`weekofmonth` Week of month.
`protected int`	`weekofyear` Week of year, range: [1-52] or [1-53]

Constructor Summary

Constructors
Constructor and Description
`JDateTime()` Constructor that sets current local date and time.
`JDateTime(java.util.Calendar calendar)` Creates `JDateTime` from `Calendar`.
`JDateTime(java.util.Date date)` Creates `JDateTime` from `Date`.
`JDateTime(DateTimeStamp dts)` Creates `JDateTime` from `DateTimeStamp`.
`JDateTime(double jd)` Creates `JDateTime` from `double` that represents JD.
`JDateTime(int year, int month, int day)` Constructor that sets just date.
`JDateTime(int year, int month, int day, int hour, int minute, int second, int millisecond)` Constructor that set date and time.
`JDateTime(JulianDateStamp jds)` Creates `JDateTime` from `JulianDateStamp`.
`JDateTime(long millis)` Constructor that sets current time specified as time in milliseconds, from the midnight, January 1, 1970 UTC.
`JDateTime(java.lang.String src)` Creates `JDateTime` from a string.
`JDateTime(java.lang.String src, JdtFormat jdtFormat)`
`JDateTime(java.lang.String src, java.lang.String template)` Creates `JDateTime` from a string, using specified template.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`JDateTime`	`add(int year, int month, int day)` Adds date, leaving time unchanged, with preset value of monthFix.
`JDateTime`	`add(int year, int month, int day, boolean monthFix)` Adds date, leaving time unchanged.
`JDateTime`	`add(int year, int month, int day, int hour, int minute, int second, int millisecond)` Performs time adding with preset value of monthFix attribute.
`JDateTime`	`add(int year, int month, int day, int hour, int minute, int second, int millisecond, boolean monthFix)` Adds time to current time.
`JDateTime`	`addDay(int d)` Adds days, with preset value of monthFix.
`JDateTime`	`addDay(int d, boolean monthFix)` Adds days.
`JDateTime`	`addHour(int h)` Adds hours, with preset value of monthFix.
`JDateTime`	`addHour(int h, boolean monthFix)` Adds hours.
`JDateTime`	`addMillisecond(int ms)` Adds milliseconds, with preset value of monthFix.
`JDateTime`	`addMillisecond(int ms, boolean monthFix)` Adds milliseconds.
`JDateTime`	`addMinute(int m)` Adds minutes, with preset value of monthFix.
`JDateTime`	`addMinute(int m, boolean monthFix)` Adds minutes.
`JDateTime`	`addMonth(int m)` Adds month, with preset value of monthFix.
`JDateTime`	`addMonth(int m, boolean monthFix)` Adds month.
`protected void`	`addNoDST(int year, int month, int day, int hour, int minute, int second, int millisecond, boolean monthFix)`
`JDateTime`	`addSecond(int s)` Adds seconds, with preset value of monthFix.
`JDateTime`	`addSecond(int s, boolean monthFix)` Adds seconds.
`JDateTime`	`addTime(int hour, int minute, int second)`
`JDateTime`	`addTime(int hour, int minute, int second, boolean monthFix)`
`JDateTime`	`addTime(int hour, int minute, int second, int millisecond)` Adds time, with preset value of monthFix.
`JDateTime`	`addTime(int hour, int minute, int second, int millisecond, boolean monthFix)` Adds time.
`JDateTime`	`addYear(int y)` Adds year, with preset value of monthFix.
`JDateTime`	`addYear(int y, boolean monthFix)` Adds year.
`JDateTime`	`changeTimeZone(java.util.TimeZone timezone)` Changes current timezone.
`JDateTime`	`changeTimeZone(java.util.TimeZone from, java.util.TimeZone to)` Changes time zone.
`JDateTime`	`clone()`
`int`	`compareDateTo(JDateTime jd)` Compares current JDateTime date with another date.
`int`	`compareTo(JDateTime jd)`
`int`	`compareTo(java.lang.Object o)` Compares current JDateTime object with another one, up to 1 millisecond.
`java.util.Calendar`	`convertToCalendar()` Converts to `Calendar` instance.
`java.util.Date`	`convertToDate()` Converts to `Date` instance.
`java.sql.Date`	`convertToSqlDate()` Converts to `java.sql.Date` instance.
`java.sql.Time`	`convertToSqlTime()` Converts to `Time` instance.
`java.sql.Timestamp`	`convertToSqlTimestamp()` Converts to `Timestamp` instance.
`int`	`daysBetween(JDateTime then)` Returns number of full days between two dates.
`int`	`daysBetween(JulianDateStamp then)` Returns number of full days between two dates.
`boolean`	`equals(java.lang.Object obj)` Compares if two JDateTime instances are equal.
`boolean`	`equalsDate(int year, int month, int day)` Returns `true` if provided date is equal to current one.
`boolean`	`equalsDate(JDateTime date)` Returns `true` if two dates are equal.
`boolean`	`equalsTime(JDateTime date)` Returns `true` if two times are equal.
`DateTimeStamp`	`getDateTimeStamp()` Returns current `DateTimeStamp`.
`int`	`getDay()` Returns current day of month.
`int`	`getDayOfMonth()` Returns current day of month.
`int`	`getDayOfWeek()` Returns current day of week.
`int`	`getDayOfYear()` Returns current day of year.
`int`	`getEra()` Returns era: AD(1) or BC(0).
`int`	`getFirstDayOfWeek()` Returns actual the first day of the week.
`java.lang.String`	`getFormat()` Returns format.
`int`	`getHour()` Returns current hour.
`JdtFormatter`	`getJdtFormatter()` Returns actual `JdtFormatter`.
`JulianDateStamp`	`getJulianDate()` Returns `JulianDateStamp`.
`double`	`getJulianDateDouble()` Returns JD as double value.
`int`	`getJulianDayNumber()` Returns JDN.
`java.util.Locale`	`getLocale()` Return currently active locale.
`int`	`getMillisecond()` Returns current milliseconds.
`int`	`getMillisOfDay()` Calculates the number of milliseconds of a day.
`int`	`getMinDaysInFirstWeek()` Returns actual minimal number of days of the first week.
`int`	`getMinute()` Returns current minutes.
`int`	`getMonth()` Returns current month.
`int`	`getMonthLength()` Returns the length of the current month in days.
`int`	`getMonthLength(int month)` Returns the length of the specified month in days.
`int`	`getMustHaveDayOfFirstWeek()` Returns actual must have day of the 1st week.
`int`	`getSecond()` Return current seconds.
`long`	`getTimeInMillis()` Returns time based on current time in milliseconds.
`java.util.TimeZone`	`getTimeZone()` Return currently active time zone.
`int`	`getWeekOfMonth()` Returns current week of month.
`int`	`getWeekOfYear()` Returns current week of year.
`int`	`getYear()` Returns current year.
`int`	`hashCode()`
`boolean`	`isAfter(JDateTime then)` Returns `true` if current time is after then provided time.
`boolean`	`isAfterDate(JDateTime then)` Returns `true` if current date is after then provided date.
`boolean`	`isBefore(JDateTime then)` Returns `true` if current time is before then provided time.
`boolean`	`isBeforeDate(JDateTime then)` Returns `true` if current date is before then provided date.
`boolean`	`isInDaylightTime()` Returns `true` if current date is in daylight savings time in the time zone.
`boolean`	`isLeapYear()` Returns `true` if current year is leap year.
`boolean`	`isMonthFix()` Returns `true` if month fix is active.
`boolean`	`isTrackDST()`
`boolean`	`isValid(java.lang.String s)` Checks if some string represents a valid date using actual template.
`boolean`	`isValid(java.lang.String s, java.lang.String template)` Checks if some string represents a valid date using provided template.
`JDateTime`	`parse(java.lang.String src)` Sets date/time from a string and currently active template.
`JDateTime`	`parse(java.lang.String src, JdtFormat jdtFormat)`
`JDateTime`	`parse(java.lang.String src, java.lang.String format)` Sets date/time from a string given in provided template.
`JDateTime`	`set(int year, int month, int day)` Sets date, time is set to midnight (00:00:00.000).
`JDateTime`	`set(int year, int month, int day, int hour, int minute, int second, int millisecond)` Core method that sets date and time.
`JDateTime`	`setCurrentTime()` Sets current local date and time.
`JDateTime`	`setDate(int year, int month, int day)` Sets date, time remains unchanged.
`JDateTime`	`setDateTime(java.util.Calendar calendar)` Sets current date and time from `Calendar`.
`JDateTime`	`setDateTime(java.util.Date date)` Sets current date and time from `Date`.
`JDateTime`	`setDateTimeStamp(DateTimeStamp dts)` Loads current date time information.
`JDateTime`	`setDay(int d)` Sets current day of month.
`JDateTime`	`setFormat(java.lang.String format)` Defines default format.
`JDateTime`	`setHour(int h)` Set current hour.
`JDateTime`	`setJdtFormat(JdtFormat jdtFormat)` Sets both format and formatter from provided `JdtFormat`.
`JDateTime`	`setJdtFormatter(JdtFormatter jdtFormatter)` Defines custom formatter.
`JDateTime`	`setJulianDate(double jd)` Sets JD.
`JDateTime`	`setJulianDate(JulianDateStamp jds)` Sets current Julian Date.
`JDateTime`	`setLocale(java.util.Locale locale)` Sets custom locale.
`JDateTime`	`setMillisecond(int m)` Sets current millisecond.
`JDateTime`	`setMinute(int m)` Set current minute.
`JDateTime`	`setMonth(int m)` Sets current month.
`JDateTime`	`setMonthFix(boolean monthFix)` Sets custom month fix value.
`JDateTime`	`setSecond(int s)` Sets current second.
`JDateTime`	`setSecond(int s, int m)`
`JDateTime`	`setTime(int hour, int minute, int second, int millisecond)` Sets time, date is unchanged.
`JDateTime`	`setTimeInMillis(long millis)` Sets the time based on current time in milliseconds.
`JDateTime`	`setTimeZone(java.util.TimeZone timezone)` Sets time zone without changing the time.
`JDateTime`	`setTrackDST(boolean trackDST)`
`JDateTime`	`setWeekDefinition(int start, int must)` Defines week definitions.
`JDateTime`	`setWeekDefinitionAlt(int start, int min)` Defines week alternatively.
`JDateTime`	`setYear(int y)` Sets current year.
`JDateTime`	`sub(int year, int month, int day)`
`JDateTime`	`sub(int year, int month, int day, boolean monthFix)`
`JDateTime`	`sub(int year, int month, int day, int hour, int minute, int second, int millisecond)`
`JDateTime`	`sub(int year, int month, int day, int hour, int minute, int second, int millisecond, boolean monthFix)`
`JDateTime`	`subDay(int d)`
`JDateTime`	`subDay(int d, boolean monthFix)`
`JDateTime`	`subHour(int h)`
`JDateTime`	`subHour(int h, boolean monthFix)`
`JDateTime`	`subMillisecond(int ms)`
`JDateTime`	`subMillisecond(int ms, boolean monthFix)`
`JDateTime`	`subMinute(int m)`
`JDateTime`	`subMinute(int m, boolean monthFix)`
`JDateTime`	`subMonth(int m)`
`JDateTime`	`subMonth(int m, boolean monthFix)`
`JDateTime`	`subSecond(int s)`
`JDateTime`	`subSecond(int s, boolean monthFix)`
`JDateTime`	`subTime(int hour, int minute, int second)`
`JDateTime`	`subTime(int hour, int minute, int second, boolean monthFix)`
`JDateTime`	`subTime(int hour, int minute, int second, int millisecond)`
`JDateTime`	`subTime(int hour, int minute, int second, int millisecond, boolean monthFix)`
`JDateTime`	`subYear(int y)`
`JDateTime`	`subYear(int y, boolean monthFix)`
`java.lang.String`	`toString()` Returns spring representation of current date/time in currently active format.
`java.lang.String`	`toString(JdtFormat jdtFormat)`
`java.lang.String`	`toString(java.lang.String format)` Returns string representation of date/time in specified format.

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - DEFAULT_FORMAT
```
public static final java.lang.String DEFAULT_FORMAT
```
    See Also:
    
    Constant Field Values
  - MONDAY
```
public static final int MONDAY
```
    See Also:
    
    Constant Field Values
  - TUESDAY
```
public static final int TUESDAY
```
    See Also:
    
    Constant Field Values
  - WEDNESDAY
```
public static final int WEDNESDAY
```
    See Also:
    
    Constant Field Values
  - THURSDAY
```
public static final int THURSDAY
```
    See Also:
    
    Constant Field Values
  - FRIDAY
```
public static final int FRIDAY
```
    See Also:
    
    Constant Field Values
  - SATURDAY
```
public static final int SATURDAY
```
    See Also:
    
    Constant Field Values
  - SUNDAY
```
public static final int SUNDAY
```
    See Also:
    
    Constant Field Values
  - JANUARY
```
public static final int JANUARY
```
    See Also:
    
    Constant Field Values
  - FEBRUARY
```
public static final int FEBRUARY
```
    See Also:
    
    Constant Field Values
  - MARCH
```
public static final int MARCH
```
    See Also:
    
    Constant Field Values
  - APRIL
```
public static final int APRIL
```
    See Also:
    
    Constant Field Values
  - MAY
```
public static final int MAY
```
    See Also:
    
    Constant Field Values
  - JUNE
```
public static final int JUNE
```
    See Also:
    
    Constant Field Values
  - JULY
```
public static final int JULY
```
    See Also:
    
    Constant Field Values
  - AUGUST
```
public static final int AUGUST
```
    See Also:
    
    Constant Field Values
  - SEPTEMBER
```
public static final int SEPTEMBER
```
    See Also:
    
    Constant Field Values
  - OCTOBER
```
public static final int OCTOBER
```
    See Also:
    
    Constant Field Values
  - NOVEMBER
```
public static final int NOVEMBER
```
    See Also:
    
    Constant Field Values
  - DECEMBER
```
public static final int DECEMBER
```
    See Also:
    
    Constant Field Values
  - time
```
protected DateTimeStamp time
```
    DateTimeStamp for current date.
  - dayofweek
```
protected int dayofweek
```
    Day of week, range: [1-7] == [Monday - Sunday]
  - dayofyear
```
protected int dayofyear
```
    Day of year, range: [1-365] or [1-366]
  - leap
```
protected boolean leap
```
    Leap year flag.
  - weekofyear
```
protected int weekofyear
```
    Week of year, range: [1-52] or [1-53]
  - weekofmonth
```
protected int weekofmonth
```
    Week of month.
  - jdate
```
protected JulianDateStamp jdate
```
    Current Julian Date.
  - JD_1970
```
public static final JulianDateStamp JD_1970
```
    Julian Date for 1970-01-01T00:00:00 (Thursday).
  - JD_2001
```
public static final JulianDateStamp JD_2001
```
    Julian Date for 2001-01-01T00:00:00 (Monday).
  - trackDST
```
protected boolean trackDST
```
  - monthFix
```
protected boolean monthFix
```
  - timezone
```
protected java.util.TimeZone timezone
```
  - locale
```
protected java.util.Locale locale
```
  - format
```
protected java.lang.String format
```
  - jdtFormatter
```
protected JdtFormatter jdtFormatter
```
  - firstDayOfWeek
```
protected int firstDayOfWeek
```
  - mustHaveDayOfFirstWeek
```
protected int mustHaveDayOfFirstWeek
```
  - minDaysInFirstWeek
```
protected int minDaysInFirstWeek
```
- Constructor Detail
  - JDateTime
```
public JDateTime(int year,
                 int month,
                 int day,
                 int hour,
                 int minute,
                 int second,
                 int millisecond)
```
    Constructor that set date and time.
    
    Parameters:
    
    year - year to set
    
    month - month to set
    
    day - day to set
    
    hour - hours to set
    
    minute - minutes to set
    
    second - seconds to set
    
    millisecond - milliseconds to set
    
    See Also:
    
    set(int, int, int, int, int, int, int)
  - JDateTime
```
public JDateTime(int year,
                 int month,
                 int day)
```
    Constructor that sets just date. Time is set to 00:00:00.
    
    Parameters:
    
    year - year to set
    
    month - month to set
    
    day - day to set
    
    See Also:
    
    set(int, int, int)
  - JDateTime
```
public JDateTime(long millis)
```
    Constructor that sets current time specified as time in milliseconds, from the midnight, January 1, 1970 UTC.
    
    Parameters:
    
    millis - time in milliseconds, from the midnight, January 1, 1970 UTC
    
    See Also:
    
    setTimeInMillis(long )
  - JDateTime
```
public JDateTime()
```
    Constructor that sets current local date and time.
  - JDateTime
```
public JDateTime(java.util.Calendar calendar)
```
    Creates JDateTime from Calendar.
  - JDateTime
```
public JDateTime(java.util.Date date)
```
    Creates JDateTime from Date.
  - JDateTime
```
public JDateTime(DateTimeStamp dts)
```
    Creates JDateTime from DateTimeStamp.
  - JDateTime
```
public JDateTime(JulianDateStamp jds)
```
    Creates JDateTime from JulianDateStamp.
  - JDateTime
```
public JDateTime(double jd)
```
    Creates JDateTime from double that represents JD.
  - JDateTime
```
public JDateTime(java.lang.String src)
```
    Creates JDateTime from a string.
  - JDateTime
```
public JDateTime(java.lang.String src,
                 java.lang.String template)
```
    Creates JDateTime from a string, using specified template.
  - JDateTime
```
public JDateTime(java.lang.String src,
                 JdtFormat jdtFormat)
```
- Method Detail
  - getDateTimeStamp
```
public DateTimeStamp getDateTimeStamp()
```
    Returns current DateTimeStamp. Returned instance is still used internally (i.e. it is not cloned before returning).
  - setDateTimeStamp
```
public JDateTime setDateTimeStamp(DateTimeStamp dts)
```
    Loads current date time information.
  - setJulianDate
```
public JDateTime setJulianDate(JulianDateStamp jds)
```
    Sets current Julian Date. This is the core of the JDateTime class and it is used by all other classes. This method performs all calculations required for whole class.
    
    Parameters:
    
    jds - current julian date
  - getJulianDate
```
public JulianDateStamp getJulianDate()
```
    Returns JulianDateStamp. It is the same instance used internally.
  - getJulianDayNumber
```
public int getJulianDayNumber()
```
    Returns JDN. Note that JDN is not equal to integer part of julian date. It is calculated by rounding to the nearest integer.
  - set
```
public JDateTime set(int year,
                     int month,
                     int day,
                     int hour,
                     int minute,
                     int second,
                     int millisecond)
```
    Core method that sets date and time. All others set() methods use this one. Milliseconds are truncated after 3rd digit.
    
    Parameters:
    
    year - year to set
    
    month - month to set
    
    day - day to set
    
    hour - hour to set
    
    minute - minute to set
    
    second - second to set
  - add
```
public JDateTime add(int year,
                     int month,
                     int day,
                     int hour,
                     int minute,
                     int second,
                     int millisecond,
                     boolean monthFix)
```
    Adds time to current time. The main add method - all other add() methods must use this one.
    There are 2 different kinds of addings, when months are added:
    - when months are not specially concern. All remaining days will be added to the next month. Example: 2003-01-31 + 0-01-0 = 2003-03-03
    - when months addition is fixed, and month is not approximated. example: 2003-01-31 + 0-01-0 = 2003-02-28
    Parameters:
    
    year - delta year
    
    month - delta month
    
    day - delta days
    
    hour - delta hours
    
    minute - delta minutes
    
    second - delta seconds
    
    monthFix - true for month fixing, false otherwise
  - addNoDST
```
protected void addNoDST(int year,
                        int month,
                        int day,
                        int hour,
                        int minute,
                        int second,
                        int millisecond,
                        boolean monthFix)
```
  - sub
```
public JDateTime sub(int year,
                     int month,
                     int day,
                     int hour,
                     int minute,
                     int second,
                     int millisecond,
                     boolean monthFix)
```
  - add
```
public JDateTime add(int year,
                     int month,
                     int day,
                     int hour,
                     int minute,
                     int second,
                     int millisecond)
```
    Performs time adding with preset value of monthFix attribute.
    
    Parameters:
    
    year - delta year
    
    month - delta month
    
    day - delta days
    
    hour - delta hours
    
    minute - delta minutes
    
    second - delta seconds
    
    See Also:
    
    add(int, int, int, int, int, int, int, boolean)
  - sub
```
public JDateTime sub(int year,
                     int month,
                     int day,
                     int hour,
                     int minute,
                     int second,
                     int millisecond)
```
  - add
```
public JDateTime add(int year,
                     int month,
                     int day,
                     boolean monthFix)
```
    Adds date, leaving time unchanged.
    
    Parameters:
    
    year - years to add
    
    month - months to add
    
    day - days to add
    
    monthFix - true for month fixing, false otherwise
    
    See Also:
    
    add(int, int, int, int, int, int, int, boolean)
  - sub
```
public JDateTime sub(int year,
                     int month,
                     int day,
                     boolean monthFix)
```
  - add
```
public JDateTime add(int year,
                     int month,
                     int day)
```
    Adds date, leaving time unchanged, with preset value of monthFix. attribute.
    
    Parameters:
    
    year - years to add
    
    month - months to add
    
    day - days to add
    
    See Also:
    
    add(int, int, int, boolean)
  - sub
```
public JDateTime sub(int year,
                     int month,
                     int day)
```
  - addTime
```
public JDateTime addTime(int hour,
                         int minute,
                         int second,
                         int millisecond,
                         boolean monthFix)
```
    Adds time.
    
    Parameters:
    
    hour - hours to add
    
    minute - minutes to add
    
    second - seconds to add
    
    monthFix - true for month fixing, false otherwise
    
    See Also:
    
    add(int, int, int, int, int, int, int)
  - subTime
```
public JDateTime subTime(int hour,
                         int minute,
                         int second,
                         int millisecond,
                         boolean monthFix)
```
  - addTime
```
public JDateTime addTime(int hour,
                         int minute,
                         int second,
                         boolean monthFix)
```
  - subTime
```
public JDateTime subTime(int hour,
                         int minute,
                         int second,
                         boolean monthFix)
```
  - addTime
```
public JDateTime addTime(int hour,
                         int minute,
                         int second,
                         int millisecond)
```
    Adds time, with preset value of monthFix.
    
    Parameters:
    
    hour - hours to add
    
    minute - minutes to add
    
    second - seconds to add
    
    See Also:
    
    addTime(int, int, int, int, boolean)
  - subTime
```
public JDateTime subTime(int hour,
                         int minute,
                         int second,
                         int millisecond)
```
  - addTime
```
public JDateTime addTime(int hour,
                         int minute,
                         int second)
```
  - subTime
```
public JDateTime subTime(int hour,
                         int minute,
                         int second)
```
  - addYear
```
public JDateTime addYear(int y,
                         boolean monthFix)
```
    Adds year.
    
    Parameters:
    
    y - year to add
    
    monthFix - true for month fixing, false otherwise
  - subYear
```
public JDateTime subYear(int y,
                         boolean monthFix)
```
  - addYear
```
public JDateTime addYear(int y)
```
    Adds year, with preset value of monthFix.
    
    Parameters:
    
    y - year to add
  - subYear
```
public JDateTime subYear(int y)
```
  - addMonth
```
public JDateTime addMonth(int m,
                          boolean monthFix)
```
    Adds month.
    
    Parameters:
    
    m - month to add
    
    monthFix - true for month fixing, false otherwise
  - subMonth
```
public JDateTime subMonth(int m,
                          boolean monthFix)
```
  - addMonth
```
public JDateTime addMonth(int m)
```
    Adds month, with preset value of monthFix.
    
    Parameters:
    
    m - month to add
  - subMonth
```
public JDateTime subMonth(int m)
```
  - addDay
```
public JDateTime addDay(int d,
                        boolean monthFix)
```
    Adds days.
    
    Parameters:
    
    d - days to add
    
    monthFix - true for month fixing, false otherwise
  - subDay
```
public JDateTime subDay(int d,
                        boolean monthFix)
```
  - addDay
```
public JDateTime addDay(int d)
```
    Adds days, with preset value of monthFix.
    
    Parameters:
    
    d - days to add
  - subDay
```
public JDateTime subDay(int d)
```
  - addHour
```
public JDateTime addHour(int h,
                         boolean monthFix)
```
    Adds hours.
    
    Parameters:
    
    h - hours to add
    
    monthFix - true for month fixing, false otherwise
  - subHour
```
public JDateTime subHour(int h,
                         boolean monthFix)
```
  - addHour
```
public JDateTime addHour(int h)
```
    Adds hours, with preset value of monthFix.
    
    Parameters:
    
    h - hours to add
  - subHour
```
public JDateTime subHour(int h)
```
  - addMinute
```
public JDateTime addMinute(int m,
                           boolean monthFix)
```
    Adds minutes.
    
    Parameters:
    
    m - minutes to add.
    
    monthFix - true for month fixing, false otherwise
  - subMinute
```
public JDateTime subMinute(int m,
                           boolean monthFix)
```
  - addMinute
```
public JDateTime addMinute(int m)
```
    Adds minutes, with preset value of monthFix.
    
    Parameters:
    
    m - minutes to add.
  - subMinute
```
public JDateTime subMinute(int m)
```
  - addSecond
```
public JDateTime addSecond(int s,
                           boolean monthFix)
```
    Adds seconds.
    
    Parameters:
    
    s - seconds to add
    
    monthFix - true for month fixing, false otherwise
  - subSecond
```
public JDateTime subSecond(int s,
                           boolean monthFix)
```
  - addSecond
```
public JDateTime addSecond(int s)
```
    Adds seconds, with preset value of monthFix.
    
    Parameters:
    
    s - seconds to add
  - subSecond
```
public JDateTime subSecond(int s)
```
  - addMillisecond
```
public JDateTime addMillisecond(int ms,
                                boolean monthFix)
```
    Adds milliseconds.
    
    Parameters:
    
    ms - milliseconds to add
    
    monthFix - true for month fixing, false otherwise
  - subMillisecond
```
public JDateTime subMillisecond(int ms,
                                boolean monthFix)
```
  - addMillisecond
```
public JDateTime addMillisecond(int ms)
```
    Adds milliseconds, with preset value of monthFix.
    
    Parameters:
    
    ms - milliseconds to add
  - subMillisecond
```
public JDateTime subMillisecond(int ms)
```
  - set
```
public JDateTime set(int year,
                     int month,
                     int day)
```
    Sets date, time is set to midnight (00:00:00.000).
    
    Parameters:
    
    year - year to set
    
    month - month to set
    
    day - day to set
  - setTime
```
public JDateTime setTime(int hour,
                         int minute,
                         int second,
                         int millisecond)
```
    Sets time, date is unchanged.
    
    Parameters:
    
    hour - hours to set
    
    minute - minutes to set
    
    second - seconds to set
  - setDate
```
public JDateTime setDate(int year,
                         int month,
                         int day)
```
    Sets date, time remains unchanged.
    
    Parameters:
    
    year - year
    
    month - month
    
    day - day
  - setTimeInMillis
```
public JDateTime setTimeInMillis(long millis)
```
    Sets the time based on current time in milliseconds. Current time is calculated from the midnight, January 1, 1970 UTC.
    Calculation is divided in two steps, due to precision issues.
    
    Parameters:
    
    millis - time in milliseconds, from the midnight, January 1, 1970 UTC
  - getTimeInMillis
```
public long getTimeInMillis()
```
    Returns time based on current time in milliseconds. Current time is calculated from the midnight, January 1, 1970 UTC.
    Due to possible huge values calculation is divided in two steps: first for fractional difference, and then for integer parts.
    
    Returns:
    
    time in milliseconds, from the midnight, January 1, 1970 UTC
  - setYear
```
public JDateTime setYear(int y)
```
    Sets current year.
    
    Parameters:
    
    y - year to set
  - setMonth
```
public JDateTime setMonth(int m)
```
    Sets current month.
    
    Parameters:
    
    m - month to set
  - setDay
```
public JDateTime setDay(int d)
```
    Sets current day of month.
    
    Parameters:
    
    d - day to set
  - setHour
```
public JDateTime setHour(int h)
```
    Set current hour.
    
    Parameters:
    
    h - hour to set
  - setMinute
```
public JDateTime setMinute(int m)
```
    Set current minute.
    
    Parameters:
    
    m - minutes to set
  - setSecond
```
public JDateTime setSecond(int s)
```
    Sets current second.
    
    Parameters:
    
    s - seconds and milliseconds to set
  - setSecond
```
public JDateTime setSecond(int s,
                           int m)
```
  - setMillisecond
```
public JDateTime setMillisecond(int m)
```
    Sets current millisecond.
    
    Parameters:
    
    m - milliseconds to set
  - getYear
```
public int getYear()
```
    Returns current year.
  - getMonth
```
public int getMonth()
```
    Returns current month.
  - getDay
```
public int getDay()
```
    Returns current day of month.
    
    See Also:
    
    getDayOfMonth()
  - getDayOfMonth
```
public int getDayOfMonth()
```
    Returns current day of month.
    
    See Also:
    
    getDay()
  - getHour
```
public int getHour()
```
    Returns current hour.
  - getMinute
```
public int getMinute()
```
    Returns current minutes.
  - getSecond
```
public int getSecond()
```
    Return current seconds. For an integer value, just cast the returned value.
  - getMillisecond
```
public int getMillisecond()
```
    Returns current milliseconds.
  - getDayOfWeek
```
public int getDayOfWeek()
```
    Returns current day of week.
  - getDayOfYear
```
public int getDayOfYear()
```
    Returns current day of year.
  - isLeapYear
```
public boolean isLeapYear()
```
    Returns true if current year is leap year.
  - getWeekOfYear
```
public int getWeekOfYear()
```
    Returns current week of year.
  - getWeekOfMonth
```
public int getWeekOfMonth()
```
    Returns current week of month.
  - getMonthLength
```
public int getMonthLength(int month)
```
    Returns the length of the specified month in days.
  - getMonthLength
```
public int getMonthLength()
```
    Returns the length of the current month in days.
  - getEra
```
public int getEra()
```
    Returns era: AD(1) or BC(0).
  - getMillisOfDay
```
public int getMillisOfDay()
```
    Calculates the number of milliseconds of a day.
  - setCurrentTime
```
public JDateTime setCurrentTime()
```
    Sets current local date and time.
  - setDateTime
```
public JDateTime setDateTime(java.util.Calendar calendar)
```
    Sets current date and time from Calendar.
  - setDateTime
```
public JDateTime setDateTime(java.util.Date date)
```
    Sets current date and time from Date.
  - convertToDate
```
public java.util.Date convertToDate()
```
    Converts to Date instance.
  - convertToCalendar
```
public java.util.Calendar convertToCalendar()
```
    Converts to Calendar instance.
  - convertToSqlDate
```
public java.sql.Date convertToSqlDate()
```
    Converts to java.sql.Date instance.
  - convertToSqlTime
```
public java.sql.Time convertToSqlTime()
```
    Converts to Time instance.
  - convertToSqlTimestamp
```
public java.sql.Timestamp convertToSqlTimestamp()
```
    Converts to Timestamp instance.
  - isTrackDST
```
public boolean isTrackDST()
```
  - setTrackDST
```
public JDateTime setTrackDST(boolean trackDST)
```
  - isMonthFix
```
public boolean isMonthFix()
```
    Returns true if month fix is active.
  - setMonthFix
```
public JDateTime setMonthFix(boolean monthFix)
```
    Sets custom month fix value.
  - changeTimeZone
```
public JDateTime changeTimeZone(java.util.TimeZone timezone)
```
    Changes current timezone. Current time is changed if time zone has been changed.
  - changeTimeZone
```
public JDateTime changeTimeZone(java.util.TimeZone from,
                                java.util.TimeZone to)
```
    Changes time zone. Equivalent to: setTimeZone(from); changeTimeZone(to);
  - setTimeZone
```
public JDateTime setTimeZone(java.util.TimeZone timezone)
```
    Sets time zone without changing the time.
  - getTimeZone
```
public java.util.TimeZone getTimeZone()
```
    Return currently active time zone.
  - isInDaylightTime
```
public boolean isInDaylightTime()
```
    Returns true if current date is in daylight savings time in the time zone.
  - setLocale
```
public JDateTime setLocale(java.util.Locale locale)
```
    Sets custom locale.
  - getLocale
```
public java.util.Locale getLocale()
```
    Return currently active locale.
  - setFormat
```
public JDateTime setFormat(java.lang.String format)
```
    Defines default format.
  - getFormat
```
public java.lang.String getFormat()
```
    Returns format.
  - setJdtFormatter
```
public JDateTime setJdtFormatter(JdtFormatter jdtFormatter)
```
    Defines custom formatter.
  - getJdtFormatter
```
public JdtFormatter getJdtFormatter()
```
    Returns actual JdtFormatter.
  - setJdtFormat
```
public JDateTime setJdtFormat(JdtFormat jdtFormat)
```
    Sets both format and formatter from provided JdtFormat.
  - toString
```
public java.lang.String toString(java.lang.String format)
```
    Returns string representation of date/time in specified format.
  - toString
```
public java.lang.String toString()
```
    Returns spring representation of current date/time in currently active format.
    
    Overrides:
    
    toString in class java.lang.Object
    
    See Also:
    
    getFormat()
  - toString
```
public java.lang.String toString(JdtFormat jdtFormat)
```
  - parse
```
public JDateTime parse(java.lang.String src,
                       java.lang.String format)
```
    Sets date/time from a string given in provided template.
    
    Parameters:
    
    src - string containing date time information
    
    format - format template
  - parse
```
public JDateTime parse(java.lang.String src)
```
    Sets date/time from a string and currently active template.
    
    Parameters:
    
    src - string containing date time information
    
    See Also:
    
    getFormat()
  - parse
```
public JDateTime parse(java.lang.String src,
                       JdtFormat jdtFormat)
```
  - isValid
```
public boolean isValid(java.lang.String s)
```
    Checks if some string represents a valid date using actual template.
    
    Returns:
    
    true if date is valid, otherwise false
  - isValid
```
public boolean isValid(java.lang.String s,
                       java.lang.String template)
```
    Checks if some string represents a valid date using provided template.
    
    Returns:
    
    true if date is valid, otherwise false
  - setWeekDefinition
```
public JDateTime setWeekDefinition(int start,
                                   int must)
```
    Defines week definitions.
    
    Parameters:
    
    start - first day in week, [1-7],
    
    must - must have day of the 1st week, [1-7]
  - getFirstDayOfWeek
```
public int getFirstDayOfWeek()
```
    Returns actual the first day of the week.
  - getMustHaveDayOfFirstWeek
```
public int getMustHaveDayOfFirstWeek()
```
    Returns actual must have day of the 1st week.
  - getMinDaysInFirstWeek
```
public int getMinDaysInFirstWeek()
```
    Returns actual minimal number of days of the first week. It is calculated from must have day of the first week.
    
    Returns:
    
    minimal number of days of the first week
  - setWeekDefinitionAlt
```
public JDateTime setWeekDefinitionAlt(int start,
                                      int min)
```
    Defines week alternatively.
    
    Parameters:
    
    start - first day in week
    
    min - minimal days of week
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Compares if two JDateTime instances are equal. Comparison precision is 1e-3 seconds.
    
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - clone
```
public JDateTime clone()
```
    Overrides:
    
    clone in class java.lang.Object
  - compareTo
```
public int compareTo(java.lang.Object o)
```
    Compares current JDateTime object with another one, up to 1 millisecond.
    
    Specified by:
    
    compareTo in interface java.lang.Comparable
    
    Parameters:
    
    o - JDateTime to compare
    
    Returns:
    
    -1 if the current object is less than the argument, 0 if the argument is equal, and 1 if the current object is greater than the argument
  - compareTo
```
public int compareTo(JDateTime jd)
```
  - compareDateTo
```
public int compareDateTo(JDateTime jd)
```
    Compares current JDateTime date with another date. Time component is ignored.
  - isAfter
```
public boolean isAfter(JDateTime then)
```
    Returns true if current time is after then provided time.
  - isBefore
```
public boolean isBefore(JDateTime then)
```
    Returns true if current time is before then provided time.
  - isAfterDate
```
public boolean isAfterDate(JDateTime then)
```
    Returns true if current date is after then provided date. Time component is ignored.
  - isBeforeDate
```
public boolean isBeforeDate(JDateTime then)
```
    Returns true if current date is before then provided date. Time component is ignored.
  - daysBetween
```
public int daysBetween(JDateTime then)
```
    Returns number of full days between two dates.
  - daysBetween
```
public int daysBetween(JulianDateStamp then)
```
    Returns number of full days between two dates.
  - getJulianDateDouble
```
public double getJulianDateDouble()
```
    Returns JD as double value.
  - setJulianDate
```
public JDateTime setJulianDate(double jd)
```
    Sets JD.
  - equalsDate
```
public boolean equalsDate(int year,
                          int month,
                          int day)
```
    Returns true if provided date is equal to current one. May be used for date validation test.
  - equalsDate
```
public boolean equalsDate(JDateTime date)
```
    Returns true if two dates are equal. Time component is ignored.
  - equalsTime
```
public boolean equalsTime(JDateTime date)
```
    Returns true if two times are equal. Date component is ignored.

Class JDateTime

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_FORMAT

MONDAY

TUESDAY

WEDNESDAY

THURSDAY

FRIDAY

SATURDAY

SUNDAY

JANUARY

FEBRUARY

MARCH

APRIL

MAY

JUNE

JULY

AUGUST

SEPTEMBER

OCTOBER

NOVEMBER

DECEMBER

time

dayofweek

dayofyear

leap

weekofyear

weekofmonth

jdate

JD_1970

JD_2001

trackDST

monthFix

timezone

locale

format

jdtFormatter

firstDayOfWeek

mustHaveDayOfFirstWeek

minDaysInFirstWeek

Constructor Detail

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

JDateTime

Method Detail

getDateTimeStamp

setDateTimeStamp

setJulianDate

getJulianDate

getJulianDayNumber

set

add

addNoDST

sub

add

sub

add

sub

add

sub

addTime

subTime

addTime

subTime

addTime

subTime

addTime