OADateTime (com.viaoa:oa-core 3.7.12 API)

java.lang.Object
- com.viaoa.util.OADateTime

All Implemented Interfaces:: Serializable, Comparable

Direct Known Subclasses:: OADate, OATime

public class OADateTime
extends Object
implements Serializable, Comparable

Superclass of OADate and OATime that combines Calendar, Date, Time, TimeZone, Calendar, LocalDateTime, and SimpleDateFormat.

    Formatting:

    MM/dd HH:mm:ss
    MM/dd/yy HH:mm:ss
    MM/dd/yyyy HH:mm:ss

    'Hms', 'Mdy'

    yyyyMMdd_HHmmss.SSS
             hhmmssa

    JSON / XML
        format – ISO 8601
                        2014-03-12T13:37:27+00:00
                        "yyyy-MM-dd'T'HH:mm:ssZ"
                        also...
                        "yyyy-MM-dd'T'HH:mm:sszzz"

        yyyy-MM-dd'T'HH:mm:ssX
            Notice the X on the end. It will handle timezones in ISO 8601 standard
            see: http://stackoverflow.com/questions/19112357/java-simpledateformatyyyy-mm-ddthhmmssz-gives-timezone-as-ist
            ex: 2016-11-22T08:49:02-05
        yyyy-MM-dd'T'HH:mm:ssXX
            ex: 2016-11-22T08:50:12-0500
        yyyy-MM-dd'T'HH:mm:ssXXX
            ex: 2016-11-22T08:49:02-05:00

    javascript Date.toString()    EEE MMM dd yyyy '00:00:00' 'GMT'Z '('z')'

    XSD dateTime
        [-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm]
        The time zone may be specified as Z (UTC) or (+|-)hh:mm. Time zones that aren't specified are considered undetermined.
       => yyyy-MM-dd'T'HH:mm:ss      -> 2001-10-26T21:32:52
       => yyyy-MM-dd'T'HH:mm:ssXXX   -> 2001-10-26T21:32:52+02:00
       => yyyy-MM-dd'T'HH:mm:ss'Z'  ->  2001-10-26T19:32:52Z   (UTZ)

    
    Formatting Symbols used for output display.

    SEE: https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

    G  era designator          (Text)              AD
    y  year                    (Number)            1996
    M  month in year           (Number)            1, 2, 3, 4 .. 10, 11, 12
    MM                         (Number)            01, 02, 03, 04 ... 10, 11, 12
    MMM                        (Text)              Jan, Feb, ... Dec
    MMMM                       (Text)              January, February, ... December
    d  day in month            (Number)            10
    h  hour in am/pm (1~12)    (Number)            12
    H  hour in day (0~23)      (Number)            0
    m  minute in hour          (Number)            30
    s  second in minute        (Number)            55
    S  millisecond             (Number)            978
    E  day in week             (Text)              Tues
    EE
    EEE
    EEEE  day in week          (Text)              Tuesday
    D  day in year             (Number)            189
    F  day of week in month    (Number)            2 (2nd Wed in July)
    w  week in year            (Number)            27
    W  week in month           (Number)            2
    a  am/pm marker            (Text)              PM
    k  hour in day (1~24)      (Number)            24
    K  hour in am/pm (0~11)    (Number)            0
    z  time zone               (Text)              PST (might not use Abbrev anymore, andthis would be offset amount instead)
    zzzz                                           Pacific Standard Time
    zz                         (UTC offset)        -05 
    X                          (hours)             -04
    XX                         (hrsMins)           -0400
    XXX                        (hrs:mins)          -04:00
    Z                          (hrsMins)           -0400
    ZZ   (same as using Z)                         -0400
    ZZZ  (same as using Z)                         -0400

    '  escape for text         (Delimiter)

    '' single quote            (Literal)           '

    Examples:
    "yyyy.MM.dd G 'at' HH:mm:ss z"    ->>  1996.07.10 AD at 15:08:56 PDT
    "EEE, MMM d, ''yy"                ->>  Wed, July 10, '96
    "h:mm a"                          ->>  12:08 PM
    "hh 'o''clock' a, zzzz"           ->>  12 o'clock PM, Pacific Daylight Time
    "K:mm a, z"                       ->>  0:00 PM, PST
    "yyyy.MMMMM.dd GGG hh:mm aaa"     ->>  1996.July.10 AD 12:08 PM
    "yyyy.MM.dd HH:mm:ss.SSS"

    "E dd M yyyy hh:mm:ss a z"          ->> Thu 30 3 2017 11:58:21 AM EDT
    "EE dd MM yyyy hh:mm:ss a zz"       ->> Thu 30 03 2017 11:58:52 AM EDT
    "EEE dd MMM yyyy hh:mm:ss a zzz"    ->> Thu 30 Mar 2017 11:59:35 AM EDT
    "EEEE dd MMMM yyyy hh:mm:ss a zzzz" ->> Thursday 30 March 2017 12:00:33 PM Eastern Daylight Time

See Also:: setGlobalOutputFormat(java.lang.String), SimpleDateFormat, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected long`	`_time`
`static int`	`APR`
`static int`	`APRIL`
`static int`	`AUG`
`static int`	`AUGUST`
`static int`	`DEC`
`static int`	`DECEMBER`
`static int`	`FEB`
`static int`	`FEBRUARY`
`protected String`	`format`
`static String`	`FORMAT_long`
`static String`	`FORMAT_xlong`
`static int`	`FRI`
`static int`	`FRIDAY`
`protected boolean`	`ignoreTimeZone`
`static int`	`JAN`
`static int`	`JANUARY`
`static String`	`JdbcFormat`
`static String`	`JsonFormat`
`static String`	`JsonFormatTZ`
`static int`	`JUL`
`static int`	`JULY`
`static int`	`JUN`
`static int`	`JUNE`
`static int`	`MAR`
`static int`	`MARCH`
`static int`	`MAY`
`static int`	`MON`
`static int`	`MONDAY`
`static int`	`NOV`
`static int`	`NOVEMBER`
`static int`	`OCT`
`static int`	`OCTOBER`
`static String`	`RFC339Format`
`static String`	`RFC339FormatWms`
`static int`	`SAT`
`static int`	`SATURDAY`
`static int`	`SEP`
`static int`	`SEPT`
`static int`	`SEPTEMBER`
`protected static String`	`staticOutputFormat` default output format
`static int`	`SUN`
`static int`	`SUNDAY`
`static int`	`THU`
`static int`	`THURS`
`static int`	`THURSDAY`
`protected TimeZone`	`timeZone`
`static int`	`TUE`
`static int`	`TUES`
`static int`	`TUESDAY`
`static int`	`WED`
`static int`	`WEDNESDAY`

Constructor Summary

Constructors
Constructor and Description
`OADateTime()` Creates new datetime, using current date and time.
`OADateTime(Calendar c)` Creates new datetime, using Calendar parameter.
`OADateTime(Date date)` Creates new datetime, using date parameter.
`OADateTime(Instant instant)`
`OADateTime(int year, int month, int day)`
`OADateTime(int year, int month, int day, int hrs, int mins)`
`OADateTime(int year, int month, int day, int hrs, int mins, int secs)`
`OADateTime(int year, int month, int day, int hrs, int mins, int secs, int milsecs)`
`OADateTime(LocalDateTime ldt)`
`OADateTime(long time)` Creates new datetime, using date parameter.
`OADateTime(OADate d, OATime t)` Creates new datetime, using date and time.
`OADateTime(OADateTime odt)` Creates new datetime, using OADateTime parameter.
`OADateTime(String strDate)` Creates new datetime, using String parameter.
`OADateTime(String strDate, String format)` Creates new datetime, using String parameter and format.
`OADateTime(Time time)` Creates new datetime, using time parameter.
`OADateTime(Timestamp date)` Creates new datetime, using timestamp parameter.
`OADateTime(ZonedDateTime zdt)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected GregorianCalendar`	`_getCal()`
`protected void`	`_releaseCal(GregorianCalendar cal)`
`OADateTime`	`addDay()`
`OADateTime`	`addDays(int amount)` Return an OADateTime where a specified amount of days is added.
`static void`	`addGlobalParseFormat(String fmt)` Add additional global parse formats that are used when converting a String to OADateTime.
`OADateTime`	`addHours(int amount)` Return an OADateTime where a specified amount of hours is added.
`OADateTime`	`addMilliSeconds(int amount)` Return an OADateTime where a specified amount of milliseconds is added.
`OADateTime`	`addMinutes(int amount)` Return an OADateTime where a specified amount of minutes is added.
`OADateTime`	`addMonths(int amount)` Return an OADateTime where a specified amount of months is added.
`OADateTime`	`addSeconds(int amount)` Return an OADateTime where a specified amount of seconds is added.
`OADateTime`	`addWeeks(int amount)` Return an OADateTime where a specified amount of weeks added.
`OADateTime`	`addYears(int amount)` Return an OADateTime where a specified amount of years is added.
`boolean`	`after(Object obj)` Compares this OADateTime with any object.
`boolean`	`before(Object obj)` Compares this OADateTime with any object.
`int`	`betweenDays(Object obj)` Returns the number of days between this OADateTime and obj.
`int`	`betweenHours(Object obj)` Returns the number of hours betweeen this OADateTime and obj.
`long`	`betweenMilliSeconds(Object obj)` Returns the number of seconds betweeen this OADateTime and obj.
`int`	`betweenMinutes(Object obj)` Returns the number of minutes betweeen this OADateTime and obj.
`int`	`betweenMonths(Object obj)` Returns the number of months betweeen this OADateTime and obj.
`int`	`betweenSeconds(Object obj)` Returns the number of seconds betweeen this OADateTime and obj.
`int`	`betweenYears(Object obj)` Returns the number of years between this OADateTime and obj.
`void`	`clearDate()` sets date to 1/1/1970 (time 0)
`void`	`clearSecondAndMilliSecond()`
`void`	`clearTime()` Sets hour,minutes and seconds to zero.
`int`	`compare(Object obj)`
`int`	`compareTo(Object obj)` Compares this object with the specified object for order. Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.
`protected OADateTime`	`convert(Object obj, boolean bAlways)` Convert an Object to an OADateTime.
`OADateTime`	`convertTo(OATimeZone.TZ tz)`
`OADateTime`	`convertTo(TimeZone tz)` Convert the current dt to a different tz, which will adjust the (long) time value, affecting (year,month,day,hour) values Note: for OADate year,month,day(,hour,min..) are not affected, only the timezone Note: for OATime only hour and timezone are affected.
`OADateTime`	`convertToUTC()`
`boolean`	`equals(Object obj)` Compares this OADateTime with any object.
`protected static String`	`fixDate(String s)` Internally used to fix a String date.
`int`	`get12Hour()`
`int`	`get24Hour()` Gets the hour of the day based on 24 hour clock.
`int`	`getAM_PM()` returns Calendar.AM or Calendar.PM
`Calendar`	`getCalendar()` Returns a clone of the calendar used by this object.
`Date`	`getDate()` Returns java.util.Date object that matches this DateTime.
`int`	`getDay()`
`int`	`getDayOfWeek()` Returns day of week for date.
`int`	`getDayOfYear()` Returns day of year, where Jan 1 is 1.
`int`	`getDaysInMonth()` Returns number of days in this month.
`static TimeZone`	`getDefaultTimeZone()`
`int`	`getFirstWeekDayOfMonth(int weekday)`
`String`	`getFormat()` get format to use for this OADateTime
`static String`	`getFormat(int type)` Returns the format string to use for system format.
`static String`	`getFormat(int type, Locale locale)` Returns the format string to use for system format.
`protected static SimpleDateFormat`	`getFormatter()`
`static String`	`getGlobalOutputFormat()` Gets the default global format used when converting OADateTime to String.
`int`	`getHour()` Gets the hour of the day based on 24 hour clock.
`boolean`	`getIgnoreTimeZone()`
`Instant`	`getInstant()`
`int`	`getLastWeekDayOfMonth(int weekday)`
`LocalDateTime`	`getLocalDateTime()`
`int`	`getMilliSecond()` Return value of milliseconds.
`int`	`getMinute()` Return value of minutes.
`int`	`getMonth()` Get month, values between 0-11.
`int`	`getQuarter()` returns quarter from 0-3
`int`	`getSecond()` Return value of seconds.
`long`	`getTime()` Time as milliseconds, same as Date.getTime()
`TimeZone`	`getTimeZone()`
`int`	`getWeekOfMonth()` Returns the number of the week within the month, where first week is 1.
`int`	`getWeekOfYear()` Returns number week within the year, where first week is 1.
`int`	`getYear()` Returns year.
`ZonedDateTime`	`getZonedDateTime()`
`int`	`hashCode()`
`boolean`	`isAfter(Object obj)`
`boolean`	`isBefore(Object obj)` Compares this OADateTime with any object.
`boolean`	`isFirstWeekDayOfMonth(int weekday)`
`boolean`	`isLastDayOfMonth()`
`boolean`	`isLastWeekDayOfMonth(int weekday)`
`static void`	`main(String[] args)`
`static void`	`main2(String[] args)`
`static void`	`removeAllGlobalParseFormats()` Remove a all globally used parse format.
`static void`	`removeGlobalParseFormat(String fmt)` Remove a global parse format.
`void`	`set12Hour(int hr)`
`void`	`set24Hour(int hr)` Sets the hour of the day based on 24 hour clock.
`void`	`setAM_PM(int ap)` Calendar.AM or Calendar.PM
`protected void`	`setCalendar(Date date)`
`protected void`	`setCalendar(GregorianCalendar c)`
`protected void`	`setCalendar(int year, int month, int day, int hrs, int mins, int secs, int milsecs)`
`protected void`	`setCalendar(OADateTime dt)`
`protected void`	`setCalendar(String strDate)`
`protected void`	`setCalendar(String strDate, String fmt)`
`protected void`	`setCalendar(Time time)`
`protected void`	`setCalendar(Timestamp date)`
`void`	`setDate(int yr, int m, int d)` Sets year (ex: 2017), month (0-11), and day (1-31).
`void`	`setDate(OADate d)`
`void`	`setDay(int d)` Set the day of month, 1-31.
`static void`	`setDefaultTimeZone(TimeZone tz)`
`void`	`setFormat(String fmt)` Set format to use for this OADateTime This format will be used when converting this datetime to a String, unless a format is specified when calling toString.
`static void`	`setGlobalOutputFormat(String fmt)` Sets the default global format used when converting OADateTime to String.
`void`	`setHour(int hr)` Sets the hour of the day based on 24 hour clock.
`void`	`setIgnoreTimeZone(boolean b)`
`static void`	`setLocale(Locale loc)`
`void`	`setMilliSecond(int ms)` Sets value for milliseconds.
`void`	`setMinute(int mins)` Set value for minutes.
`void`	`setMonth(int month)` Set month, values between 0-11.
`void`	`setSecond(int s)` Sets value for seconds.
`void`	`setTime(int hr, int m)` Sets time.
`void`	`setTime(int hr, int m, int s)` Sets time.
`void`	`setTime(int hr, int m, int s, int ms)` Sets hour,minutes,seconds and milliseconds.
`void`	`setTime(OATime t)`
`void`	`setTimeZone(OATimeZone.TZ tz)`
`void`	`setTimeZone(TimeZone tz)` Change the tz and keep the same other values (day,month,hour,etc).
`void`	`setTimeZoneUTC()`
`void`	`setYear(int y)` Sets the year.
`OADateTime`	`subtractDay()`
`OADateTime`	`subtractDays(int amount)`
`OADateTime`	`subtractHours(int amount)`
`OADateTime`	`subtractMilliSeconds(int amount)`
`OADateTime`	`subtractMinutes(int amount)`
`OADateTime`	`subtractMonths(int amount)`
`OADateTime`	`subtractSeconds(int amount)`
`OADateTime`	`subtractWeeks(int amount)`
`OADateTime`	`subtractYears(int amount)`
`static void`	`test(int id)`
`String`	`toString()` Converts OADateTime to a String using specified formatting String. Uses the first format that has been set: "format", "staticOutputFormat" else or "yyyy-MMM-dd hh:mma"
`String`	`toString(String f)` Converts OADateTime to a String using specified formatting String.
`protected String`	`toStringMain(String format)`
`static OADateTime`	`valueOf(String strDateTime)` Converts a String date to an OADateTime.
`static OADateTime`	`valueOf(String strDateTime, String fmt)` Static method for converting a String date to an OADateTime. If date is " " (space) then todays date will be returned. If date is null or "" then null is returned.
`static OADateTime`	`valueOf(String strDateTime, String fmt, boolean bTryOtherFormats)`
`protected static Date`	`valueOfMain(String value, String inputFormat, Vector vec, String outputFormat)`

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

- Field Detail
  - FORMAT_long
```
public static final String FORMAT_long
```
    See Also:
    
    Constant Field Values
  - FORMAT_xlong
```
public static final String FORMAT_xlong
```
    See Also:
    
    Constant Field Values
  - _time
```
protected long _time
```
  - timeZone
```
protected TimeZone timeZone
```
  - ignoreTimeZone
```
protected boolean ignoreTimeZone
```
  - format
```
protected String format
```
  - RFC339Format
```
public static final String RFC339Format
```
    See Also:
    
    Constant Field Values
  - RFC339FormatWms
```
public static final String RFC339FormatWms
```
    See Also:
    
    Constant Field Values
  - staticOutputFormat
```
protected static String staticOutputFormat
```
    default output format
  - JsonFormat
```
public static final String JsonFormat
```
    See Also:
    
    Constant Field Values
  - JsonFormatTZ
```
public static final String JsonFormatTZ
```
    See Also:
    
    Constant Field Values
  - JdbcFormat
```
public static final String JdbcFormat
```
    See Also:
    
    Constant Field Values
  - SUNDAY
```
public static final int SUNDAY
```
    See Also:
    
    Constant Field Values
  - SUN
```
public static final int SUN
```
    See Also:
    
    Constant Field Values
  - MONDAY
```
public static final int MONDAY
```
    See Also:
    
    Constant Field Values
  - MON
```
public static final int MON
```
    See Also:
    
    Constant Field Values
  - TUESDAY
```
public static final int TUESDAY
```
    See Also:
    
    Constant Field Values
  - TUES
```
public static final int TUES
```
    See Also:
    
    Constant Field Values
  - TUE
```
public static final int TUE
```
    See Also:
    
    Constant Field Values
  - WEDNESDAY
```
public static final int WEDNESDAY
```
    See Also:
    
    Constant Field Values
  - WED
```
public static final int WED
```
    See Also:
    
    Constant Field Values
  - THURSDAY
```
public static final int THURSDAY
```
    See Also:
    
    Constant Field Values
  - THURS
```
public static final int THURS
```
    See Also:
    
    Constant Field Values
  - THU
```
public static final int THU
```
    See Also:
    
    Constant Field Values
  - FRIDAY
```
public static final int FRIDAY
```
    See Also:
    
    Constant Field Values
  - FRI
```
public static final int FRI
```
    See Also:
    
    Constant Field Values
  - SATURDAY
```
public static final int SATURDAY
```
    See Also:
    
    Constant Field Values
  - SAT
```
public static final int SAT
```
    See Also:
    
    Constant Field Values
  - JANUARY
```
public static final int JANUARY
```
    See Also:
    
    Constant Field Values
  - JAN
```
public static final int JAN
```
    See Also:
    
    Constant Field Values
  - FEBRUARY
```
public static final int FEBRUARY
```
    See Also:
    
    Constant Field Values
  - FEB
```
public static final int FEB
```
    See Also:
    
    Constant Field Values
  - MARCH
```
public static final int MARCH
```
    See Also:
    
    Constant Field Values
  - MAR
```
public static final int MAR
```
    See Also:
    
    Constant Field Values
  - APRIL
```
public static final int APRIL
```
    See Also:
    
    Constant Field Values
  - APR
```
public static final int APR
```
    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
  - JUN
```
public static final int JUN
```
    See Also:
    
    Constant Field Values
  - JULY
```
public static final int JULY
```
    See Also:
    
    Constant Field Values
  - JUL
```
public static final int JUL
```
    See Also:
    
    Constant Field Values
  - AUGUST
```
public static final int AUGUST
```
    See Also:
    
    Constant Field Values
  - AUG
```
public static final int AUG
```
    See Also:
    
    Constant Field Values
  - SEPTEMBER
```
public static final int SEPTEMBER
```
    See Also:
    
    Constant Field Values
  - SEPT
```
public static final int SEPT
```
    See Also:
    
    Constant Field Values
  - SEP
```
public static final int SEP
```
    See Also:
    
    Constant Field Values
  - OCTOBER
```
public static final int OCTOBER
```
    See Also:
    
    Constant Field Values
  - OCT
```
public static final int OCT
```
    See Also:
    
    Constant Field Values
  - NOVEMBER
```
public static final int NOVEMBER
```
    See Also:
    
    Constant Field Values
  - NOV
```
public static final int NOV
```
    See Also:
    
    Constant Field Values
  - DECEMBER
```
public static final int DECEMBER
```
    See Also:
    
    Constant Field Values
  - DEC
```
public static final int DEC
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - OADateTime
```
public OADateTime()
```
    Creates new datetime, using current date and time.
  - OADateTime
```
public OADateTime(Time time)
```
    Creates new datetime, using time parameter.
  - OADateTime
```
public OADateTime(Date date)
```
    Creates new datetime, using date parameter.
  - OADateTime
```
public OADateTime(long time)
```
    Creates new datetime, using date parameter.
  - OADateTime
```
public OADateTime(Timestamp date)
```
    Creates new datetime, using timestamp parameter.
  - OADateTime
```
public OADateTime(Calendar c)
```
    Creates new datetime, using Calendar parameter.
  - OADateTime
```
public OADateTime(OADateTime odt)
```
    Creates new datetime, using OADateTime parameter.
  - OADateTime
```
public OADateTime(LocalDateTime ldt)
```
  - OADateTime
```
public OADateTime(Instant instant)
```
  - OADateTime
```
public OADateTime(ZonedDateTime zdt)
```
  - OADateTime
```
public OADateTime(String strDate)
```
    Creates new datetime, using String parameter.
    
    See Also:
    
    valueOf(String)
  - OADateTime
```
public OADateTime(String strDate,
                  String format)
```
    Creates new datetime, using String parameter and format.
    
    See Also:
    
    valueOf(String)
  - OADateTime
```
public OADateTime(OADate d,
                  OATime t)
```
    Creates new datetime, using date and time.
  - OADateTime
```
public OADateTime(int year,
                  int month,
                  int day)
```
    Parameters:
    
    year - full year (not year minus 1900 like Date)
    
    month - 0-11
    
    day - day of the month 1-31
  - OADateTime
```
public OADateTime(int year,
                  int month,
                  int day,
                  int hrs,
                  int mins)
```
  - OADateTime
```
public OADateTime(int year,
                  int month,
                  int day,
                  int hrs,
                  int mins,
                  int secs)
```
  - OADateTime
```
public OADateTime(int year,
                  int month,
                  int day,
                  int hrs,
                  int mins,
                  int secs,
                  int milsecs)
```
    Parameters:
    
    year - full year (not year minus 1900 like Date)
    
    month - 0-11
    
    day - day of the month
- Method Detail
  - setDefaultTimeZone
```
public static void setDefaultTimeZone(TimeZone tz)
```
  - getDefaultTimeZone
```
public static TimeZone getDefaultTimeZone()
```
  - _getCal
```
protected GregorianCalendar _getCal()
```
  - _releaseCal
```
protected void _releaseCal(GregorianCalendar cal)
```
  - setLocale
```
public static void setLocale(Locale loc)
```
  - getLocalDateTime
```
public LocalDateTime getLocalDateTime()
```
  - getZonedDateTime
```
public ZonedDateTime getZonedDateTime()
```
  - getInstant
```
public Instant getInstant()
```
  - getCalendar
```
public Calendar getCalendar()
```
    Returns a clone of the calendar used by this object.
  - setCalendar
```
protected void setCalendar(int year,
                           int month,
                           int day,
                           int hrs,
                           int mins,
                           int secs,
                           int milsecs)
```
  - setCalendar
```
protected void setCalendar(GregorianCalendar c)
```
  - setCalendar
```
protected void setCalendar(Timestamp date)
```
  - setCalendar
```
protected void setCalendar(Date date)
```
  - setCalendar
```
protected void setCalendar(Time time)
```
  - setCalendar
```
protected void setCalendar(OADateTime dt)
```
  - setCalendar
```
protected void setCalendar(String strDate)
```
  - setCalendar
```
protected void setCalendar(String strDate,
                           String fmt)
```
  - clearTime
```
public void clearTime()
```
    Sets hour,minutes and seconds to zero.
  - clearDate
```
public void clearDate()
```
    sets date to 1/1/1970 (time 0)
  - setTime
```
public void setTime(int hr,
                    int m)
```
    Sets time.
    
    See Also:
    
    setTime
  - setTime
```
public void setTime(int hr,
                    int m,
                    int s)
```
    Sets time.
    
    See Also:
    
    setTime
  - setTime
```
public void setTime(int hr,
                    int m,
                    int s,
                    int ms)
```
    Sets hour,minutes,seconds and milliseconds.
  - setTime
```
public void setTime(OATime t)
```
  - setDate
```
public void setDate(int yr,
                    int m,
                    int d)
```
    Sets year (ex: 2017), month (0-11), and day (1-31).
  - setDate
```
public void setDate(OADate d)
```
  - getYear
```
public int getYear()
```
    Returns year. This is the real, unlike java.util.Date, which is the date minus 1900.
  - setYear
```
public void setYear(int y)
```
    Sets the year. This is the real, unlike java.util.Date, which is the date minus 1900.
  - getMonth
```
public int getMonth()
```
    Get month, values between 0-11.
    
    Returns:
    
    month as 0-11
  - getQuarter
```
public int getQuarter()
```
    returns quarter from 0-3
    
    Returns:
  - setMonth
```
public void setMonth(int month)
```
    Set month, values between 0-11.
    
    Parameters:
    
    month - must be between 0-11.
  - getDay
```
public int getDay()
```
    Returns:
    
    day of month, 1-31.
  - setDay
```
public void setDay(int d)
```
    Set the day of month, 1-31.
  - setTimeZoneUTC
```
public void setTimeZoneUTC()
```
  - setTimeZone
```
public void setTimeZone(OATimeZone.TZ tz)
```
  - setTimeZone
```
public void setTimeZone(TimeZone tz)
```
    Change the tz and keep the same other values (day,month,hour,etc). This changes the time (long) value. Use convertTo(tz) to have values adjusted and the time (long) to stay the same.
  - getTimeZone
```
public TimeZone getTimeZone()
```
    See Also:
    
    OATimeZone
  - getHour
```
public int getHour()
```
    Gets the hour of the day based on 24 hour clock.
    
    Returns:
    
    the Hour 0-23
    
    See Also:
    
    get12Hour(), get24Hour(), getAM_PM()
  - setHour
```
public void setHour(int hr)
```
    Sets the hour of the day based on 24 hour clock.
    
    Parameters:
    
    hr - is the Hour 0-12
    
    See Also:
    
    setAM_PM(int), set12Hour(int), set24Hour(int)
  - get12Hour
```
public int get12Hour()
```
  - set12Hour
```
public void set12Hour(int hr)
```
  - get24Hour
```
public int get24Hour()
```
    Gets the hour of the day based on 24 hour clock.
    
    Returns:
    
    Hour 0-23
    
    See Also:
    
    setAM_PM(int), setHour(int)
  - set24Hour
```
public void set24Hour(int hr)
```
    Sets the hour of the day based on 24 hour clock.
    
    Parameters:
    
    hr - is the Hour 0-23
    
    See Also:
    
    setAM_PM(int), setHour(int)
  - getAM_PM
```
public int getAM_PM()
```
    returns Calendar.AM or Calendar.PM
  - setAM_PM
```
public void setAM_PM(int ap)
```
    Calendar.AM or Calendar.PM
  - getMinute
```
public int getMinute()
```
    Return value of minutes.
  - setMinute
```
public void setMinute(int mins)
```
    Set value for minutes.
  - getSecond
```
public int getSecond()
```
    Return value of seconds.
  - setSecond
```
public void setSecond(int s)
```
    Sets value for seconds.
  - clearSecondAndMilliSecond
```
public void clearSecondAndMilliSecond()
```
  - getMilliSecond
```
public int getMilliSecond()
```
    Return value of milliseconds.
  - setMilliSecond
```
public void setMilliSecond(int ms)
```
    Sets value for milliseconds.
  - getDate
```
public Date getDate()
```
    Returns java.util.Date object that matches this DateTime.
  - getDayOfWeek
```
public int getDayOfWeek()
```
    Returns day of week for date. See Calendar for list of days (ex: SUNDAY).
    
    See Also:
    
    Calendar
  - getDayOfYear
```
public int getDayOfYear()
```
    Returns day of year, where Jan 1 is 1.
  - getWeekOfMonth
```
public int getWeekOfMonth()
```
    Returns the number of the week within the month, where first week is 1.
  - getWeekOfYear
```
public int getWeekOfYear()
```
    Returns number week within the year, where first week is 1.
  - getDaysInMonth
```
public int getDaysInMonth()
```
    Returns number of days in this month.
  - equals
```
public boolean equals(Object obj)
```
    Compares this OADateTime with any object. If object is not an OADateTime, it will be converted and then compared.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - Date, OADate, Calendar, String, etc.
    
    See Also:
    
    compareTo(java.lang.Object)
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - before
```
public boolean before(Object obj)
```
    Compares this OADateTime with any object. If object is not an OADateTime, it will be converted and then compared.
    
    Parameters:
    
    obj - Date, OADate, Calendar, String, etc.
    
    See Also:
    
    compareTo(java.lang.Object)
  - isBefore
```
public boolean isBefore(Object obj)
```
    Compares this OADateTime with any object. If object is not an OADateTime, it will be converted and then compared.
    
    Parameters:
    
    obj - Date, OADate, Calendar, String, etc.
    
    See Also:
    
    compareTo(java.lang.Object)
  - after
```
public boolean after(Object obj)
```
    Compares this OADateTime with any object. If object is not an OADateTime, it will be converted and then compared.
    
    Parameters:
    
    obj - Date, OADate, Calendar, String, etc.
    
    See Also:
    
    compareTo(java.lang.Object)
  - isAfter
```
public boolean isAfter(Object obj)
```
  - compare
```
public int compare(Object obj)
```
  - compareTo
```
public int compareTo(Object obj)
```
    Compares this object with the specified object for order.
    Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.
    
    Specified by:
    
    compareTo in interface Comparable
    
    Parameters:
    
    obj - Date, OADate, Calendar, String
    
    Returns:
    
    "0" if equal, "-1" if this OADateTime is less than, "1" if this OADateTime is greater than, "2" if objects can not be compared.
  - convertToUTC
```
public OADateTime convertToUTC()
```
  - convertTo
```
public OADateTime convertTo(TimeZone tz)
```
    Convert the current dt to a different tz, which will adjust the (long) time value, affecting (year,month,day,hour) values Note: for OADate year,month,day(,hour,min..) are not affected, only the timezone Note: for OATime only hour and timezone are affected.
  - convertTo
```
public OADateTime convertTo(OATimeZone.TZ tz)
```
  - addDays
```
public OADateTime addDays(int amount)
```
    Return an OADateTime where a specified amount of days is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of days to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractDays
```
public OADateTime subtractDays(int amount)
```
  - addDay
```
public OADateTime addDay()
```
  - subtractDay
```
public OADateTime subtractDay()
```
  - addWeeks
```
public OADateTime addWeeks(int amount)
```
    Return an OADateTime where a specified amount of weeks added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of weeks to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractWeeks
```
public OADateTime subtractWeeks(int amount)
```
  - addMonths
```
public OADateTime addMonths(int amount)
```
    Return an OADateTime where a specified amount of months is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of months to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractMonths
```
public OADateTime subtractMonths(int amount)
```
  - addYears
```
public OADateTime addYears(int amount)
```
    Return an OADateTime where a specified amount of years is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of years to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractYears
```
public OADateTime subtractYears(int amount)
```
  - addHours
```
public OADateTime addHours(int amount)
```
    Return an OADateTime where a specified amount of hours is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of hours to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractHours
```
public OADateTime subtractHours(int amount)
```
  - addMinutes
```
public OADateTime addMinutes(int amount)
```
    Return an OADateTime where a specified amount of minutes is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of minutes to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractMinutes
```
public OADateTime subtractMinutes(int amount)
```
  - addSeconds
```
public OADateTime addSeconds(int amount)
```
    Return an OADateTime where a specified amount of seconds is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of seconds to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractSeconds
```
public OADateTime subtractSeconds(int amount)
```
  - addMilliSeconds
```
public OADateTime addMilliSeconds(int amount)
```
    Return an OADateTime where a specified amount of milliseconds is added.
    Note: if this is an instanceof OADate or OATime, then the returned object will be the same type.
    
    Parameters:
    
    amount - number of milliseconds to increment/deincrement (negative number).
    
    Returns:
    
    new OADateTime object.
  - subtractMilliSeconds
```
public OADateTime subtractMilliSeconds(int amount)
```
  - betweenYears
```
public int betweenYears(Object obj)
```
    Returns the number of years between this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenMonths
```
public int betweenMonths(Object obj)
```
    Returns the number of months betweeen this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenDays
```
public int betweenDays(Object obj)
```
    Returns the number of days between this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenHours
```
public int betweenHours(Object obj)
```
    Returns the number of hours betweeen this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenMinutes
```
public int betweenMinutes(Object obj)
```
    Returns the number of minutes betweeen this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenSeconds
```
public int betweenSeconds(Object obj)
```
    Returns the number of seconds betweeen this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - betweenMilliSeconds
```
public long betweenMilliSeconds(Object obj)
```
    Returns the number of seconds betweeen this OADateTime and obj.
    
    Parameters:
    
    obj - Date, OADateTime, Calendar, etc that can be converted to an OADateTime.
  - getTime
```
public long getTime()
```
    Time as milliseconds, same as Date.getTime()
  - convert
```
protected OADateTime convert(Object obj,
                             boolean bAlways)
```
    Convert an Object to an OADateTime.
  - valueOf
```
public static OADateTime valueOf(String strDateTime,
                                 String fmt)
```
    Static method for converting a String date to an OADateTime.
    If date is " " (space) then todays date will be returned.
    If date is null or "" then null is returned.
    
    Parameters:
    
    fmt - format of date. If not valid, then staticParseFormats and staticOutputFormat will be used.
    
    Returns:
    
    OADateTime or null
    
    See Also:
    
    setFormat(java.lang.String), to convert a string using global parse strings
  - valueOf
```
public static OADateTime valueOf(String strDateTime,
                                 String fmt,
                                 boolean bTryOtherFormats)
```
  - fixDate
```
protected static String fixDate(String s)
```
    Internally used to fix a String date.
  - valueOf
```
public static OADateTime valueOf(String strDateTime)
```
    Converts a String date to an OADateTime.
    If value is " " (space) then todays date/time will be returned.
    If value is null or "" then null is returned.
    StaticParseFormats and staticOutputFormat will be used to try to convert.
    
    Returns:
    
    OADateTime or null
    
    See Also:
    
    setFormat(java.lang.String), setGlobalOutputFormat(java.lang.String), see #getGlobalParseFormats, valueOf(String,String)
  - valueOfMain
```
protected static Date valueOfMain(String value,
                                  String inputFormat,
                                  Vector vec,
                                  String outputFormat)
```
  - toString
```
public String toString()
```
    Converts OADateTime to a String using specified formatting String.
    Uses the first format that has been set: "format", "staticOutputFormat" else or "yyyy-MMM-dd hh:mma"
    
    Overrides:
    
    toString in class Object
  - toString
```
public String toString(String f)
```
    Converts OADateTime to a String using specified formatting String.
    
    Parameters:
    
    f - is format to apply
  - toStringMain
```
protected String toStringMain(String format)
```
  - setGlobalOutputFormat
```
public static void setGlobalOutputFormat(String fmt)
```
    Sets the default global format used when converting OADateTime to String.
    
    See Also:
    
    setFormat(java.lang.String)
  - getGlobalOutputFormat
```
public static String getGlobalOutputFormat()
```
    Gets the default global format used when converting OADateTime to String.
    
    See Also:
    
    setFormat(java.lang.String)
  - addGlobalParseFormat
```
public static void addGlobalParseFormat(String fmt)
```
    Add additional global parse formats that are used when converting a String to OADateTime.
    
    See Also:
    
    setFormat(java.lang.String)
  - removeGlobalParseFormat
```
public static void removeGlobalParseFormat(String fmt)
```
    Remove a global parse format.
    
    See Also:
    
    addGlobalParseFormat
  - removeAllGlobalParseFormats
```
public static void removeAllGlobalParseFormats()
```
    Remove a all globally used parse format.
    
    See Also:
    
    addGlobalParseFormat
  - setFormat
```
public void setFormat(String fmt)
```
    Set format to use for this OADateTime This format will be used when converting this datetime to a String, unless a format is specified when calling toString.
    
    See Also:
    
    OADateTime, toString()
  - getFormat
```
public String getFormat()
```
    get format to use for this OADateTime
    
    See Also:
    
    OADateTime
  - getFormatter
```
protected static SimpleDateFormat getFormatter()
```
  - getFormat
```
public static String getFormat(int type)
```
    Returns the format string to use for system format.
    
    Parameters:
    
    type - DateFormat.SHORT, MEDIUM, LONG, FULL, DEFAULT
  - getFormat
```
public static String getFormat(int type,
                               Locale locale)
```
    Returns the format string to use for system format.
    
    Parameters:
    
    type - DateFormat.SHORT, MEDIUM, LONG, FULL, DEFAULT
  - isLastDayOfMonth
```
public boolean isLastDayOfMonth()
```
  - isFirstWeekDayOfMonth
```
public boolean isFirstWeekDayOfMonth(int weekday)
```
  - isLastWeekDayOfMonth
```
public boolean isLastWeekDayOfMonth(int weekday)
```
  - getLastWeekDayOfMonth
```
public int getLastWeekDayOfMonth(int weekday)
```
  - getFirstWeekDayOfMonth
```
public int getFirstWeekDayOfMonth(int weekday)
```
  - setIgnoreTimeZone
```
public void setIgnoreTimeZone(boolean b)
```
  - getIgnoreTimeZone
```
public boolean getIgnoreTimeZone()
```
  - main2
```
public static void main2(String[] args)
                  throws Exception
```
    Throws:
    
    Exception
  - main
```
public static void main(String[] args)
                 throws Exception
```
    Throws:
    
    Exception
  - test
```
public static void test(int id)
```

Class OADateTime

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FORMAT_long

FORMAT_xlong

_time

timeZone

ignoreTimeZone

format

RFC339Format

RFC339FormatWms

staticOutputFormat

JsonFormat

JsonFormatTZ

JdbcFormat

SUNDAY

SUN

MONDAY

MON

TUESDAY

TUES

TUE

WEDNESDAY

WED

THURSDAY

THURS

THU

FRIDAY

FRI

SATURDAY

SAT

JANUARY

JAN

FEBRUARY

FEB

MARCH

MAR

APRIL

APR

MAY

JUNE

JUN

JULY

JUL

AUGUST

AUG

SEPTEMBER

SEPT

SEP

OCTOBER

OCT

NOVEMBER

NOV

DECEMBER

DEC

Constructor Detail

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

OADateTime

Method Detail

setDefaultTimeZone

getDefaultTimeZone

_getCal