com.viaoa.util.OADate Maven / Gradle / Ivy
Show all versions of oa-core Show documentation
/* Copyright 1999 Vince Via [email protected]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package com.viaoa.util;
import java.sql.Time;
import java.text.DateFormat;
import java.time.LocalDate;
import java.util.*;
/**
* Date class that combines Calendar, Date and SimpleDateFormat into a single class.
*
* OADate is not affected by timezone. A date created on one system will be the same on another machine, even if the timezone is different.
* See OADateTime for list or formatting symbols.
*
* @see OADateTime
*/
public class OADate extends OADateTime {
private static final long serialVersionUID = 1L;
public final static String Format1 = "yyyy-MM-dd";
public final static String Format2 = "MM/dd/yyyy";
public final static String Format3 = "yyyyMMdd";
public final static String Format4 = "yyyy-MMM-dd";
public final static String Format5 = "MMM dd, yyyy";
public final static String Format6 = "MMM dd, yy";
public final static String JdbcFormat = "yyyy-MM-dd"; // SQL
public final static String JsonFormat = Format1;
// format used by browser: "YYYY-MM-DD";
// same as JsonFormat
// public final static String HtmlInputDateFormat = "yyyy-MM-dd"; // java format to use
// Unique for this subclass
/** default output format. Default is DateFormat.SHORT */
protected static String dateOutputFormat;
/** default parse formats: "MM/dd/yy", "MM/dd/yyyy" or "dd/MM/yy", "dd/MM/yyyy" */
private static Vector vecDateParseFormat = new Vector(10, 10);
static {
setLocale(Locale.getDefault());
}
public static void setLocale(Locale loc) {
vecDateParseFormat = new Vector(15, 10);
String s = getFormat(DateFormat.SHORT, loc);
boolean bMonthFirst = true;
boolean bYearFirst = false;
if (s != null && s.length() > 0) {
char ch = s.charAt(0);
if (ch != 'M') {
bMonthFirst = false;
}
if (ch == 'y') {
bYearFirst = true;
}
;
vecDateParseFormat.addElement(s);
}
if (bMonthFirst) {
vecDateParseFormat.addElement("MM/dd/yy"); // must be before "MM/dd/yyyy" since "MM/dd/yyyy" will convert 5/4/65 -> 05/04/0065
vecDateParseFormat.addElement("MM/dd/yyyy");
dateOutputFormat = "MM/dd/yyyy";
} else if (bYearFirst) {
vecDateParseFormat.addElement("yy/MM/dd"); // must be before "MM/dd/yyyy" since "MM/dd/yyyy" will convert 5/4/65 -> 05/04/0065
vecDateParseFormat.addElement("yyyy/MM/ddy");
dateOutputFormat = "yyyy/MM/dd";
} else { // day first
vecDateParseFormat.addElement("dd/MM/yy");
vecDateParseFormat.addElement("dd/MM/yyyy");
dateOutputFormat = "dd/MM/yyyy";
}
// SQL date formats
vecDateParseFormat.addElement("yyyy-MM-dd");
}
/**
* Create a new date that uses todays date. Same as new OADate(new Date())
*/
public OADate() {
super(new Date());
clearTime();
}
/**
* Create a new date that uses a specified Date.
*/
public OADate(Date date) {
super(date);
clearTime();
}
public OADate(long time) {
this(new Date(time));
}
/**
* Create a new date that uses a specified Time.
*/
public OADate(Time time) {
super(time);
clearTime();
}
public OADate(LocalDate ld) {
this(new Date(ld.getYear() - 1900, (ld.getMonth().getValue()) - 1, ld.getDayOfMonth()));
}
/**
* Create a new date that uses a specified Calendar.
*/
public OADate(Calendar c) {
super(c.get(c.YEAR), c.get(c.MONTH), c.get(c.DATE));
this.timeZone = c.getTimeZone();
}
/**
* Create a new date that uses a specified OADateTime.
*/
public OADate(OADateTime odt) {
super(odt.getYear(), odt.getMonth(), odt.getDay());
this.timeZone = odt.getTimeZone();
}
/**
* Create a new date from a specified String.
*
*
* @see OADate#valueOf
*/
public OADate(String strDate) {
this(OADate.valueOf2(strDate));
clearTime();
}
/**
* Create a new date from a specified String, using a specified format.
*
*
* @see OADateTime
* @see OADate#valueOf
*/
public OADate(String strDate, String format) {
super(strDate, format);
clearTime();
}
/**
* Create new date using year, month, day.
*
* @param year full year (not year minus 1900 like Date) param month 0-11, use Calendar.JUNE, etc. param date day of the month (1-31)
*/
public OADate(int year, int month, int day) {
super(year, month, day);
clearTime();
}
/**
* Sets the default global format used when converting OADate to String. This format will be used if this dates format has not been set
* and a format is not specified.
*
* @see #setFormat
*/
public static void setGlobalOutputFormat(String fmt) {
dateOutputFormat = fmt;
}
/**
* Returns the default global format used when converting OADate to String.
*/
public static String getGlobalOutputFormat() {
return dateOutputFormat;
}
/**
* Sets the default global parse format used when converting a String to OADate.
*
* @see #setFormat
*/
public static void addGlobalParseFormat(String fmt) {
vecDateParseFormat.addElement(fmt);
}
/**
* Removes a global parse format used when converting a String to OADate.
*/
public static void removeGlobalParseFormat(String fmt) {
vecDateParseFormat.removeElement(fmt);
}
/**
* Removes all global parse formats that are used to convert Strings to OADates.
*/
public static void removeAllGlobalParseFormats() {
vecDateParseFormat.removeAllElements();
}
/**
* Compares this date with two dates to see if this date is between them.
*
* @return true if this.OADate is GreaterThan or Equal to Obj1 and LessThan or Equal Obj2 param obj Date, OADate, Calendar
* @param obj2 Date, OADate, Calendar
*/
public boolean between(Object obj1, Object obj2) {
int i = compareTo(obj1);
if (i < 0) {
return false;
}
i = compareTo(obj2);
return (i <= 0);
}
public boolean betweenOrEqual(Object obj1, Object obj2) {
return isBetweenOrEqual(obj1, obj2);
}
public boolean isBetweenOrEqual(Object obj1, Object obj2) {
int i = compareTo(obj1);
if (i < 0) {
return false;
}
i = compareTo(obj2);
return (i <= 0);
}
public boolean betweenNotEqual(Object obj1, Object obj2) {
return isBetweenNotEqual(obj1, obj2);
}
public boolean isBetweenNotEqual(Object obj1, Object obj2) {
int i = compareTo(obj1);
if (i <= 0) {
return false;
}
i = compareTo(obj2);
return (i < 0);
}
/**
* Converts this date to a String value using default format. The default format is the first format that has been set: "format",
* "dateOutputFormat" else or "yyyy-MMM-dd" See OADateTime for list of formatting symbols.
*
* @see OADateTime
*/
public String toString() {
return toString(null);
}
/**
* Converts this date to a String value using specified format. See OADateTime for list of formatting symbols.
*
* @see OADateTime
*/
public String toString(String f) {
if (f == null) {
f = (format == null) ? dateOutputFormat : format;
if (f == null || f.length() == 0) {
f = "yyyy-MMM-dd";
}
}
return toStringMain(f);
}
/**
* Converts a String to an OADate.
*
* @see #valueOf(String,String)
*/
public static OADate dateValue(String date, String fmt) {
return (OADate) valueOf(date, fmt);
}
/**
* Converts a String to an OADate.
*
* @see #valueOf(String,String)
*/
public static OADate dateValue(String date) {
return (OADate) valueOf(date, null);
}
/**
* Converts a String to an OADate. See OADateTime for list of formatting symbols. If date can not be parsed based on supplied format,
* then other formatting and conversions will be used to try to convert to an OADate.
*
* @param fmt is format to use for parsing. See OADateTime for list of formatting symbols.
* @see OADateTime
* @see #valueOf(String,String)
* @see OADateTime
*/
public static OADateTime valueOf(String date, String fmt) {
if (date == null) {
return null;
}
Date d = valueOfMain(date, fmt, vecDateParseFormat, dateOutputFormat);
if (d == null) {
if (date.length() < 6 && OAString.isNumber(date)) {
return OADate.valueOf(date + "/" + (new OADate()).getYear());
}
d = valueOfMain(fixDate(date), fmt, vecDateParseFormat, dateOutputFormat);
if (d == null) {
return null;
}
}
return new OADate(d);
}
/**
* Converts a String to an OADate.
*
* @see #valueOf(String,String)
*/
public static OADateTime valueOf(String date) {
return OADate.valueOf(date, null);
}
/**
* Throws an exception if date if not valid.
*/
public static OADateTime valueOf2(String date) {
OADateTime dt = OADate.valueOf(date, null);
if (dt == null) {
throw new IllegalArgumentException("OADate cant create date from String \"" + date + "\"");
}
return dt;
}
public LocalDate getLocalDate() {
LocalDate ld = LocalDate.of(getYear(), getMonth() + 1, getDay());
return ld;
}
}