org.dbflute.helper.HandyDate Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of dbflute-runtime Show documentation
Show all versions of dbflute-runtime Show documentation
The runtime library of DBFlute
/*
* Copyright 2014-2023 the original author or authors.
*
* 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 org.dbflute.helper;
import java.io.Serializable;
import java.sql.Timestamp;
import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.Month;
import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;
import java.util.Locale;
import java.util.TimeZone;
import org.dbflute.exception.ParseDateExpressionFailureException;
import org.dbflute.helper.message.ExceptionMessageBuilder;
import org.dbflute.helper.secretary.BusinessDayDeterminer;
import org.dbflute.helper.secretary.DateCompareCallback;
import org.dbflute.helper.secretary.LocalDateCompareCallback;
import org.dbflute.helper.secretary.LocalDateTimeCompareCallback;
import org.dbflute.system.DBFluteSystem;
import org.dbflute.util.DfTypeUtil;
import org.dbflute.util.DfTypeUtil.ParseDateException;
/**
* The date which provides you handy manipulations for Date.
*
* e.g.
* HandyDate date = new HandyDate("2011/11/27 12:34:56.789");
* date.addDay(1); // 2011/11/28 12:34:56.789
* date.addMonth(1); // 2011/12/28 12:34:56.789
* date.moveToDayJust(); // 2011/12/28 00:00:00.000
* date.moveToMonthTerminal(); // 2011/12/31 23:59:59.999
* date.isYear(2011); // true
* if (date.isGreaterThan(toDate("2011/12/30"))) { // true
* // 2011/12/31 23:59:59.999
* java.util.Date movedDate = date.getDate();
* java.sql.Timestamp movedTimestamp = date.getTimestampDate();
* }
* date.calculateDistanceDays(toDate("2011/11/30")); // 3
*
* The internal calendar uses default time-zone as default.
* You can change the time-zone for it.
*
* e.g.
* new HandyDate(date).timeZone(timeZone);
*
* @author jflute
* @since 0.9.9.2A (2011/11/17 Thursday)
*/
public class HandyDate implements Serializable {
// ===================================================================================
// Definition
// ==========
private static final long serialVersionUID = -5181512291555841795L;
// ===================================================================================
// Attribute
// =========
protected final Calendar _cal;
protected int _yearBeginMonth;
protected int _monthBeginDay;
protected int _dayBeginHour;
protected int _weekBeginDay;
// *you should also fix clone() when you add attributes
// ===================================================================================
// Constructor
// ===========
/**
* Construct the handy date by the specified local date for the default time-zone.
*
* e.g.
* Date adjusted = new HandyDate(localDate).addDay(3).getDate();
*
* @param localDate The instance of the local date. (NotNull)
*/
public HandyDate(LocalDate localDate) { // #date_parade
assertConstructorArgNotNull("localDate", localDate);
_cal = createCalendar(null, null); // means default zone
prepareDefaultBeginAttribute();
_cal.setTime(DfTypeUtil.toDate(localDate));
}
/**
* Construct the handy date by the specified local date.
*
* e.g.
* Date adjusted = new HandyDate(localDate, timeZone).addDay(3).getDate();
*
* @param localDate The instance of the local date. (NotNull)
* @param timeZone The time-zone to parse as date and for internal calendar. (NotNull)
*/
public HandyDate(LocalDate localDate, TimeZone timeZone) {
assertConstructorArgNotNull("localDate", localDate);
assertConstructorArgNotNull("timeZone", timeZone);
_cal = createCalendar(timeZone, null);
prepareDefaultBeginAttribute();
_cal.setTime(DfTypeUtil.toDate(localDate, timeZone));
}
/**
* Construct the handy date by the specified local date-time for the default time-zone.
*
* e.g.
* Date adjusted = new HandyDate(localDateTime).addDay(3).getDate();
*
* @param localDateTime The instance of the local date-time. (NotNull)
*/
public HandyDate(LocalDateTime localDateTime) {
assertConstructorArgNotNull("localDateTime", localDateTime);
_cal = createCalendar(null, null); // means default zone
prepareDefaultBeginAttribute();
_cal.setTime(DfTypeUtil.toDate(localDateTime));
}
/**
* Construct the handy date by the specified local date-time.
*
* e.g.
* Date adjusted = new HandyDate(localDateTime, timeZone).addDay(3).getDate();
*
* @param localDateTime The instance of the local date-time. (NotNull)
* @param timeZone The time-zone to parse as date and for internal calendar. (NotNull)
*/
public HandyDate(LocalDateTime localDateTime, TimeZone timeZone) {
assertConstructorArgNotNull("localDateTime", localDateTime);
assertConstructorArgNotNull("timeZone", timeZone);
_cal = createCalendar(timeZone, null);
prepareDefaultBeginAttribute();
_cal.setTime(DfTypeUtil.toDate(localDateTime, timeZone));
}
/**
* Construct the handy date by the specified date.
* The specified date is not changed by this handy date.
*
* e.g.
* Date adjusted = new HandyDate(date).addDay(3).getDate();
*
* The internal calendar uses default time-zone as default.
* You can change the time-zone for it.
*
* e.g.
* new HandyDate(date).timeZone(timeZone);
*
* @param date The instance of the date. (NotNull)
*/
public HandyDate(Date date) {
assertConstructorArgNotNull("date", date);
_cal = createCalendar(null, null); // means default zone
prepareDefaultBeginAttribute();
_cal.setTime(date);
}
/**
* Construct the handy date by the string expression for the default time-zone.
*
* e.g.
* o new HandyDate("2001/01/01"): 2001-01-01 00:00:00.000
* o new HandyDate("2001-01-01"): 2001-01-01 00:00:00.000
* o new HandyDate("2001/01/01 12:34:56"): 2001-01-01 12:34:56.000
* o new HandyDate("2001/01/01 12:34:56.798"): 2001-01-01 12:34:56.789
* o new HandyDate("date 20010101"): 2001-01-01
*
* @param exp The string expression of the date. (NotNull, NotEmpty)
* @throws ParseDateExpressionFailureException When it fails to parse the expression.
*/
public HandyDate(String exp) {
assertConstructorArgNotNullAndNotEmpty("exp", exp);
_cal = createCalendar(null, null); // means default zone
prepareDefaultBeginAttribute();
try {
_cal.setTime(DfTypeUtil.toDate(exp));
} catch (ParseDateException e) {
throwParseDateExpressionFailureException(exp, e);
}
}
/**
* Construct the handy date by the string expression for the specified time-zone.
*
* e.g.
* TimeZone timeZone = ...
* o new HandyDate("2001/01/01", timeZone): 2001-01-01 00:00:00.000
* o new HandyDate("2001-01-01", timeZone): 2001-01-01 00:00:00.000
* o new HandyDate("2001/01/01 12:34:56", timeZone): 2001-01-01 12:34:56.000
* o new HandyDate("2001/01/01 12:34:56.798", timeZone): 2001-01-01 12:34:56.789
* o new HandyDate("date 20010101", timeZone): 2001-01-01
*
* @param exp The string expression of the date. (NotNull, NotEmpty)
* @param timeZone The time-zone to parse as date and for internal calendar. (NotNull)
* @throws ParseDateExpressionFailureException When it fails to parse the expression.
*/
public HandyDate(String exp, TimeZone timeZone) {
assertConstructorArgNotNullAndNotEmpty("exp", exp);
assertConstructorArgNotNull("timeZone", timeZone);
_cal = createCalendar(timeZone, null);
prepareDefaultBeginAttribute();
try {
_cal.setTime(DfTypeUtil.toDate(exp, timeZone));
} catch (ParseDateException e) {
throwParseDateExpressionFailureException(exp, e);
}
}
/**
* Construct the handy date by the string expression for the default time-zone.
*
* e.g.
* new HandyDate("20010101", "yyyyMMdd"): 2001-01-01 00:00:00.000
*
* @param exp The string expression of the date. (NotNull, NotEmpty)
* @param pattern The pattern to parse as date. (NotNull, NotEmpty)
* @throws ParseDateExpressionFailureException When it fails to parse the expression.
*/
public HandyDate(String exp, String pattern) {
assertConstructorArgNotNullAndNotEmpty("exp", exp);
assertConstructorArgNotNullAndNotEmpty("pattern", pattern);
_cal = createCalendar(null, null); // means default zone
prepareDefaultBeginAttribute();
try {
_cal.setTime(DfTypeUtil.toDate(exp, pattern));
} catch (ParseDateException e) {
throwParseDateExpressionFailureException(exp, e);
}
}
/**
* Construct the handy date by the string expression for the default time-zone.
*
* e.g.
* Locale locale = ...
* new HandyDate("20010101", "yyyyMMdd", locale): 2001-01-01 00:00:00.000
*
* @param exp The string expression of the date. (NotNull, NotEmpty)
* @param pattern The pattern to parse as date. (NotNull, NotEmpty)
* @param locale The locale to parse the date expression. (NotNull)
* @throws ParseDateExpressionFailureException When it fails to parse the expression.
*/
public HandyDate(String exp, String pattern, Locale locale) {
assertConstructorArgNotNullAndNotEmpty("exp", exp);
assertConstructorArgNotNullAndNotEmpty("pattern", pattern);
assertConstructorArgNotNull("locale", locale);
_cal = createCalendar(null, locale); // means default zone
prepareDefaultBeginAttribute();
try {
_cal.setTime(DfTypeUtil.toDate(exp, pattern, locale));
} catch (ParseDateException e) {
throwParseDateExpressionFailureException(exp, e);
}
}
/**
* Construct the handy date by the string expression for the specified time-zone.
*
* e.g.
* TimeZone timeZone = ...
* Locale locale = ...
* new HandyDate("20010101", "yyyyMMdd", timeZone, locale): 2001-01-01 00:00:00.000
*
* @param exp The string expression of the date. (NotNull, NotEmpty)
* @param timeZone The time-zone to parse as date and for internal calendar. (NotNull)
* @param pattern The pattern to parse as date. (NotNull, NotEmpty)
* @param locale The locale to parse the date expression. (NotNull)
* @throws ParseDateExpressionFailureException When it fails to parse the expression.
*/
public HandyDate(String exp, TimeZone timeZone, String pattern, Locale locale) {
assertConstructorArgNotNullAndNotEmpty("exp", exp);
assertConstructorArgNotNull("timeZone", timeZone);
assertConstructorArgNotNullAndNotEmpty("pattern", pattern);
assertConstructorArgNotNull("locale", locale);
_cal = createCalendar(timeZone, locale);
prepareDefaultBeginAttribute();
try {
_cal.setTime(DfTypeUtil.toDate(exp, timeZone, pattern, locale));
} catch (ParseDateException e) {
throwParseDateExpressionFailureException(exp, e);
}
}
protected void assertConstructorArgNotNull(String name, Object value) {
if (value == null) {
String msg = "The constructor argument '" + name + "' should not be null.";
throw new IllegalArgumentException(msg);
}
}
protected void assertConstructorArgNotNullAndNotEmpty(String name, Object value) {
if (value == null) {
String msg = "The constructor argument '" + name + "' should not be null.";
throw new IllegalArgumentException(msg);
}
if (value instanceof String && ((String) value).isEmpty()) {
String msg = "The constructor argument '" + name + "' should not be empty.";
throw new IllegalArgumentException(msg);
}
}
protected Calendar createCalendar(TimeZone timeZone, Locale locale) {
// locale has no setting point so null
// basically only for week data and basically no use in HandyDate
// so unneeded but just in case
final TimeZone realZone = chooseRealZone(timeZone);
final Locale realLocale = chooseRealLocale(locale);
return Calendar.getInstance(realZone, realLocale);
}
protected Locale chooseRealLocale(Locale locale) { // also called by toDisp()
return locale != null ? locale : DBFluteSystem.getFinalLocale();
}
protected TimeZone chooseRealZone(TimeZone timeZone) {
return timeZone != null ? timeZone : DBFluteSystem.getFinalTimeZone();
}
protected void prepareDefaultBeginAttribute() {
_yearBeginMonth = _cal.getActualMinimum(Calendar.MONTH) + 1; // as default (zero origin headache)
_monthBeginDay = _cal.getActualMinimum(Calendar.DAY_OF_MONTH); // as default
_dayBeginHour = _cal.getActualMinimum(Calendar.HOUR_OF_DAY); // as default
_weekBeginDay = Calendar.SUNDAY; // as default
}
protected void throwParseDateExpressionFailureException(String exp, ParseDateException e) {
final ExceptionMessageBuilder br = new ExceptionMessageBuilder();
br.addNotice("Failed to parse the expression as date.");
br.addItem("Expression");
br.addElement(exp);
final String msg = br.buildExceptionMessage();
throw new ParseDateExpressionFailureException(msg, e);
}
/**
* Set the time-zone to internal calendar.
*
* e.g.
* new HandyDate(date).timeZone(timeZone);
*
* @param timeZone The time-zone used in internal calendar. (NotNull)
* @return this. (NotNull)
*/
public HandyDate timeZone(TimeZone timeZone) {
assertArgumentNotNull("timeZone", timeZone);
_cal.setTimeZone(timeZone);
return this;
}
// ===================================================================================
// Add Date
// ========
/**
* Add years. e.g. addYear(1): 2001/01/01 to 2002/01/01
* @param years The added count of year. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addYear(int years) {
DfTypeUtil.addCalendarYear(_cal, years);
return this;
}
/**
* Add months. e.g. addMonth(1): 2001/01/01 to 2001/02/01
* @param months The added count of month. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addMonth(int months) {
DfTypeUtil.addCalendarMonth(_cal, months);
return this;
}
/**
* Add days. e.g. addDay(1): 2001/01/01 to 2001/01/02
* @param days The added count of day. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addDay(int days) {
DfTypeUtil.addCalendarDay(_cal, days);
return this;
}
/**
* Add hours. e.g. addHour(1): 2001/01/01 00:00:00 to 2001/01/02 01:00:00
* @param hours The added count of hour. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addHour(int hours) {
DfTypeUtil.addCalendarHour(_cal, hours);
return this;
}
/**
* Add minutes. e.g. addMinute(1): 2001/01/01 00:00:00 to 2001/01/02 00:01:00
* @param minutes The added count of minute. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addMinute(int minutes) {
DfTypeUtil.addCalendarMinute(_cal, minutes);
return this;
}
/**
* Add seconds. e.g. addSecond(1): 2001/01/01 00:00:00 to 2001/01/02 00:00:01
* @param seconds The added count of second. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addSecond(int seconds) {
DfTypeUtil.addCalendarSecond(_cal, seconds);
return this;
}
/**
* Add milliseconds. e.g. addMillisecond(1): 2001/01/01 00:00:00.000 to 2001/01/02 00:00:00.001
* @param milliseconds The added count of millisecond. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addMillisecond(int milliseconds) {
DfTypeUtil.addCalendarMillisecond(_cal, milliseconds);
return this;
}
/**
* Add weeks. e.g. addWeek(1): 2001/01/01 to 2001/01/08
* @param weeks The added count of week. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate addWeek(int weeks) {
DfTypeUtil.addCalendarWeek(_cal, weeks);
return this;
}
// ===================================================================================
// Move-to Date
// ============
// -----------------------------------------------------
// Move-to Year
// ------------
/**
* Move to the specified year.
*
* e.g.
* moveToYear(2007): 2001/01/01 to 2007/01/01
* moveToYear(-2007): 2001/01/01 to BC2007/01/01
*
* @param year The move-to year. (NotZero, MinusAllowed: if minus, means before Christ)
* @return this. (NotNull)
*/
public HandyDate moveToYear(int year) {
DfTypeUtil.moveToCalendarYear(_cal, year);
return this;
}
/**
* Move to the year just (beginning).
* e.g. moveToYearJust(): 2011/11/27 12:34:56.789 to 2011/01/01 00:00:00.000
* @return this. (NotNull)
*/
public HandyDate moveToYearJust() {
DfTypeUtil.moveToCalendarYearJust(_cal, _yearBeginMonth);
moveToMonthJust(); // just for others
return this;
}
/**
* Move to the year just (beginning) after the year added.
* e.g. moveToYearJustAdded(1): 2011/11/27 12:34:56.789 to 2012/01/01 00:00:00.000
* @param years The count added of year. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToYearJustAdded(int years) {
DfTypeUtil.moveToCalendarYearJustAdded(_cal, years);
return this;
}
/**
* Move to the year just (beginning) after the year moved-to.
* e.g. moveToYearJustFor(2007): 2011/11/27 12:34:56.789 to 2007/01/01 00:00:00.000
* @param year The move-to year. (NotZero, MinusAllowed: if minus, means before Christ)
* @return this. (NotNull)
*/
public HandyDate moveToYearJustFor(int year) {
DfTypeUtil.moveToCalendarYearJustFor(_cal, year);
return this;
}
/**
* Move to the terminal of the year.
* e.g. moveToYearTerminal(): 2011/11/27 12:34:56.789 to 2011/12/31 23:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToYearTerminal() {
DfTypeUtil.moveToCalendarYearTerminal(_cal, _yearBeginMonth);
moveToMonthTerminal(); // just for others
return this;
}
/**
* Move to the terminal of the year after the year added.
* e.g. moveToYearTerminalAdded(1): 2011/11/27 12:34:56.789 to 2012/12/31 23:59:59.999
* @param years The count added of year. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToYearTerminalAdded(int years) {
DfTypeUtil.moveToCalendarYearTerminalAdded(_cal, years);
return this;
}
/**
* Move to the terminal of the year after the year moved-to.
* e.g. moveToYearTerminalFor(2007): 2011/11/27 12:34:56.789 to 2007/12/31 23:59:59.999
* @param year The move-to year. (NotZero, MinusAllowed: if minus, means before Christ)
* @return this. (NotNull)
*/
public HandyDate moveToYearTerminalFor(int year) {
DfTypeUtil.moveToCalendarYearTerminalFor(_cal, year);
return this;
}
// -----------------------------------------------------
// Move-to Month
// -------------
/**
* Move to the specified month.
* e.g. moveToMonth(9): 2011/11/27 to 2011/09/27
* @param month The move-to month. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToMonth(int month) {
assertValidMonth(month);
DfTypeUtil.moveToCalendarMonth(_cal, month);
return this;
}
/**
* Move to the month just (beginning).
* e.g. moveToMonthJust(): 2011/11/27 12:34:56.789 to 2011/11/01 00:00:00.000
* @return this. (NotNull)
*/
public HandyDate moveToMonthJust() {
DfTypeUtil.moveToCalendarMonthJust(_cal, _monthBeginDay);
moveToDayJust(); // just for others
return this;
}
/**
* Move to the month just (beginning) after the month added.
* e.g. moveToMonthJustAdded(1): 2011/11/27 12:34:56.789 to 2011/12/01 00:00:00.000
* @param months The count added of month. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToMonthJustAdded(int months) {
DfTypeUtil.moveToCalendarMonthJustAdded(_cal, months);
return this;
}
/**
* Move to the month just (beginning) after the month moved-to.
* e.g. moveToMonthJustFor(9): 2011/11/27 12:34:56.789 to 2011/09/01 00:00:00.000
* @param month The move-to month. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToMonthJustFor(int month) {
assertValidMonth(month);
DfTypeUtil.moveToCalendarMonthJustFor(_cal, month);
return this;
}
/**
* Move to the terminal of the month.
* e.g. moveToMonthTerminal(): 2011/11/27 12:34:56.789 to 2011/11/30 23:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToMonthTerminal() {
DfTypeUtil.moveToCalendarMonthTerminal(_cal, _monthBeginDay);
moveToDayTerminal(); // just for others
return this;
}
/**
* Move to the terminal of the month after the month added.
* e.g. moveToMonthTerminalAdded(1): 2011/11/27 12:34:56.789 to 2011/12/31 23:59:59.999
* @param months The count added of month. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToMonthTerminalAdded(int months) {
DfTypeUtil.moveToCalendarMonthTerminalAdded(_cal, months);
return this;
}
/**
* Move to the terminal of the month after the month moved-to.
* e.g. moveToMonthTerminalFor(9): 2011/11/27 12:34:56.789 to 2011/09/30 23:59:59.999
* @param month The move-to month. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToMonthTerminalFor(int month) {
assertValidMonth(month);
DfTypeUtil.moveToCalendarMonthTerminalFor(_cal, month);
return this;
}
/**
* Move to the first weekday just of the month.
* e.g. moveToMonthFirstWeekdayJust(): 2013/06/10 12:34:56.789 to 2013/06/03 00:00:00:000
* @return this. (NotNull)
*/
public HandyDate moveToMonthFirstWeekdayJust() {
moveToMonthJust();
if (isWeek_DayOfWeek1st_Sunday()) {
addDay(1);
} else if (isWeek_DayOfWeek7th_Saturday()) {
addDay(2);
}
return this;
}
/**
* Move to the terminal of the month last weekday.
* e.g. moveToMonthWeekdayTerminal(): 2013/03/10 12:34:56.789 to 2013/03/29 23:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToMonthLastWeekdayTerminal() {
moveToMonthTerminal();
if (isWeek_DayOfWeek1st_Sunday()) {
addDay(-2);
} else if (isWeek_DayOfWeek7th_Saturday()) {
addDay(-1);
}
return this;
}
/**
* Move to the first weekend just of the month.
* e.g. moveToMonthFirstWeekendJust(): 2013/03/10 12:34:56.789 to 2013/03/02 00:00:00:000
* @return this. (NotNull)
*/
public HandyDate moveToMonthFirstWeekendJust() {
moveToMonthJust();
while (true) {
if (isWeek_DayOfWeekWeekend()) {
break;
}
addDay(1);
}
return this;
}
/**
* Move to the terminal of the month last weekend.
* e.g. moveToMonthWeekdayTerminal(): 2013/04/10 12:34:56.789 to 2013/04/28 23:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToMonthLastWeekendTerminal() {
moveToMonthTerminal();
while (true) {
if (isWeek_DayOfWeekWeekend()) {
break;
}
addDay(-1);
}
return this;
}
// -----------------------------------------------------
// Move-to Day
// -----------
/**
* Move to the specified day.
* e.g. moveToDay(23): 2001/01/16 to 2007/01/23
* @param day The move-to day. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToDay(int day) {
assertValidDay(day);
DfTypeUtil.moveToCalendarDay(_cal, day);
return this;
}
/**
* Move to the day just (beginning).
* e.g. moveToDayJust(): 2011/11/27 12:34:56.789 to 2011/11/27 00:00:00.000
* @return this. (NotNull)
*/
public HandyDate moveToDayJust() {
DfTypeUtil.moveToCalendarDayJust(_cal, _dayBeginHour);
return this;
}
/**
* Move to the day just (beginning) after the day added.
* e.g. moveToDayJustAdded(1): 2011/11/27 12:34:56.789 to 2011/11/28 00:00:00.000
* @param days The count added of day. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToDayJustAdded(int days) {
DfTypeUtil.moveToCalendarDayJustAdded(_cal, days);
return this;
}
/**
* Move to the day just after the day moved-to.
* e.g. moveToDayJustFor(14): 2011/11/27 12:34:56.789 to 2011/11/14 00:00:00.000
* @param day The move-to day. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToDayJustFor(int day) {
assertValidDay(day);
DfTypeUtil.moveToCalendarDayJustFor(_cal, day);
return this;
}
/**
* Move to the terminal of the day.
* e.g. moveToDayTerminal(): 2011/11/27 12:34:56.789 to 2011/11/27 23:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToDayTerminal() {
DfTypeUtil.moveToCalendarDayTerminal(_cal, _dayBeginHour);
return this;
}
/**
* Move to the terminal of the day after the day added.
* e.g. moveToDayJustAdded(1): 2011/11/27 12:34:56.789 to 2011/11/28 23:59:59.999
* @param days The count added of day. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToDayTerminalAdded(int days) {
DfTypeUtil.moveToCalendarDayTerminalAdded(_cal, days);
return this;
}
/**
* Move to the day just after the day moved-to.
* e.g. moveToDayTerminalFor(14): 2011/11/27 12:34:56.789 to 2011/11/14 23:59:59.999
* @param day The move-to day. (NotZero, NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToDayTerminalFor(int day) {
assertValidDay(day);
DfTypeUtil.moveToCalendarDayTerminalFor(_cal, day);
return this;
}
// -----------------------------------------------------
// Move-to Hour
// ------------
/**
* Move to the specified hour.
*
* e.g. 2011/11/27 17:00:00
* moveToHour(23): 2007/11/27 23:00:00
* moveToHour(26): 2007/11/28 02:00:00
*
* @param hour The move-to hour. (MinusAllowed)
* @return this. (NotNull)
*/
public HandyDate moveToHour(int hour) {
assertValidHour(hour);
DfTypeUtil.moveToCalendarHour(_cal, hour);
return this;
}
/**
* Move to the hour just (beginning).
* e.g. moveToHourJust(): 2011/11/27 12:34:56.789 to 2011/11/27 12:00:00.000
* @return this. (NotNull)
*/
public HandyDate moveToHourJust() {
DfTypeUtil.moveToCalendarHourJust(_cal);
return this;
}
/**
* Move to the hour just (beginning) after the hour added.
* e.g. moveToHourJustAdded(1): 2011/11/27 12:34:56.789 to 2011/11/27 13:00:00.000
* @param hours The count added of hour. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToHourJustAdded(int hours) {
DfTypeUtil.moveToCalendarHourJustAdded(_cal, hours);
return this;
}
/**
* Move to the hour just (beginning) after the hour moved-to.
* e.g. moveToHourJustFor(4): 2011/11/27 12:34:56.789 to 2011/11/27 04:00:00.000
* @param hour The move-to hour. (NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToHourJustFor(int hour) {
assertValidHour(hour);
DfTypeUtil.moveToCalendarHourJustFor(_cal, hour);
return this;
}
/**
* Move to the terminal of the hour.
* e.g. moveToHourTerminal(): 2011/11/27 12:34:56.789 to 2011/11/27 12:59:59.999
* @return this. (NotNull)
*/
public HandyDate moveToHourTerminal() {
DfTypeUtil.moveToCalendarHourTerminal(_cal);
return this;
}
/**
* Move to the terminal of the hour after the hour added.
* e.g. moveToHourTerminalAdded(1): 2011/11/27 12:34:56.789 to 2011/11/27 13:59:59.999
* @param hours The count added of hour. (MinusAllowed: if minus, move back)
* @return this. (NotNull)
*/
public HandyDate moveToHourTerminalAdded(int hours) {
DfTypeUtil.moveToCalendarHourTerminalAdded(_cal, hours);
return this;
}
/**
* Move to the terminal of the hour after the hour moved-to.
* e.g. moveToHourTerminalFor(4): 2011/11/27 12:34:56.789 to 2011/11/27 04:59:59.999
* @param hour The move-to hour. (NotMinus)
* @return this. (NotNull)
*/
public HandyDate moveToHourTerminalFor(int hour) {
assertValidHour(hour);
DfTypeUtil.moveToCalendarHourTerminalFor(_cal, hour);
return this;
}
/**
* Move to the hour just noon.
* e.g. moveToHourJustNoon(): 2011/11/27 22:34:56.789 to 2011/11/27 12:00:00.000
* @return this. (NotNull)
*/
public HandyDate moveToHourJustNoon() {
DfTypeUtil.moveToCalendarHourJustNoon(_cal);
return this;
}
// -----------------------------------------------------
// Move-to Minute
// --------------
/**
* Move to the specified minute.
*
* e.g. 2011/11/27 00:32:00
* moveToMinute(12): to 2007/11/27 00:12:00
* moveToMinute(48): to 2007/11/27 00:48:00
*
* @param minute The move-to minute. (MinusAllowed)
* @return this. (NotNull)
*/
public HandyDate moveToMinute(int minute) {
assertValidMinute(minute);
DfTypeUtil.moveToCalendarMinute(_cal, minute);
return this;
}
/**
* Move to the minute just (beginning).
* e.g. moveToMinuteJust(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:00.000
* @return this. (NotNull)
*/
public HandyDate moveToMinuteJust() {
DfTypeUtil.moveToCalendarMinuteJust(_cal);
return this;
}
public HandyDate moveToMinuteJustAdded(int minutes) {
DfTypeUtil.moveToCalendarMinuteJustAdded(_cal, minutes);
return this;
}
public HandyDate moveToMinuteJustFor(int minute) {
assertValidMinute(minute);
DfTypeUtil.moveToCalendarMinuteJustFor(_cal, minute);
return this;
}
/**
* Move to the terminal of the minute.
* e.g. moveToMinuteTerminal(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:59.999
* @return this. (NotNull)
*/
public HandyDate moveToMinuteTerminal() {
DfTypeUtil.moveToCalendarMinuteTerminal(_cal);
return this;
}
public HandyDate moveToMinuteTerminalÅdded(int minutes) {
DfTypeUtil.moveToCalendarMinuteTerminalAdded(_cal, minutes);
return this;
}
public HandyDate moveToMinuteTerminalFor(int minute) {
assertValidMinute(minute);
DfTypeUtil.moveToCalendarMinuteTerminalFor(_cal, minute);
return this;
}
// -----------------------------------------------------
// Move-to Second
// --------------
/**
* Move to the specified second.
*
* e.g. 2011/11/27 00:32:00
* moveToSecond(12): to 2007/11/27 00:00:12
* moveToSecond(48): to 2007/11/27 00:00:48
*
* @param second The move-to second. (MinusAllowed)
* @return this. (NotNull)
*/
public HandyDate moveToSecond(int second) {
assertValidSecond(second);
DfTypeUtil.moveToCalendarSecond(_cal, second);
return this;
}
/**
* Move to the second just (beginning).
* e.g. moveToSecondJust(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:56.000
* @return this. (NotNull)
*/
public HandyDate moveToSecondJust() {
DfTypeUtil.moveToCalendarSecondJust(_cal);
return this;
}
public HandyDate moveToSecondJustFor(int second) {
assertValidSecond(second);
DfTypeUtil.moveToCalendarSecondJustFor(_cal, second);
return this;
}
public HandyDate moveToSecondJustAdded(int seconds) {
DfTypeUtil.moveToCalendarSecondJustAdded(_cal, seconds);
return this;
}
/**
* Move to the terminal of the second.
* e.g. moveToSecondTerminal(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:56.999
* @return this. (NotNull)
*/
public HandyDate moveToSecondTerminal() {
DfTypeUtil.moveToCalendarSecondTerminal(_cal);
return this;
}
public HandyDate moveToSecondTerminalAdded(int seconds) {
DfTypeUtil.moveToCalendarSecondTerminalAdded(_cal, seconds);
return this;
}
public HandyDate moveToSecondTerminalFor(int second) {
assertValidSecond(second);
DfTypeUtil.moveToCalendarSecondTerminalFor(_cal, second);
return this;
}
// -----------------------------------------------------
// Move-to Millisecond
// -------------------
/**
* Move to the specified millisecond.
*
* e.g. 2011/11/27 00:00:00.456
* moveToMillisecond(123): to 2007/11/27 00:00:00.123
* moveToMillisecond(877): to 2007/11/27 00:00:00.877
*
* @param millisecond The move-to millisecond. (MinusAllowed)
* @return this. (NotNull)
*/
public HandyDate moveToMillisecond(int millisecond) {
assertValidMillisecond(millisecond);
DfTypeUtil.moveToCalendarMillisecond(_cal, millisecond);
return this;
}
// -----------------------------------------------------
// Move-to Week
// ------------
/**
* Move to the week just (beginning).
* You can change the beginning of day of week by beginWeek_...().
* Default day of week is Sunday.
*
* e.g. 2011/11/30 12:34:56.789 (Wednesday)
* moveToWeekJust(): to 2011/11/27 00:00:00.000
* beginWeek_DayOfWeek1st_Sunday().moveToWeekJust(): to 2011/11/27 00:00:00.000
* beginWeek_DayOfWeek2nd_Monday().moveToWeekJust(): to 2011/11/28 00:00:00.000
* beginWeek_DayOfWeek3rd_Tuesday().moveToWeekJust(): to 2011/11/29 00:00:00.000
* beginWeek_DayOfWeek4th_Wednesday().moveToWeekJust(): to 2011/11/30 00:00:00.000
* beginWeek_DayOfWeek5th_Thursday().moveToWeekJust(): to 2011/11/24 00:00:00.000
*
* @return this. (NotNull)
*/
public HandyDate moveToWeekJust() {
DfTypeUtil.moveToCalendarWeekJust(_cal, _weekBeginDay);
return this;
}
/**
* Move to the terminal of the week.
* You can change the beginning of day of week by beginWeek_...().
* Default day of week is Sunday.
*
* e.g. 2011/11/30 12:34:56.789 (Wednesday)
* moveToWeekJust(): to 2011/12/03 23:59:59.999
* beginWeek_DayOfWeek1st_Sunday().moveToWeekJust(): to 2011/12/03 23:59:59.999
* beginWeek_DayOfWeek2nd_Monday().moveToWeekJust(): to 2011/12/04 23:59:59.999
* beginWeek_DayOfWeek3rd_Tuesday().moveToWeekJust(): to 2011/12/05 23:59:59.999
* beginWeek_DayOfWeek4th_Wednesday().moveToWeekJust(): to 2011/12/06 23:59:59.999
* beginWeek_DayOfWeek5th_Thursday().moveToWeekJust(): to 2011/11/30 23:59:59.999
*
* @return this. (NotNull)
*/
public HandyDate moveToWeekTerminal() {
DfTypeUtil.moveToCalendarWeekTerminal(_cal, _weekBeginDay);
return this;
}
public HandyDate moveToWeekOfMonth(int weekOfMonth) {
DfTypeUtil.moveToCalendarWeekOfMonth(_cal, weekOfMonth);
return this;
}
public HandyDate moveToWeekOfYear(int weekOfYear) {
DfTypeUtil.moveToCalendarWeekOfYear(_cal, weekOfYear);
return this;
}
// -----------------------------------------------------
// Move-to Quarter of Year
// -----------------------
/**
* Move to the quarter of year just (beginning).
* You can change the beginning of year by beginYear_Month...().
* Default quarter of year is 1-3, 4-6, 7-9, 10-12.
*
* e.g.
* moveToQuarterOfYearJust(): 2011/02/27 12:34:56.789 to 2011/01/01 00:00:00.000
* moveToQuarterOfYearJust(): 2011/03/27 12:34:56.789 to 2011/01/01 00:00:00.000
* moveToQuarterOfYearJust(): 2011/04/27 12:34:56.789 to 2011/04/01 00:00:00.000
* moveToQuarterOfYearJust(): 2011/08/27 12:34:56.789 to 2011/07/01 00:00:00.000
* moveToQuarterOfYearJust(): 2011/11/27 12:34:56.789 to 2011/10/01 00:00:00.000
*
* @return this. (NotNull)
*/
public HandyDate moveToQuarterOfYearJust() {
DfTypeUtil.moveToCalendarQuarterOfYearJust(_cal, _yearBeginMonth);
moveToMonthJust(); // just for others
return this;
}
public HandyDate moveToQuarterOfYearJustAdded(int quarterOfYear) {
DfTypeUtil.moveToCalendarQuarterOfYearJustAdded(_cal, quarterOfYear, _yearBeginMonth);
moveToMonthJust(); // just for others
return this;
}
public HandyDate moveToQuarterOfYearJustFor(int quarterOfYear) {
DfTypeUtil.moveToCalendarQuarterOfYearJustFor(_cal, quarterOfYear, _yearBeginMonth);
moveToMonthJust(); // just for others
return this;
}
public HandyDate moveToQuarterOfYearTerminal() {
DfTypeUtil.moveToCalendarQuarterOfYearTerminal(_cal, _yearBeginMonth);
moveToMonthTerminal(); // just for others
return this;
}
public HandyDate moveToQuarterOfYearTerminalAdded(int quarterOfYear) {
DfTypeUtil.moveToCalendarQuarterOfYearTerminalAdded(_cal, quarterOfYear, _yearBeginMonth);
moveToMonthTerminal(); // just for others
return this;
}
public HandyDate moveToQuarterOfYearTerminalFor(int quarterOfYear) {
DfTypeUtil.moveToCalendarQuarterOfYearTerminalFor(_cal, quarterOfYear, _yearBeginMonth);
moveToMonthTerminal(); // just for others
return this;
}
// -----------------------------------------------------
// Move-to Next
// ------------
/**
* Move to the next business day (only added days).
* @param determiner The determiner of business day. (NotNull)
* @return this. (NotNull)
*/
public HandyDate moveToNextBusinessDay(BusinessDayDeterminer determiner) {
assertArgumentNotNull("determiner", determiner);
final int addedLimit = 1000;
int addedCount = 0;
while (true) {
addDay(1);
++addedCount;
if (determiner.isBusinessDay(this)) {
break;
}
if (addedCount > addedLimit) {
String msg = "Business day is so far: limit=" + addedLimit;
throw new IllegalStateException(msg);
}
}
return this;
}
/**
* Move to the next business day (only added days).
* @param movedDays The moved count of business days. (NotMinus)
* @param determiner The determiner of business day. (NotNull)
* @return this. (NotNull)
*/
public HandyDate moveToNextBusinessDay(int movedDays, BusinessDayDeterminer determiner) {
assertArgumentNotNull("determiner", determiner);
if (movedDays < 0) {
String msg = "The argument 'movedDays' should not be minus: " + movedDays;
throw new IllegalArgumentException(msg);
}
for (int i = 0; i < movedDays; i++) {
moveToNextBusinessDay(determiner);
}
return this;
}
// ===================================================================================
// Clear Date
// ==========
/**
* Clear the time parts, hours, minutes, seconds, milliseconds.
* e.g. clearTimeParts(): 2011/11/27 12:34:56.789 to 2011/11/27 00:00:00.000
* @return this. (NotNull)
*/
public HandyDate clearTimeParts() {
DfTypeUtil.clearCalendarTimeParts(_cal);
return this;
}
/**
* Clear the minute with rear parts, minutes, seconds, milliseconds.
* e.g. clearMinuteWithRear(): 2011/11/27 12:34:56.789 to 2011/11/27 12:00:00.000
* @return this. (NotNull)
*/
public HandyDate clearMinuteWithRear() {
DfTypeUtil.clearCalendarMinuteWithRear(_cal);
return this;
}
/**
* Clear the second with rear parts, seconds, milliseconds.
* e.g. clearSecondWithRear(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:00.000
* @return this. (NotNull)
*/
public HandyDate clearSecondWithRear() {
DfTypeUtil.clearCalendarSecondWithRear(_cal);
return this;
}
/**
* Clear the millisecond.
* e.g. clearMillisecond(): 2011/11/27 12:34:56.789 to 2011/11/27 12:34:56.000
* @return this. (NotNull)
*/
public HandyDate clearMillisecond() {
DfTypeUtil.clearCalendarMillisecond(_cal);
return this;
}
// ===================================================================================
// Compare Date
// ============
// -----------------------------------------------------
// Match Date
// ----------
/**
* Is this date match the specified date?
*
* e.g. date: 2011/11/27
* date.isMatch(2011/11/24): true
* date.isMatch(2011/11/27): false
* date.isMatch(2011/11/28): false
*
* @param date The comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isMatch(Date date) {
assertArgumentNotNull("date", date);
return _cal.getTimeInMillis() == date.getTime();
}
// -----------------------------------------------------
// Greater Than
// ------------
/**
* Is this date greater than the specified local date?
*
* e.g. date: 2011/11/27
* date.isGreaterThan(2011/11/24): true
* date.isGreaterThan(2011/11/27): false
* date.isGreaterThan(2011/11/28): false
*
* @param date The comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThan(LocalDate date) {
assertArgumentNotNull("date", date);
return isGreaterThanAll(date);
}
/**
* Is this date greater than the specified local date-time?
*
* e.g. date: 2011/11/27
* date.isGreaterThan(2011/11/24): true
* date.isGreaterThan(2011/11/27): false
* date.isGreaterThan(2011/11/28): false
*
* @param date The comparison target date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThan(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isGreaterThanAll(date);
}
/**
* Is this date greater than the specified date?
*
* e.g. date: 2011/11/27
* date.isGreaterThan(2011/11/24): true
* date.isGreaterThan(2011/11/27): false
* date.isGreaterThan(2011/11/28): false
*
* @param date The comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThan(Date date) {
assertArgumentNotNull("date", date);
return isGreaterThanAll(date);
}
/**
* Is this date greater than all the specified local dates?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAll(2011/11/24, 2011/11/26): true
* date.isGreaterThanAll(2011/11/24, 2011/11/27): false
* date.isGreaterThanAll(2011/11/24, 2011/11/28): false
* date.isGreaterThanAll(2011/11/27, 2011/11/29): false
* date.isGreaterThanAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAll(LocalDate... dates) {
return doCompareAll(createGreaterThanLocalDateCompareCallback(), dates);
}
/**
* Is this date greater than all the specified local date-times?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAll(2011/11/24, 2011/11/26): true
* date.isGreaterThanAll(2011/11/24, 2011/11/27): false
* date.isGreaterThanAll(2011/11/24, 2011/11/28): false
* date.isGreaterThanAll(2011/11/27, 2011/11/29): false
* date.isGreaterThanAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAll(LocalDateTime... dates) {
return doCompareAll(createGreaterThanLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date greater than all the specified dates?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAll(2011/11/24, 2011/11/26): true
* date.isGreaterThanAll(2011/11/24, 2011/11/27): false
* date.isGreaterThanAll(2011/11/24, 2011/11/28): false
* date.isGreaterThanAll(2011/11/27, 2011/11/29): false
* date.isGreaterThanAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAll(Date... dates) {
return doCompareAll(createGreaterThanDateCompareCallback(), dates);
}
/**
* Is this date greater than any specified local dates?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAny(2011/11/24, 2011/11/26): true
* date.isGreaterThanAny(2011/11/24, 2011/11/27): true
* date.isGreaterThanAny(2011/11/24, 2011/11/28): true
* date.isGreaterThanAny(2011/11/27, 2011/11/29): false
* date.isGreaterThanAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAny(LocalDate... dates) {
return doCompareAny(createGreaterThanLocalDateCompareCallback(), dates);
}
/**
* Is this date greater than any specified local date-times?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAny(2011/11/24, 2011/11/26): true
* date.isGreaterThanAny(2011/11/24, 2011/11/27): true
* date.isGreaterThanAny(2011/11/24, 2011/11/28): true
* date.isGreaterThanAny(2011/11/27, 2011/11/29): false
* date.isGreaterThanAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAny(LocalDateTime... dates) {
return doCompareAny(createGreaterThanLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date greater than any specified dates?
*
* e.g. date: 2011/11/27
* date.isGreaterThanAny(2011/11/24, 2011/11/26): true
* date.isGreaterThanAny(2011/11/24, 2011/11/27): true
* date.isGreaterThanAny(2011/11/24, 2011/11/28): true
* date.isGreaterThanAny(2011/11/27, 2011/11/29): false
* date.isGreaterThanAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterThanAny(Date... dates) {
return doCompareAny(createGreaterThanDateCompareCallback(), dates);
}
protected LocalDateCompareCallback createGreaterThanLocalDateCompareCallback() {
return new LocalDateCompareCallback() {
public boolean isTarget(LocalDate current, LocalDate date) {
return current.isAfter(date);
}
};
}
protected LocalDateTimeCompareCallback createGreaterThanLocalDateTimeCompareCallback() {
return new LocalDateTimeCompareCallback() {
public boolean isTarget(LocalDateTime current, LocalDateTime date) {
return current.isAfter(date);
}
};
}
protected DateCompareCallback createGreaterThanDateCompareCallback() {
return new DateCompareCallback() {
public boolean isTarget(Date current, Date date) {
return current.after(date);
}
};
}
// -----------------------------------------------------
// Greater Equal
// -------------
/**
* Is this date greater than or equal the specified local date?
*
* e.g. date: 2011/11/27
* date.isGreaterEqual(2011/11/24): true
* date.isGreaterEqual(2011/11/27): true
* date.isGreaterEqual(2011/11/28): false
*
* @param date The comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqual(LocalDate date) {
assertArgumentNotNull("date", date);
return isGreaterEqualAll(date);
}
/**
* Is this date greater than or equal the specified local date-times?
*
* e.g. date: 2011/11/27
* date.isGreaterEqual(2011/11/24): true
* date.isGreaterEqual(2011/11/27): true
* date.isGreaterEqual(2011/11/28): false
*
* @param date The comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqual(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isGreaterEqualAll(date);
}
/**
* Is this date greater than or equal the specified date?
*
* e.g. date: 2011/11/27
* date.isGreaterEqual(2011/11/24): true
* date.isGreaterEqual(2011/11/27): true
* date.isGreaterEqual(2011/11/28): false
*
* @param date The comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqual(Date date) {
assertArgumentNotNull("date", date);
return isGreaterEqualAll(date);
}
/**
* Is this date greater than or equal all the specified local dates?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAll(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/28): false
* date.isGreaterEqualAll(2011/11/27, 2011/11/29): false
* date.isGreaterEqualAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAll(LocalDate... dates) {
return doCompareAll(createGreaterEqualLocalDateCompareCallback(), dates);
}
/**
* Is this date greater than or equal all the specified local date-times?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAll(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/28): false
* date.isGreaterEqualAll(2011/11/27, 2011/11/29): false
* date.isGreaterEqualAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAll(LocalDateTime... dates) {
return doCompareAll(createGreaterEqualLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date greater than or equal all the specified dates?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAll(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAll(2011/11/24, 2011/11/28): false
* date.isGreaterEqualAll(2011/11/27, 2011/11/29): false
* date.isGreaterEqualAll(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAll(Date... dates) {
return doCompareAll(createGreaterEqualDateCompareCallback(), dates);
}
/**
* Is this date greater than or equal any specified local dates?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAny(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/28): true
* date.isGreaterEqualAny(2011/11/27, 2011/11/29): true
* date.isGreaterEqualAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAny(LocalDate... dates) {
return doCompareAny(createGreaterEqualLocalDateCompareCallback(), dates);
}
/**
* Is this date greater than or equal any specified local date-times?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAny(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/28): true
* date.isGreaterEqualAny(2011/11/27, 2011/11/29): true
* date.isGreaterEqualAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAny(LocalDateTime... dates) {
return doCompareAny(createGreaterEqualLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date greater than or equal any specified dates?
*
* e.g. date: 2011/11/27
* date.isGreaterEqualAny(2011/11/24, 2011/11/26): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/27): true
* date.isGreaterEqualAny(2011/11/24, 2011/11/28): true
* date.isGreaterEqualAny(2011/11/27, 2011/11/29): true
* date.isGreaterEqualAny(2011/11/28, 2011/11/29): false
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isGreaterEqualAny(Date... dates) {
return doCompareAny(createGreaterEqualDateCompareCallback(), dates);
}
protected LocalDateCompareCallback createGreaterEqualLocalDateCompareCallback() {
return new LocalDateCompareCallback() {
public boolean isTarget(LocalDate current, LocalDate date) {
return current.isAfter(date) || current.equals(date);
}
};
}
protected LocalDateTimeCompareCallback createGreaterEqualLocalDateTimeCompareCallback() {
return new LocalDateTimeCompareCallback() {
public boolean isTarget(LocalDateTime current, LocalDateTime date) {
return current.isAfter(date) || current.equals(date);
}
};
}
protected DateCompareCallback createGreaterEqualDateCompareCallback() {
return new DateCompareCallback() {
public boolean isTarget(Date current, Date date) {
return current.after(date) || current.equals(date);
}
};
}
// -----------------------------------------------------
// Less Than
// ---------
/**
* Is this date less than the specified local date?
*
* e.g. date: 2011/11/27
* date.isLessThan(2011/11/24): false
* date.isLessThan(2011/11/27): false
* date.isLessThan(2011/11/28): true
*
* @param date The comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThan(LocalDate date) {
assertArgumentNotNull("date", date);
return isLessThanAll(date);
}
/**
* Is this date less than the specified local date-time?
*
* e.g. date: 2011/11/27
* date.isLessThan(2011/11/24): false
* date.isLessThan(2011/11/27): false
* date.isLessThan(2011/11/28): true
*
* @param date The comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThan(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isLessThanAll(date);
}
/**
* Is this date less than the specified date?
*
* e.g. date: 2011/11/27
* date.isLessThan(2011/11/24): false
* date.isLessThan(2011/11/27): false
* date.isLessThan(2011/11/28): true
*
* @param date The comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThan(Date date) {
assertArgumentNotNull("date", date);
return isLessThanAll(date);
}
/**
* Is this date less than all the specified local dates?
*
* e.g. date: 2011/11/27
* date.isLessThanAll(2011/11/24, 2011/11/26): false
* date.isLessThanAll(2011/11/24, 2011/11/27): false
* date.isLessThanAll(2011/11/24, 2011/11/28): false
* date.isLessThanAll(2011/11/27, 2011/11/29): false
* date.isLessThanAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAll(LocalDate... dates) {
return doCompareAll(createLessThanLocalDateCompareCallback(), dates);
}
/**
* Is this date less than all the specified local date-times?
*
* e.g. date: 2011/11/27
* date.isLessThanAll(2011/11/24, 2011/11/26): false
* date.isLessThanAll(2011/11/24, 2011/11/27): false
* date.isLessThanAll(2011/11/24, 2011/11/28): false
* date.isLessThanAll(2011/11/27, 2011/11/29): false
* date.isLessThanAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAll(LocalDateTime... dates) {
return doCompareAll(createLessThanLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date less than all the specified dates?
*
* e.g. date: 2011/11/27
* date.isLessThanAll(2011/11/24, 2011/11/26): false
* date.isLessThanAll(2011/11/24, 2011/11/27): false
* date.isLessThanAll(2011/11/24, 2011/11/28): false
* date.isLessThanAll(2011/11/27, 2011/11/29): false
* date.isLessThanAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAll(Date... dates) {
return doCompareAll(createLessThanDateCompareCallback(), dates);
}
/**
* Is this date less than any specified local dates?
*
* e.g. date: 2011/11/27
* date.isLessThanAny(2011/11/24, 2011/11/26): false
* date.isLessThanAny(2011/11/24, 2011/11/27): false
* date.isLessThanAny(2011/11/24, 2011/11/28): true
* date.isLessThanAny(2011/11/27, 2011/11/29): true
* date.isLessThanAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAny(LocalDate... dates) {
return doCompareAny(createLessThanLocalDateCompareCallback(), dates);
}
/**
* Is this date less than any specified local date-times?
*
* e.g. date: 2011/11/27
* date.isLessThanAny(2011/11/24, 2011/11/26): false
* date.isLessThanAny(2011/11/24, 2011/11/27): false
* date.isLessThanAny(2011/11/24, 2011/11/28): true
* date.isLessThanAny(2011/11/27, 2011/11/29): true
* date.isLessThanAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAny(LocalDateTime... dates) {
return doCompareAny(createLessThanLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date less than any specified dates?
*
* e.g. date: 2011/11/27
* date.isLessThanAny(2011/11/24, 2011/11/26): false
* date.isLessThanAny(2011/11/24, 2011/11/27): false
* date.isLessThanAny(2011/11/24, 2011/11/28): true
* date.isLessThanAny(2011/11/27, 2011/11/29): true
* date.isLessThanAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessThanAny(Date... dates) {
return doCompareAny(createLessThanDateCompareCallback(), dates);
}
protected LocalDateCompareCallback createLessThanLocalDateCompareCallback() {
return new LocalDateCompareCallback() {
public boolean isTarget(LocalDate current, LocalDate date) {
return current.isBefore(date);
}
};
}
protected LocalDateTimeCompareCallback createLessThanLocalDateTimeCompareCallback() {
return new LocalDateTimeCompareCallback() {
public boolean isTarget(LocalDateTime current, LocalDateTime date) {
return current.isBefore(date);
}
};
}
protected DateCompareCallback createLessThanDateCompareCallback() {
return new DateCompareCallback() {
public boolean isTarget(Date current, Date date) {
return current.before(date);
}
};
}
// -----------------------------------------------------
// Less Equal
// ----------
/**
* Is this date less than or equal the specified local date?
*
* e.g. date: 2011/11/27
* date.isLessEqual(2011/11/24): false
* date.isLessEqual(2011/11/27): true
* date.isLessEqual(2011/11/28): true
*
* @param date The comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqual(LocalDate date) {
assertArgumentNotNull("date", date);
return isLessEqualAll(date);
}
/**
* Is this date less than or equal the specified local date-time?
*
* e.g. date: 2011/11/27
* date.isLessEqual(2011/11/24): false
* date.isLessEqual(2011/11/27): true
* date.isLessEqual(2011/11/28): true
*
* @param date The comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqual(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isLessEqualAll(date);
}
/**
* Is this date less than or equal the specified date?
*
* e.g. date: 2011/11/27
* date.isLessEqual(2011/11/24): false
* date.isLessEqual(2011/11/27): true
* date.isLessEqual(2011/11/28): true
*
* @param date The comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqual(Date date) {
assertArgumentNotNull("date", date);
return isLessEqualAll(date);
}
/**
* Is this date less than or equal all the specified local dates?
*
* e.g. date: 2011/11/27
* date.isLessEqualAll(2011/11/24, 2011/11/26): false
* date.isLessEqualAll(2011/11/24, 2011/11/27): false
* date.isLessEqualAll(2011/11/24, 2011/11/28): false
* date.isLessEqualAll(2011/11/27, 2011/11/29): true
* date.isLessEqualAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAll(LocalDate... dates) {
return doCompareAll(createLessEqualLocalDateCompareCallback(), dates);
}
/**
* Is this date less than or equal all the specified local date-times?
*
* e.g. date: 2011/11/27
* date.isLessEqualAll(2011/11/24, 2011/11/26): false
* date.isLessEqualAll(2011/11/24, 2011/11/27): false
* date.isLessEqualAll(2011/11/24, 2011/11/28): false
* date.isLessEqualAll(2011/11/27, 2011/11/29): true
* date.isLessEqualAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAll(LocalDateTime... dates) {
return doCompareAll(createLessEqualLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date less than or equal all the specified dates?
*
* e.g. date: 2011/11/27
* date.isLessEqualAll(2011/11/24, 2011/11/26): false
* date.isLessEqualAll(2011/11/24, 2011/11/27): false
* date.isLessEqualAll(2011/11/24, 2011/11/28): false
* date.isLessEqualAll(2011/11/27, 2011/11/29): true
* date.isLessEqualAll(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAll(Date... dates) {
return doCompareAll(createLessEqualDateCompareCallback(), dates);
}
/**
* Is this date less than or equal any specified local dates?
*
* e.g. date: 2011/11/27
* date.isLessEqualAny(2011/11/24, 2011/11/26): false
* date.isLessEqualAny(2011/11/24, 2011/11/27): true
* date.isLessEqualAny(2011/11/24, 2011/11/28): true
* date.isLessEqualAny(2011/11/27, 2011/11/29): true
* date.isLessEqualAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAny(LocalDate... dates) {
return doCompareAny(createLessEqualLocalDateCompareCallback(), dates);
}
/**
* Is this date less than or equal any specified local date-times?
*
* e.g. date: 2011/11/27
* date.isLessEqualAny(2011/11/24, 2011/11/26): false
* date.isLessEqualAny(2011/11/24, 2011/11/27): true
* date.isLessEqualAny(2011/11/24, 2011/11/28): true
* date.isLessEqualAny(2011/11/27, 2011/11/29): true
* date.isLessEqualAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAny(LocalDateTime... dates) {
return doCompareAny(createLessEqualLocalDateTimeCompareCallback(), dates);
}
/**
* Is this date less than or equal any specified dates?
*
* e.g. date: 2011/11/27
* date.isLessEqualAny(2011/11/24, 2011/11/26): false
* date.isLessEqualAny(2011/11/24, 2011/11/27): true
* date.isLessEqualAny(2011/11/24, 2011/11/28): true
* date.isLessEqualAny(2011/11/27, 2011/11/29): true
* date.isLessEqualAny(2011/11/28, 2011/11/29): true
*
* @param dates The array of comparison target date. (NotNull)
* @return The determination, true or false.
*/
public boolean isLessEqualAny(Date... dates) {
return doCompareAny(createLessEqualDateCompareCallback(), dates);
}
protected LocalDateCompareCallback createLessEqualLocalDateCompareCallback() {
return new LocalDateCompareCallback() {
public boolean isTarget(LocalDate current, LocalDate date) {
return current.isBefore(date) || current.equals(date);
}
};
}
protected LocalDateTimeCompareCallback createLessEqualLocalDateTimeCompareCallback() {
return new LocalDateTimeCompareCallback() {
public boolean isTarget(LocalDateTime current, LocalDateTime date) {
return current.isBefore(date) || current.equals(date);
}
};
}
protected DateCompareCallback createLessEqualDateCompareCallback() {
return new DateCompareCallback() {
public boolean isTarget(Date current, Date date) {
return current.before(date) || current.equals(date);
}
};
}
// -----------------------------------------------------
// Compare Helper
// --------------
protected boolean doCompareAll(LocalDateCompareCallback callback, LocalDate... dates) {
assertCompareDateArrayValid(dates);
final LocalDate current = getLocalDate();
for (LocalDate date : dates) {
if (!callback.isTarget(current, date)) {
return false;
}
}
return true;
}
protected boolean doCompareAll(LocalDateTimeCompareCallback callback, LocalDateTime... dates) {
assertCompareDateArrayValid(dates);
final LocalDateTime current = getLocalDateTime();
for (LocalDateTime date : dates) {
if (!callback.isTarget(current, date)) {
return false;
}
}
return true;
}
protected boolean doCompareAll(DateCompareCallback callback, Date... dates) {
assertCompareDateArrayValid(dates);
final Date current = getDate();
for (Date date : dates) {
if (!callback.isTarget(current, date)) {
return false;
}
}
return true;
}
protected boolean doCompareAny(LocalDateCompareCallback callback, LocalDate... dates) {
assertCompareDateArrayValid(dates);
final LocalDate current = getLocalDate();
for (LocalDate date : dates) {
if (callback.isTarget(current, date)) {
return true;
}
}
return false;
}
protected boolean doCompareAny(LocalDateTimeCompareCallback callback, LocalDateTime... dates) {
assertCompareDateArrayValid(dates);
final LocalDateTime current = getLocalDateTime();
for (LocalDateTime date : dates) {
if (callback.isTarget(current, date)) {
return true;
}
}
return false;
}
protected boolean doCompareAny(DateCompareCallback callback, Date... dates) {
assertCompareDateArrayValid(dates);
final Date current = getDate();
for (Date date : dates) {
if (callback.isTarget(current, date)) {
return true;
}
}
return false;
}
protected void assertCompareDateArrayValid(LocalDate[] dates) {
if (dates == null || dates.length == 0) {
String msg = "The argument 'dates' should not be null or empty.";
throw new IllegalArgumentException(msg);
}
}
protected void assertCompareDateArrayValid(LocalDateTime[] dates) {
if (dates == null || dates.length == 0) {
String msg = "The argument 'dates' should not be null or empty.";
throw new IllegalArgumentException(msg);
}
}
protected void assertCompareDateArrayValid(Date[] dates) {
if (dates == null || dates.length == 0) {
String msg = "The argument 'dates' should not be null or empty.";
throw new IllegalArgumentException(msg);
}
}
// ===================================================================================
// Confirm Parts
// =============
// -----------------------------------------------------
// Confirm Year
// ------------
/**
* Is the year of this date same as specified year?
* e.g. if 2011/11/27, isYear(2011) is true
* @param year The integer of year.
* @return The determination, true or false.
*/
public boolean isYear(int year) {
return getYear() == year;
}
/**
* Is the year of this date same as the year of the specified local date?
* e.g. if 2011/11/27, isYearSameAs(toLocalDate("2011/01/01")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isYearSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return getYear() == prepareCompareDate(date).getYear();
}
/**
* Is the year of this date same as the year of the specified local date-time?
* e.g. if 2011/11/27, isYearSameAs(toLocalDate("2011/01/01")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isYearSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return getYear() == prepareCompareDate(date).getYear();
}
/**
* Is the year of this date same as the year of the specified date?
* e.g. if 2011/11/27, isYearSameAs(toDate("2011/01/01")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isYearSameAs(Date date) {
assertArgumentNotNull("date", date);
return getYear() == prepareCompareDate(date).getYear();
}
/**
* Is the year of this date same as the year of the specified date?
* e.g. if 2011/11/27, isYearSameAs(new HandyDate("2011/01/01")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isYearSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getYear() == handyDate.getYear();
}
/**
* Is the year of this date Anno Domini?
* e.g. 2011/11/27: true, BC982/11/27: false
* @return The determination, true or false.
*/
public boolean isYear_AnnoDomini() {
return getYear() > 0;
}
/**
* Is the year of this date Before Christ?
* e.g. 2011/11/27: false, BC982/11/27: true
* @return The determination, true or false.
*/
public boolean isYear_BeforeChrist() {
return getYear() < 0; // -1 means 'BC0001' (cannot be 0) in calendar
}
// -----------------------------------------------------
// Confirm Month
// -------------
/**
* Is the month of this date same as specified month?
* e.g. if 2011/11/27, isMonth(11) is true
* @param month The integer of month. (1 origin)
* @return The determination, true or false.
*/
public boolean isMonth(int month) {
return getMonthAsOneOrigin() == month; // zero origin headache
}
/**
* Is the month of this date same as specified month?
* e.g. if 2011/11/27, isMonth(11) is true
* @param month The enumeration of month. (NotNull, 1 origin)
* @return The determination, true or false.
*/
public boolean isMonth(Month month) {
assertArgumentNotNull("month", month);
return getMonth() == month; // zero origin headache
}
/**
* Is the month of this date same as the month of the specified local date?
* e.g. if 2011/11/27, isMonthSameAs(toLocalDate("2013/11/01")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return getMonthAsOneOrigin() == prepareCompareDate(date).getMonthAsOneOrigin();
}
/**
* Is the month of this date same as the month of the specified local date-time?
* e.g. if 2011/11/27, isMonthSameAs(toLocalDateTime("2013/11/01")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return getMonthAsOneOrigin() == prepareCompareDate(date).getMonthAsOneOrigin();
}
/**
* Is the month of this date same as the month of the specified date?
* e.g. if 2011/11/27, isMonthSameAs(toDate("2013/11/01")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthSameAs(Date date) {
assertArgumentNotNull("date", date);
return getMonthAsOneOrigin() == prepareCompareDate(date).getMonthAsOneOrigin();
}
/**
* Is the month of this date same as the month of the specified date?
* e.g. if 2011/11/27, isMonthSameAs(new HandyDate("2013/11/01")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getMonthAsOneOrigin() == handyDate.getMonthAsOneOrigin();
}
/**
* Is the year and month of this local date-time same as the specified date?
* e.g. if 2011/11/27, isMonthOfYearSameAs(toLocalDateTime("2011/11/01")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthOfYearSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return isMonthOfYearSameAs(prepareCompareDate(date));
}
/**
* Is the year and month of this local date same as the specified date?
* e.g. if 2011/11/27, isMonthOfYearSameAs(toLocalDate("2011/11/01")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthOfYearSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isMonthOfYearSameAs(prepareCompareDate(date));
}
/**
* Is the year and month of this date same as the specified date?
* e.g. if 2011/11/27, isMonthOfYearSameAs(toDate("2011/11/01")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthOfYearSameAs(Date date) {
assertArgumentNotNull("date", date);
return isMonthOfYearSameAs(prepareCompareDate(date));
}
/**
* Is the year and month of this date same as the specified date?
* e.g. if 2011/11/27, isMonthOfYearSameAs(new HandyDate("2011/11/01")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMonthOfYearSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return isYearSameAs(handyDate) && getMonthAsOneOrigin() == handyDate.getMonthAsOneOrigin();
}
/**
* Is the month January?
* @return The determination, true or false.
*/
public boolean isMonth01_January() {
return isMonth(1);
}
/**
* Is the month February?
* @return The determination, true or false.
*/
public boolean isMonth02_February() {
return isMonth(2);
}
/**
* Is the month March?
* @return The determination, true or false.
*/
public boolean isMonth03_March() {
return isMonth(3);
}
/**
* Is the month April?
* @return The determination, true or false.
*/
public boolean isMonth04_April() {
return isMonth(4);
}
/**
* Is the month May?
* @return The determination, true or false.
*/
public boolean isMonth05_May() {
return isMonth(5);
}
/**
* Is the month June?
* @return The determination, true or false.
*/
public boolean isMonth06_June() {
return isMonth(6);
}
/**
* Is the month July?
* @return The determination, true or false.
*/
public boolean isMonth07_July() {
return isMonth(7);
}
/**
* Is the month August?
* @return The determination, true or false.
*/
public boolean isMonth08_August() {
return isMonth(8);
}
/**
* Is the month September?
* @return The determination, true or false.
*/
public boolean isMonth09_September() {
return isMonth(9);
}
/**
* Is the month October?
* @return The determination, true or false.
*/
public boolean isMonth10_October() {
return isMonth(10);
}
/**
* Is the month November?
* @return The determination, true or false.
*/
public boolean isMonth11_November() {
return isMonth(11);
}
/**
* Is the month December?
* @return The determination, true or false.
*/
public boolean isMonth12_December() {
return isMonth(12);
}
// -----------------------------------------------------
// Confirm Day
// -----------
/**
* Is the day of this date same as specified day?
* e.g. if 2011/11/27, isDay(27) is true
* @param day The integer of day.
* @return The determination, true or false.
*/
public boolean isDay(int day) {
return getDay() == day;
}
/**
* Is the day of this date same as the day of the specified local date?
* e.g. if 2011/11/27, isDaySameAs(toLocalDate("2013/09/27")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDaySameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return getDay() == prepareCompareDate(date).getDay();
}
/**
* Is the day of this date same as the day of the specified local date-time?
* e.g. if 2011/11/27, isDaySameAs(toLocalDateTime("2013/09/27")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDaySameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return getDay() == prepareCompareDate(date).getDay();
}
/**
* Is the day of this date same as the day of the specified date?
* e.g. if 2011/11/27, isDaySameAs(toDate("2013/09/27")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDaySameAs(Date date) {
assertArgumentNotNull("date", date);
return getDay() == prepareCompareDate(date).getDay();
}
/**
* Is the day of this date same as the day of the specified date?
* e.g. if 2011/11/27, isDaySameAs(new HandyDate("2013/09/27")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDaySameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getDay() == handyDate.getDay();
}
/**
* Is the date and day same as the specified local date?
* e.g. if 2011/11/27 00:00:00, isDayOfDateSameAs(toLocalDate("2011/11/27 12:34:56")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDayOfDateSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return isDayOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and day same as the specified local date-time?
* e.g. if 2011/11/27 00:00:00, isDayOfDateSameAs(toLocalDateTime("2011/11/27 12:34:56")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDayOfDateSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isDayOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and day same as the specified date?
* e.g. if 2011/11/27 00:00:00, isDayOfDateSameAs(toDate("2011/11/27 12:34:56")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDayOfDateSameAs(Date date) {
assertArgumentNotNull("date", date);
return isDayOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and day same as the specified date?
* e.g. if 2011/11/27 00:00:00, isDayOfDateSameAs(new HandyDate("2011/11/27 12:34:56")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isDayOfDateSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return isMonthOfYearSameAs(handyDate) && getDay() == handyDate.getDay();
}
/**
* Is the day of this date same as first day of the month?
*
* e.g.
* 2011/11/01: true
* 2011/11/02: false
* 2011/11/30: false
*
* @return The determination, true or false.
*/
public boolean isDay_MonthFirstDay() {
return isDay(_cal.getActualMinimum(Calendar.DAY_OF_MONTH));
}
/**
* Is the day of this date same as last day of the month?
*
* e.g.
* 2011/11/01: false
* 2011/11/02: false
* 2011/11/30: true
* 2011/12/30: false
* 2011/12/31: true
*
* @return The determination, true or false.
*/
public boolean isDay_MonthLastDay() {
return isDay(_cal.getActualMaximum(Calendar.DAY_OF_MONTH));
}
// -----------------------------------------------------
// Confirm Hour
// ------------
/**
* Is the hour of this date same as specified hour?
* e.g. if 2011/11/27 12:34:56, isHour(12) is true
* @param hour The integer of hour(0-23).
* @return The determination, true or false.
*/
public boolean isHour(int hour) {
return getHour() == hour;
}
/**
* Is the hour of this date same as the hour of the specified local date-time?
* e.g. if 2011/11/27 12:34:56, isHourSameAs(toLocalDateTime("2013/09/24 12:21:58")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isHourSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isHourSameAs(prepareCompareDate(date));
}
/**
* Is the hour of this date same as the hour of the specified date?
* e.g. if 2011/11/27 12:34:56, isHourSameAs(toDate("2013/09/24 12:21:58")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isHourSameAs(Date date) {
assertArgumentNotNull("date", date);
return isHourSameAs(prepareCompareDate(date));
}
/**
* Is the hour of this date same as the hour of the specified date?
* e.g. if 2011/11/27 12:34:56, isHourSameAs(new HandyDate("2013/09/24 12:21:58")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isHourSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getHour() == handyDate.getHour();
}
/**
* Is the date and hour same as the specified date?
* e.g. if 2011/11/27 12:00:00, isHourOfDateSameAs(toDate("2011/11/27 12:34:56")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isHourOfDateSameAs(Date date) {
assertArgumentNotNull("date", date);
return isHourOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and hour same as the specified date?
* e.g. if 2011/11/27 12:00:00, isHourOfDateSameAs(new HandyDate("2011/11/27 12:34:56")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isHourOfDateSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return isDayOfDateSameAs(handyDate) && getHour() == handyDate.getHour();
}
// -----------------------------------------------------
// Confirm Minute
// --------------
/**
* Is the minute of this date same as specified minute?
* e.g. if 2011/11/27 12:34:56, isMinute(34) is true
* @param minute The integer of minute(0-59).
* @return The determination, true or false.
*/
public boolean isMinute(int minute) {
return getMinute() == minute;
}
/**
* Is the minute of this date same as the minute of the specified local date-time?
* e.g. if 2011/11/27 12:34:56, isMinuteSameAs(toLocalDateTime("2013/09/26 07:34:31")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isMinuteSameAs(prepareCompareDate(date));
}
/**
* Is the minute of this date same as the minute of the specified date?
* e.g. if 2011/11/27 12:34:56, isMinuteSameAs(toDate("2013/09/26 07:34:31")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteSameAs(Date date) {
assertArgumentNotNull("date", date);
return isMinuteSameAs(prepareCompareDate(date));
}
/**
* Is the minute of this date same as the minute of the specified date?
* e.g. if 2011/11/27 12:34:56, isMinuteSameAs(new HandyDate("2013/09/26 07:34:31")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getMinute() == handyDate.getMinute();
}
/**
* Is the date and hour and minute same as the specified local date?
* e.g. if 2011/11/27 12:34:00, isMinuteOfDateSameAs(toLocalDate("2011/11/27 12:34:56")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteOfDateSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return isMinuteOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and hour and minute same as the specified local date-time?
* e.g. if 2011/11/27 12:34:00, isMinuteOfDateSameAs(toLocalDateTime("2011/11/27 12:34:56")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteOfDateSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isMinuteOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and hour and minute same as the specified date?
* e.g. if 2011/11/27 12:34:00, isMinuteOfDateSameAs(toDate("2011/11/27 12:34:56")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteOfDateSameAs(Date date) {
assertArgumentNotNull("date", date);
return isMinuteOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and hour and minute same as the specified date?
* e.g. if 2011/11/27 12:34:00, isMinuteOfDateSameAs(new HandyDate("2011/11/27 12:34:56")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isMinuteOfDateSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return isHourOfDateSameAs(handyDate) && getMinute() == handyDate.getMinute();
}
// -----------------------------------------------------
// Confirm Second
// --------------
/**
* Is the second of this date same as specified second?
* e.g. if 2011/11/27 12:34:56, isSecond(56) is true
* @param second The integer of minute(0-59).
* @return The determination, true or false.
*/
public boolean isSecond(int second) {
return getSecond() == second;
}
/**
* Is the second of this date same as the second of the specified local date-time?
* e.g. if 2011/11/27 12:34:56.123, isSecondSameAs(toLocalDateTime("2013/09/26 07:41:56.456")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isSecondSameAs(prepareCompareDate(date));
}
/**
* Is the second of this date same as the second of the specified date?
* e.g. if 2011/11/27 12:34:56.123, isSecondSameAs(toDate("2013/09/26 07:41:56.456")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondSameAs(Date date) {
assertArgumentNotNull("date", date);
return isSecondSameAs(prepareCompareDate(date));
}
/**
* Is the second of this date same as the second of the specified date?
* e.g. if 2011/11/27 12:34:56.123, isSecondSameAs(new HandyDate("2013/09/26 07:34:56.456")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return getSecond() == handyDate.getSecond();
}
/**
* Is the date and time same as the specified local date?
* e.g. if 2011/11/27 12:34:56.123, isSecondOfDateSameAs(toLocalDate("2011/11/27 12:34:56.456")) is true
* @param date The local date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondOfDateSameAs(LocalDate date) {
assertArgumentNotNull("date", date);
return isSecondOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and time same as the specified local date-time?
* e.g. if 2011/11/27 12:34:56.123, isSecondOfDateSameAs(toLocalDateTime("2011/11/27 12:34:56.456")) is true
* @param date The local date-time to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondOfDateSameAs(LocalDateTime date) {
assertArgumentNotNull("date", date);
return isSecondOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and time same as the specified date?
* e.g. if 2011/11/27 12:34:56.123, isSecondOfDateSameAs(toDate("2011/11/27 12:34:56.456")) is true
* @param date The date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondOfDateSameAs(Date date) {
assertArgumentNotNull("date", date);
return isSecondOfDateSameAs(prepareCompareDate(date));
}
/**
* Is the date and time same as the specified date?
* e.g. if 2011/11/27 12:34:56.123, isSecondOfDateSameAs(new HandyDate("2011/11/27 12:34:56.456")) is true
* @param handyDate The handy date to compare. (NotNull)
* @return The determination, true or false.
*/
public boolean isSecondOfDateSameAs(HandyDate handyDate) {
assertArgumentNotNull("handyDate", handyDate);
return isMinuteOfDateSameAs(handyDate) && getSecond() == handyDate.getSecond();
}
// -----------------------------------------------------
// Confirm Week
// ------------
/**
* Is the day of week Sunday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek1st_Sunday() {
return getDayOfWeek() == Calendar.SUNDAY;
}
/**
* Is the day of week Monday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek2nd_Monday() {
return getDayOfWeek() == Calendar.MONDAY;
}
/**
* Is the day of week Tuesday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek3rd_Tuesday() {
return getDayOfWeek() == Calendar.TUESDAY;
}
/**
* Is the day of week Wednesday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek4th_Wednesday() {
return getDayOfWeek() == Calendar.WEDNESDAY;
}
/**
* Is the day of week Thursday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek5th_Thursday() {
return getDayOfWeek() == Calendar.THURSDAY;
}
/**
* Is the day of week Friday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek6th_Friday() {
return getDayOfWeek() == Calendar.FRIDAY;
}
/**
* Is the day of week Saturday?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeek7th_Saturday() {
return getDayOfWeek() == Calendar.SATURDAY;
}
/**
* Is the day of week usual weekday (not Sunday and Saturday)?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeekWeekday() {
return !isWeek_DayOfWeek1st_Sunday() && !isWeek_DayOfWeek7th_Saturday();
}
/**
* Is the day of week usual holiday (Sunday or Saturday)?
* @return The determination, true or false.
*/
public boolean isWeek_DayOfWeekWeekend() {
return isWeek_DayOfWeek1st_Sunday() || isWeek_DayOfWeek7th_Saturday();
}
// ===================================================================================
// Calculate Parts
// ===============
// -----------------------------------------------------
// Calendar Distance
// -----------------
/**
* Calculate calendar distance of year between two date.
*
* e.g.
* 2013/03/03(this) and 2014/03/03(argument): 1
* 2014/03/03(this) and 2012/03/03(argument): -2
* 2013/12/31(this) and 2014/01/01(argument): 1 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceYears(LocalDate date) {
return doCalculateCalendarDistanceYears(toDate(date));
}
/**
* Calculate calendar distance of year between two date.
*
* e.g.
* 2013/03/03(this) and 2014/03/03(argument): 1
* 2014/03/03(this) and 2012/03/03(argument): -2
* 2013/12/31(this) and 2014/01/01(argument): 1 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceYears(LocalDateTime date) {
return doCalculateCalendarDistanceYears(toDate(date));
}
/**
* Calculate calendar distance of year between two date.
*
* e.g.
* 2013/03/03(this) and 2014/03/03(argument): 1
* 2014/03/03(this) and 2012/03/03(argument): -2
* 2013/12/31(this) and 2014/01/01(argument): 1 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of year as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceYears(Date date) {
return doCalculateCalendarDistanceYears(date);
}
protected int doCalculateCalendarDistanceYears(Date date) {
assertArgumentNotNull("date", date);
if (isYearSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
return you.getYear() - getYear();
}
/**
* Calculate calendar distance of month between two date.
*
* e.g.
* 2013/03/03(this) and 2013/04/03(argument): 1
* 2013/03/03(this) and 2013/01/03(argument): -2
* 2013/03/03(this) and 2014/01/03(argument): 10
* 2013/03/31(this) and 2013/04/01(argument): 1 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of month as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceMonths(LocalDate date) {
return doCalculateCalendarDistanceMonths(toDate(date));
}
/**
* Calculate calendar distance of month between two date.
*
* e.g.
* 2013/03/03(this) and 2013/04/03(argument): 1
* 2013/03/03(this) and 2013/01/03(argument): -2
* 2013/03/03(this) and 2014/01/03(argument): 10
* 2013/03/31(this) and 2013/04/01(argument): 1 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of month as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceMonths(LocalDateTime date) {
return doCalculateCalendarDistanceMonths(toDate(date));
}
/**
* Calculate calendar distance of month between two date.
*
* e.g.
* 2013/03/03(this) and 2013/04/03(argument): 1
* 2013/03/03(this) and 2013/01/03(argument): -2
* 2013/03/03(this) and 2014/01/03(argument): 10
* 2013/03/31(this) and 2013/04/01(argument): 1 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of month as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceMonths(Date date) {
return doCalculateCalendarDistanceMonths(date);
}
protected int doCalculateCalendarDistanceMonths(Date date) {
assertArgumentNotNull("date", date);
if (isMonthOfYearSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
final boolean greater = isGreaterThan(date);
int countMonths = 0;
while (true) {
if (isMonthOfYearSameAs(you)) {
break;
}
final boolean sameAs = isYearSameAs(you);
final int baseMonths = sameAs ? getMonthAsOneOrigin() : (greater ? 12 : 1);
final int adjustmentMonths = sameAs ? 0 : (greater ? 1 : -1);
final int plusMonths = baseMonths - you.getMonthAsOneOrigin() + adjustmentMonths;
you.addMonth(plusMonths);
countMonths = countMonths + plusMonths;
}
return -1 * countMonths; // -1 for greater: plus, less: minus
}
/**
* Calculate calendar distance of day between two date.
*
* e.g.
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/03(this) and 2013/04/07(argument): 35
* 2013/04/07(this) and 2013/03/03(argument): -35
* 2013/03/03(this) and 2014/03/03(argument): 365
* 2013/03/03 23:59:59(this) and 2013/03/07 00:00:00(argument): 4 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of day as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceDays(LocalDate date) {
return doCalculateCalendarDistanceDays(toDate(date));
}
/**
* Calculate calendar distance of day between two date.
*
* e.g.
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/03(this) and 2013/04/07(argument): 35
* 2013/04/07(this) and 2013/03/03(argument): -35
* 2013/03/03(this) and 2014/03/03(argument): 365
* 2013/03/03 23:59:59(this) and 2013/03/07 00:00:00(argument): 4 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of day as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceDays(LocalDateTime date) {
return doCalculateCalendarDistanceDays(toDate(date));
}
/**
* Calculate calendar distance of day between two date.
*
* e.g.
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/03(this) and 2013/04/07(argument): 35
* 2013/04/07(this) and 2013/03/03(argument): -35
* 2013/03/03(this) and 2014/03/03(argument): 365
* 2013/03/03 23:59:59(this) and 2013/03/07 00:00:00(argument): 4 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of day as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceDays(Date date) {
return doCalculateCalendarDistanceDays(date);
}
protected int doCalculateCalendarDistanceDays(Date date) {
assertArgumentNotNull("date", date);
if (isDayOfDateSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
final boolean greater = isGreaterThan(date);
int countDays = 0;
while (true) {
if (isDayOfDateSameAs(you)) {
break;
}
final boolean sameAs = isMonthOfYearSameAs(you);
final int baseDays = sameAs ? getDay() : (greater ? you.getLastDayOfMonth() : you.getFirstDayOfMonth());
final int adjustmentDays = sameAs ? 0 : (greater ? 1 : -1);
final int plusDays = baseDays - you.getDay() + adjustmentDays;
you.addDay(plusDays);
countDays = countDays + plusDays;
}
return -1 * countDays; // -1 for greater: plus, less: minus
}
/**
* Calculate calendar distance of hour between two date.
*
* e.g.
* 2013/03/03 07:00:00(this) and 2013/03/03 12:34:56(argument): 5
* 2013/03/03 12:00:00(this) and 2013/03/03 07:34:56(argument): -5
* 2013/03/03 07:00:00(this) and 2013/03/04 14:34:56(argument): 31
* 2013/03/03 07:59:59(this) and 2013/03/03 09:00:00(argument): 2 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of hour as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceHours(LocalDate date) {
return doCalculateCalendarDistanceHours(toDate(date));
}
/**
* Calculate calendar distance of hour between two date.
*
* e.g.
* 2013/03/03 07:00:00(this) and 2013/03/03 12:34:56(argument): 5
* 2013/03/03 12:00:00(this) and 2013/03/03 07:34:56(argument): -5
* 2013/03/03 07:00:00(this) and 2013/03/04 14:34:56(argument): 31
* 2013/03/03 07:59:59(this) and 2013/03/03 09:00:00(argument): 2 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of hour as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceHours(LocalDateTime date) {
return doCalculateCalendarDistanceHours(toDate(date));
}
/**
* Calculate calendar distance of hour between two date.
*
* e.g.
* 2013/03/03 07:00:00(this) and 2013/03/03 12:34:56(argument): 5
* 2013/03/03 12:00:00(this) and 2013/03/03 07:34:56(argument): -5
* 2013/03/03 07:00:00(this) and 2013/03/04 14:34:56(argument): 31
* 2013/03/03 07:59:59(this) and 2013/03/03 09:00:00(argument): 2 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of hour as distance between the two date. (MinusAllowed)
*/
public int calculateCalendarDistanceHours(Date date) {
return doCalculateCalendarDistanceHours(date);
}
protected int doCalculateCalendarDistanceHours(Date date) {
assertArgumentNotNull("date", date);
if (isHourOfDateSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
final boolean greater = isGreaterThan(date);
int countHours = 0;
while (true) {
if (isHourOfDateSameAs(you)) {
break;
}
final boolean sameAs = isDayOfDateSameAs(you);
final int baseHours = sameAs ? getHour() : (greater ? 23 : 0);
final int adjustmentHours = sameAs ? 0 : (greater ? 1 : -1);
final int plusHours = baseHours - you.getHour() + adjustmentHours;
you.addHour(plusHours);
countHours = countHours + plusHours;
}
return -1 * countHours; // -1 for greater: plus, less: minus
}
/**
* Calculate calendar distance of minute between two date.
*
* e.g.
* 2013/03/03 07:34:00(this) and 2013/03/03 07:57:00(argument): 23
* 2013/03/03 07:34:00(this) and 2013/03/03 12:34:00(argument): 300
* 2013/03/03 07:34:00(this) and 2013/03/03 07:22:56(argument): -12
* 2013/03/03 07:34:59(this) and 2013/03/03 07:36:00(argument): 2 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of minute as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceMinutes(LocalDate date) {
return doCalculateCalendarDistanceMinutes(toDate(date));
}
/**
* Calculate calendar distance of minute between two date.
*
* e.g.
* 2013/03/03 07:34:00(this) and 2013/03/03 07:57:00(argument): 23
* 2013/03/03 07:34:00(this) and 2013/03/03 12:34:00(argument): 300
* 2013/03/03 07:34:00(this) and 2013/03/03 07:22:56(argument): -12
* 2013/03/03 07:34:59(this) and 2013/03/03 07:36:00(argument): 2 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of minute as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceMinutes(LocalDateTime date) {
return doCalculateCalendarDistanceMinutes(toDate(date));
}
/**
* Calculate calendar distance of minute between two date.
*
* e.g.
* 2013/03/03 07:34:00(this) and 2013/03/03 07:57:00(argument): 23
* 2013/03/03 07:34:00(this) and 2013/03/03 12:34:00(argument): 300
* 2013/03/03 07:34:00(this) and 2013/03/03 07:22:56(argument): -12
* 2013/03/03 07:34:59(this) and 2013/03/03 07:36:00(argument): 2 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of minute as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceMinutes(Date date) {
return doCalculateCalendarDistanceMinutes(date);
}
protected long doCalculateCalendarDistanceMinutes(Date date) {
assertArgumentNotNull("date", date);
if (isMinuteOfDateSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
final boolean greater = isGreaterThan(date);
long countMinutes = 0;
while (true) {
if (isMinuteOfDateSameAs(you)) {
break;
}
final boolean sameAs = isHourOfDateSameAs(you);
final int baseMinutes = sameAs ? getMinute() : (greater ? 59 : 0);
final int adjustmentMinutes = sameAs ? 0 : (greater ? 1 : -1);
final int plusMinutes = baseMinutes - you.getMinute() + adjustmentMinutes;
you.addMinute(plusMinutes);
countMinutes = countMinutes + (long) plusMinutes;
}
return -1L * countMinutes; // -1 for greater: plus, less: minus
}
/**
* Calculate calendar distance of second between two date.
*
* e.g.
* 2013/03/03 07:34:22(this) and 2013/03/03 07:34:37(argument): 15
* 2013/03/03 07:34:22(this) and 2013/03/03 07:35:24(argument): 62
* 2013/03/03 07:34:43(this) and 2013/03/03 07:34:22(argument): -21
* 2013/03/03 07:34:56.999(this) and 2013/03/03 07:34.58.000(argument): 2 *attention
*
* @param date The local date to calculate. (NotNull)
* @return The count of second as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceSeconds(LocalDate date) {
return doCalculateCalendarDistanceSeconds(toDate(date));
}
/**
* Calculate calendar distance of second between two date.
*
* e.g.
* 2013/03/03 07:34:22(this) and 2013/03/03 07:34:37(argument): 15
* 2013/03/03 07:34:22(this) and 2013/03/03 07:35:24(argument): 62
* 2013/03/03 07:34:43(this) and 2013/03/03 07:34:22(argument): -21
* 2013/03/03 07:34:56.999(this) and 2013/03/03 07:34.58.000(argument): 2 *attention
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of second as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceSeconds(LocalDateTime date) {
return doCalculateCalendarDistanceSeconds(toDate(date));
}
/**
* Calculate calendar distance of second between two date.
*
* e.g.
* 2013/03/03 07:34:22(this) and 2013/03/03 07:34:37(argument): 15
* 2013/03/03 07:34:22(this) and 2013/03/03 07:35:24(argument): 62
* 2013/03/03 07:34:43(this) and 2013/03/03 07:34:22(argument): -21
* 2013/03/03 07:34:56.999(this) and 2013/03/03 07:34.58.000(argument): 2 *attention
*
* @param date The date to calculate. (NotNull)
* @return The count of second as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceSeconds(Date date) {
return doCalculateCalendarDistanceSeconds(date);
}
protected long doCalculateCalendarDistanceSeconds(Date date) {
assertArgumentNotNull("date", date);
if (isSecondOfDateSameAs(date)) {
return 0;
}
final HandyDate you = prepareCompareDate(date);
final boolean greater = isGreaterThan(date);
long countSeconds = 0L;
while (true) {
if (isSecondOfDateSameAs(you)) {
break;
}
final boolean sameAs = isMinuteOfDateSameAs(you);
final int baseSeconds = sameAs ? getSecond() : (greater ? 59 : 0);
final int adjustmentSeconds = sameAs ? 0 : (greater ? 1 : -1);
final int plusSeconds = baseSeconds - you.getSecond() + adjustmentSeconds;
you.addSecond(plusSeconds);
countSeconds = countSeconds + (long) plusSeconds;
}
return -1L * countSeconds; // -1 for greater: plus, less: minus
}
/**
* Calculate calendar distance of millisecond between two date.
*
* e.g.
* 2013/03/03 07:34:12.123(this) and 2013/03/03 07:34:12.163(argument): 40
* 2013/03/03 07:34:12.123(this) and 2013/03/03 07:34:15.163(argument): 3040
*
* @param date The date to calculate. (NotNull)
* @return The count of millisecond as distance between the two date. (MinusAllowed)
*/
public long calculateCalendarDistanceMilliseconds(Date date) {
assertArgumentNotNull("date", date);
return date.getTime() - _cal.getTimeInMillis();
}
// -----------------------------------------------------
// Measured Distance
// -----------------
/**
* Calculate measured distance of year between two date.
*
* e.g.
* 2013/12/31(this) and 2014/01/01(argument): 0
* 2013/12/31(this) and 2014/07/15(argument): 1
* 2014/01/01(this) and 2015/04/01(argument): 1
* 2014/01/01(this) and 2015/09/01(argument): 2
* 2013/03/07(this) and 7099/10/07(argument): 5087
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceYears(LocalDate date) {
return doCalculateMeasuredDistanceYears(toDate(date));
}
/**
* Calculate measured distance of year between two date.
*
* e.g.
* 2013/12/31(this) and 2014/01/01(argument): 0
* 2013/12/31(this) and 2014/07/15(argument): 1
* 2014/01/01(this) and 2015/04/01(argument): 1
* 2014/01/01(this) and 2015/09/01(argument): 2
* 2013/03/07(this) and 7099/10/07(argument): 5087
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceYears(LocalDateTime date) {
return doCalculateMeasuredDistanceYears(toDate(date));
}
/**
* Calculate measured distance of year between two date.
*
* e.g.
* 2013/12/31(this) and 2014/01/01(argument): 0
* 2013/12/31(this) and 2014/07/15(argument): 1
* 2014/01/01(this) and 2015/04/01(argument): 1
* 2014/01/01(this) and 2015/09/01(argument): 2
* 2013/03/07(this) and 7099/10/07(argument): 5087
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceYears(Date date) {
return doCalculateMeasuredDistanceYears(date);
}
protected int doCalculateMeasuredDistanceYears(Date date) {
final int months = calculateMeasuredDistanceMonths(date);
return (months / 12) + ((months % 12) > 6 ? 1 : 0);
}
/**
* Calculate measured distance of month between two date.
* The distance might have margin of error.
*
* e.g.
* 2013/03/20(this) and 2013/04/03(argument): 0
* 2013/03/07(this) and 2013/04/03(argument): 1
* 2013/03/01(this) and 2013/01/28(argument): 2
* 2013/03/01(this) and 2013/08/01(argument): 5
* 2013/03/01(this) and 2013/08/31(argument): 6
* 2013/03/01(this) and 2033/08/31(argument): 246
* 2013/01/01(this) and 3013/01/01(argument): 12000
* 2013/01/01(this) and 7013/01/01(argument): 60000
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceMonths(LocalDate date) {
return doCalculateMeasuredDistanceMonths(toDate(date));
}
/**
* Calculate measured distance of month between two date.
* The distance might have margin of error.
*
* e.g.
* 2013/03/20(this) and 2013/04/03(argument): 0
* 2013/03/07(this) and 2013/04/03(argument): 1
* 2013/03/01(this) and 2013/01/28(argument): 2
* 2013/03/01(this) and 2013/08/01(argument): 5
* 2013/03/01(this) and 2013/08/31(argument): 6
* 2013/03/01(this) and 2033/08/31(argument): 246
* 2013/01/01(this) and 3013/01/01(argument): 12000
* 2013/01/01(this) and 7013/01/01(argument): 60000
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceMonths(LocalDateTime date) {
return doCalculateMeasuredDistanceMonths(toDate(date));
}
/**
* Calculate measured distance of month between two date.
* The distance might have margin of error.
*
* e.g.
* 2013/03/20(this) and 2013/04/03(argument): 0
* 2013/03/07(this) and 2013/04/03(argument): 1
* 2013/03/01(this) and 2013/01/28(argument): 2
* 2013/03/01(this) and 2013/08/01(argument): 5
* 2013/03/01(this) and 2013/08/31(argument): 6
* 2013/03/01(this) and 2033/08/31(argument): 246
* 2013/01/01(this) and 3013/01/01(argument): 12000
* 2013/01/01(this) and 7013/01/01(argument): 60000
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceMonths(Date date) {
return doCalculateMeasuredDistanceMonths(date);
}
protected int doCalculateMeasuredDistanceMonths(Date date) {
final HandyDate copyInstance = createCopyInstance();
final int months = calculateCalendarDistanceMonths(date);
final int diffDays = copyInstance.addMonth(months).calculateCalendarDistanceDays(date);
return months + (diffDays > 15 ? 1 : (diffDays < -15 ? -1 : 0));
// memorable code
//final int months = calculateCalendarDistanceMonths(date);
//final int distance = (days / 30) + ((days % 30) > 15 ? 1 : 0);
//final int years = (months / 12);
//final int marginOfErrorDays = (years * 5) + (years / 4);
//final int marginOfErrorMonths = marginOfErrorDays / 30;
//final int ajudstedDistance = distance - marginOfErrorMonths;
//return months + (months - ajudstedDistance > 0 ? -1 : (months - ajudstedDistance < 0 ? 1 : 0));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/04/01 23:59:59(this) and 2013/04/02 00:00:00(argument): 0
* 2013/04/01 10:00:00(this) and 2013/04/02 23:59:59(argument): 2
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceDays(LocalDate date) {
return doCalculateMeasuredDistanceDays(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/04/01 23:59:59(this) and 2013/04/02 00:00:00(argument): 0
* 2013/04/01 10:00:00(this) and 2013/04/02 23:59:59(argument): 2
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceDays(LocalDateTime date) {
return doCalculateMeasuredDistanceDays(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/04/01 23:59:59(this) and 2013/04/02 00:00:00(argument): 0
* 2013/04/01 10:00:00(this) and 2013/04/02 23:59:59(argument): 2
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceDays(Date date) {
return doCalculateMeasuredDistanceDays(date);
}
protected int doCalculateMeasuredDistanceDays(Date date) {
final int hours = calculateMeasuredDistanceHours(date);
return (hours / 24) + ((hours % 24) > 12 ? 1 : 0);
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 13:00:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 14:10:00(argument): 2
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceHours(LocalDate date) {
return doCalculateMeasuredDistanceHours(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 13:00:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 14:10:00(argument): 2
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceHours(LocalDateTime date) {
return doCalculateMeasuredDistanceHours(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 13:00:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 14:10:00(argument): 2
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public int calculateMeasuredDistanceHours(Date date) {
return doCalculateMeasuredDistanceHours(date);
}
protected int doCalculateMeasuredDistanceHours(Date date) {
final long minutes = calculateMeasuredDistanceMinutes(date);
return (int) (minutes / 60) + ((minutes % 60) > 30 ? 1 : 0); // to integer
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 12:35:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 12:37:00(argument): 2
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceMinutes(LocalDate date) {
return doCalculateMeasuredDistanceMinutes(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 12:35:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 12:37:00(argument): 2
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceMinutes(LocalDateTime date) {
return doCalculateMeasuredDistanceMinutes(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56(this) and 2013/12/31 12:35:00(argument): 0
* 2013/12/31 12:34:56(this) and 2013/12/31 12:37:00(argument): 2
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceMinutes(Date date) {
return doCalculateMeasuredDistanceMinutes(date);
}
protected long doCalculateMeasuredDistanceMinutes(Date date) {
final long seconds = calculateMeasuredDistanceSeconds(date);
return (seconds / 60L) + ((seconds % 60L) > 30L ? 1L : 0L);
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:57.000(argument): 0
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:58.333(argument): 2
*
* @param date The local date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceSeconds(LocalDate date) {
return doCalculateMeasuredDistanceSeconds(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:57.000(argument): 0
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:58.333(argument): 2
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceSeconds(LocalDateTime date) {
return doCalculateMeasuredDistanceSeconds(toDate(date));
}
/**
* Calculate measured distance of month between two date.
*
* e.g.
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:57.000(argument): 0
* 2013/12/31 12:34:56.789(this) and 2013/12/31 12:34:58.333(argument): 2
*
* @param date The date to calculate. (NotNull)
* @return The count of year as measured distance between the two date. (MinusAllowed)
*/
public long calculateMeasuredDistanceSeconds(Date date) {
return doCalculateMeasuredDistanceSeconds(date);
}
protected long doCalculateMeasuredDistanceSeconds(Date date) {
final long milliseconds = calculateCalendarDistanceMilliseconds(date);
return (milliseconds / 1000L) + ((milliseconds % 1000L) > 500L ? 1L : 0L);
}
// -----------------------------------------------------
// Size of Days
// ------------
/**
* Calculate business-day size between two date.
*
* e.g. when Sunday and Saturday is false
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The date to calculate. (NotNull)
* @param determiner The determiner of business day. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeBusinessDays(LocalDate date, BusinessDayDeterminer determiner) {
return doCalculateSizeBusinessDays(toDate(date), determiner);
}
/**
* Calculate business-day size between two date.
*
* e.g. when Sunday and Saturday is false
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The local date-time to calculate. (NotNull)
* @param determiner The determiner of business day. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeBusinessDays(LocalDateTime date, BusinessDayDeterminer determiner) {
return doCalculateSizeBusinessDays(toDate(date), determiner);
}
/**
* Calculate business-day size between two date.
*
* e.g. when Sunday and Saturday is false
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The local date to calculate. (NotNull)
* @param determiner The determiner of business day. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeBusinessDays(Date date, BusinessDayDeterminer determiner) {
return doCalculateSizeBusinessDays(date, determiner);
}
protected int doCalculateSizeBusinessDays(Date date, BusinessDayDeterminer determiner) {
assertArgumentNotNull("date", date);
if (isDayOfDateSameAs(date)) {
return 0;
}
int countDays = 0;
final HandyDate you = prepareCompareDate(date);
if (determiner.isBusinessDay(you)) {
++countDays;
}
final boolean greater = isGreaterThan(date);
while (true) {
if (isDayOfDateSameAs(you)) {
break;
}
you.addDay(greater ? 1 : -1);
if (determiner.isBusinessDay(you)) {
++countDays;
}
}
return countDays > 0 ? countDays : (countDays * -1);
}
/**
* Calculate weekday size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The local date to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekdays(LocalDate date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekdays(toDate(date));
}
/**
* Calculate weekday size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekdays(LocalDateTime date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekdays(toDate(date));
}
/**
* Calculate weekday size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 4
* 2013/03/07(this) and 2013/03/13(argument): 5
* 2013/03/07(this) and 2013/03/16(argument): 7
* 2013/03/16(this) and 2013/03/07(argument): 7
*
* @param date The date to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekdays(Date date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekdays(date);
}
protected int doCalculateSizeWeekdays(Date date) {
return calculateSizeBusinessDays(date, hd -> hd.isWeek_DayOfWeekWeekday());
}
/**
* Calculate weekend-day size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 1
* 2013/03/07(this) and 2013/03/13(argument): 2
*
* @param date The local date to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekendDays(LocalDate date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekendDays(toDate(date));
}
/**
* Calculate weekend-day size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 1
* 2013/03/07(this) and 2013/03/13(argument): 2
*
* @param date The local date-time to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekendDays(LocalDateTime date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekendDays(toDate(date));
}
/**
* Calculate weekend-day size between two date.
*
* e.g. 2013/03/03 is Sunday
* 2013/03/03(this) and 2013/03/07(argument): 1
* 2013/03/07(this) and 2013/03/13(argument): 2
*
* @param date The date to calculate. (NotNull)
* @return The count of weekday as size between the two date. (NotMinus)
*/
public int calculateSizeWeekendDays(Date date) {
assertArgumentNotNull("date", date);
return doCalculateSizeWeekendDays(date);
}
protected int doCalculateSizeWeekendDays(Date date) {
return calculateSizeBusinessDays(date, hd -> hd.isWeek_DayOfWeekWeekend());
}
// ===================================================================================
// Choose Parts
// ============
// -----------------------------------------------------
// Both-side Date
// --------------
/**
* Choose the nearest date to this date.
* If the same distance is found, it returns the future date.
*
* e.g. date: 2011/11/27
* date.chooseNearestDate(2011/11/24, 2011/11/26): 2011/11/26
* date.chooseNearestDate(2011/11/25, 2011/11/28): 2011/11/28
*
* @param dates The array of comparison target local date. (NotNull)
* @return The nearest local date. (NotNull)
*/
public LocalDate chooseNearestDate(LocalDate... dates) {
return toLocalDate(doChooseNearestDate(toDateArray(dates)));
}
/**
* Choose the nearest date to this date.
* If the same distance is found, it returns the future date.
*
* e.g. date: 2011/11/27
* date.chooseNearestDate(2011/11/24, 2011/11/26): 2011/11/26
* date.chooseNearestDate(2011/11/25, 2011/11/28): 2011/11/28
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The nearest local date-time. (NotNull)
*/
public LocalDateTime chooseNearestDate(LocalDateTime... dates) {
return toLocalDateTime(doChooseNearestDate(toDateArray(dates)));
}
/**
* Choose the nearest date to this date.
* If the same distance is found, it returns the future date.
*
* e.g. date: 2011/11/27
* date.chooseNearestDate(2011/11/24, 2011/11/26): 2011/11/26
* date.chooseNearestDate(2011/11/25, 2011/11/28): 2011/11/28
*
* @param dates The array of comparison target date. (NotNull)
* @return The nearest date. (NotNull)
*/
public Date chooseNearestDate(Date... dates) {
return doChooseNearestDate(dates);
}
protected Date doChooseNearestDate(Date... dates) {
assertCompareDateArrayValid(dates);
Long nearestMillis = null;
Date nearestDate = null;
final long standardMillis = _cal.getTimeInMillis();
for (Date date : dates) {
long distanceMillis = date.getTime() - standardMillis;
boolean past = false;
if (distanceMillis < 0) { // contains past
distanceMillis = distanceMillis * -1L;
past = true;
}
if (nearestMillis == null || nearestMillis > distanceMillis) {
nearestMillis = distanceMillis;
nearestDate = date;
} else if (nearestMillis == distanceMillis && !past) {
nearestDate = date; // future is prior
}
}
return nearestDate;
}
// -----------------------------------------------------
// Future Date
// -----------
/**
* Choose the nearest future date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestFutureDate(2011/11/29, 2011/11/28): 2011/11/28
* date.chooseNearestFutureDate(2011/11/26, 2011/11/29): 2011/11/29
*
* @param dates The array of comparison target local date. (NotNull)
* @return The nearest future local date. (NotNull)
*/
public LocalDate chooseNearestFutureDate(LocalDate... dates) {
return toLocalDate(doChooseNearestFutureDate(toDateArray(dates)));
}
/**
* Choose the nearest future date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestFutureDate(2011/11/29, 2011/11/28): 2011/11/28
* date.chooseNearestFutureDate(2011/11/26, 2011/11/29): 2011/11/29
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The nearest future local date-time. (NotNull)
*/
public LocalDateTime chooseNearestFutureDate(LocalDateTime... dates) {
return toLocalDateTime(doChooseNearestFutureDate(toDateArray(dates)));
}
/**
* Choose the nearest future date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestFutureDate(2011/11/29, 2011/11/28): 2011/11/28
* date.chooseNearestFutureDate(2011/11/26, 2011/11/29): 2011/11/29
*
* @param dates The array of comparison target date. (NotNull)
* @return The nearest future date. (NotNull)
*/
public Date chooseNearestFutureDate(Date... dates) {
return doChooseNearestFutureDate(dates);
}
protected Date doChooseNearestFutureDate(Date... dates) {
assertCompareDateArrayValid(dates);
Long nearestMillis = null;
Date nearestDate = null;
final long standardMillis = _cal.getTimeInMillis();
for (Date date : dates) {
long distanceMillis = date.getTime() - standardMillis;
if (distanceMillis < 0) { // ignore past
continue;
}
if (nearestMillis == null || nearestMillis > distanceMillis) {
nearestMillis = distanceMillis;
nearestDate = date;
}
}
return nearestDate;
}
// -----------------------------------------------------
// Past Date
// ---------
/**
* Choose the nearest past date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestPastDate(2011/11/26, 2011/11/25): 2011/11/26
* date.chooseNearestPastDate(2011/11/25, 2011/11/28): 2011/11/25
*
* @param dates The array of comparison target local date. (NotNull)
* @return The nearest past local date. (NotNull)
*/
public LocalDate chooseNearestPastDate(LocalDate... dates) {
return toLocalDate(doChooseNearestPastDate(toDateArray(dates)));
}
/**
* Choose the nearest past date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestPastDate(2011/11/26, 2011/11/25): 2011/11/26
* date.chooseNearestPastDate(2011/11/25, 2011/11/28): 2011/11/25
*
* @param dates The array of comparison target local date-time. (NotNull)
* @return The nearest past local date-time. (NotNull)
*/
public LocalDateTime chooseNearestPastDate(LocalDateTime... dates) {
return toLocalDateTime(doChooseNearestPastDate(toDateArray(dates)));
}
/**
* Choose the nearest past date to this date.
*
* e.g. date: 2011/11/27
* date.chooseNearestPastDate(2011/11/26, 2011/11/25): 2011/11/26
* date.chooseNearestPastDate(2011/11/25, 2011/11/28): 2011/11/25
*
* @param dates The array of comparison target date. (NotNull)
* @return The nearest past date. (NotNull)
*/
public Date chooseNearestPastDate(Date... dates) {
return doChooseNearestPastDate(dates);
}
protected Date doChooseNearestPastDate(Date... dates) {
assertCompareDateArrayValid(dates);
Long nearestMillis = null;
Date nearestDate = null;
final long standardMillis = _cal.getTimeInMillis();
for (Date date : dates) {
long distanceMillis = date.getTime() - standardMillis;
if (distanceMillis > 0) { // ignore future
continue;
}
distanceMillis = distanceMillis * -1L;
if (nearestMillis == null || nearestMillis > distanceMillis) {
nearestMillis = distanceMillis;
nearestDate = date;
}
}
return nearestDate;
}
// ===================================================================================
// Begin Date
// ==========
// -----------------------------------------------------
// Begin Year
// ----------
/**
* Begin year from the specified month.
* The date of argument is used as only the month part.
*
* e.g. beginYear_Month(toLocalDate("2001/04/01"))
* year is from 4th month to 3rd month of next year
* (the 2011 year means 2011/04/01 to 2012/03/31)
*
* if the date is 2011/01/01, moveToYearJust() moves it to 2011/04/01
* (means the date moves to just beginning of the 2011 year)
*
* @param yearBeginMonth The local date that has the month of year-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginYear_Month(LocalDate yearBeginMonth) {
doBeginYear_Month(toDate(yearBeginMonth));
return this;
}
/**
* Begin year from the specified month.
* The date of argument is used as only the month part.
*
* e.g. beginYear_Month(toLocalDate("2001/04/01"))
* year is from 4th month to 3rd month of next year
* (the 2011 year means 2011/04/01 to 2012/03/31)
*
* if the date is 2011/01/01, moveToYearJust() moves it to 2011/04/01
* (means the date moves to just beginning of the 2011 year)
*
* @param yearBeginMonth The local date-time that has the month of year-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginYear_Month(LocalDateTime yearBeginMonth) {
doBeginYear_Month(toDate(yearBeginMonth));
return this;
}
/**
* Begin year from the specified month.
* The date of argument is used as only the month part.
*
* e.g. beginYear_Month(toDate("2001/04/01"))
* year is from 4th month to 3rd month of next year
* (the 2011 year means 2011/04/01 to 2012/03/31)
*
* if the date is 2011/01/01, moveToYearJust() moves it to 2011/04/01
* (means the date moves to just beginning of the 2011 year)
*
* @param yearBeginMonth The date that has the month of year-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginYear_Month(Date yearBeginMonth) {
doBeginYear_Month(yearBeginMonth);
return this;
}
protected void doBeginYear_Month(Date yearBeginMonth) {
assertArgumentNotNull("yearBeginMonth", yearBeginMonth);
_yearBeginMonth = new HandyDate(yearBeginMonth).timeZone(getCalendarTimeZone()).getMonthAsOneOrigin();
}
/**
* Begin year from the specified month.
*
* e.g. beginYear_Month(4)
* year is from 4th month to 3rd month of next year
* (the 2011 year means 2011/04/01 to 2012/03/31)
*
* if the date is 2011/01/01, moveToYearJust() moves it to 2011/04/01
* (means the date moves to just beginning of the 2011 year)
*
* @param yearBeginMonth The month for year-begin.
* @return this. (NotNull)
*/
public HandyDate beginYear_Month(int yearBeginMonth) {
assertNotMinusNotOver("yearBeginMonth", yearBeginMonth, 12);
_yearBeginMonth = yearBeginMonth;
return this;
}
/**
* Begin year from January (1st month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month01_January() {
_yearBeginMonth = 1;
return this;
}
/**
* Begin year from February (2nd month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month02_February() {
_yearBeginMonth = 2;
return this;
}
/**
* Begin year from March (3rd month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month03_March() {
_yearBeginMonth = 3;
return this;
}
/**
* Begin year from April (4th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month04_April() {
_yearBeginMonth = 4;
return this;
}
/**
* Begin year from May (5th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month05_May() {
_yearBeginMonth = 5;
return this;
}
/**
* Begin year from June (6th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month06_June() {
_yearBeginMonth = 6;
return this;
}
/**
* Begin year from July (7th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month07_July() {
_yearBeginMonth = 7;
return this;
}
/**
* Begin year from August (8th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month08_August() {
_yearBeginMonth = 8;
return this;
}
/**
* Begin year from September (9th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month09_September() {
_yearBeginMonth = 9;
return this;
}
/**
* Begin year from October (10th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month10_October() {
_yearBeginMonth = 10;
return this;
}
/**
* Begin year from November (11th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month11_November() {
_yearBeginMonth = 11;
return this;
}
/**
* Begin year from December (12th month).
* @return this. (NotNull)
*/
public HandyDate beginYear_Month12_December() {
_yearBeginMonth = 12;
return this;
}
/**
* Begin year from the specified month of previous year.
*
* e.g. beginYear_PreviousMonth(11)
* year is from 11th month of previous year to 10th month of this year
* (the 2011 year means 2010/11/01 to 2011/10/31)
*
* if the date is 2011/01/01, moveToYearJust() moves it to 2010/11/01
* (means the date moves to just beginning of the 2011 year)
*
* @param yearBeginMonth The month of previous year for year-begin.
* @return this. (NotNull)
*/
public HandyDate beginYear_PreviousMonth(int yearBeginMonth) {
assertNotMinusNotOver("yearBeginMonth", yearBeginMonth, 12);
_yearBeginMonth = -yearBeginMonth; // to be minus
return this;
}
// -----------------------------------------------------
// Begin Month
// -----------
/**
* Begin month from the specified day.
* The date of argument is used as only the day part.
*
* e.g. beginMonth_Day(toLocalDate("2001/01/03"))
* month is from 3 day to 2 day of next month
* (the 2011/11 means 2011/11/03 to 2011/12/02)
*
* if the date is 2011/11/01, moveToMonthJust() moves it to 2011/11/03
* (means the date moves to just beginning of 2011/11)
*
* @param monthBeginDay The local date that has the day of month-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginMonth_Day(LocalDate monthBeginDay) {
doBeginMonth_Day(toDate(monthBeginDay));
return this;
}
/**
* Begin month from the specified day.
* The date of argument is used as only the day part.
*
* e.g. beginMonth_Day(toLocalDateTime("2001/01/03"))
* month is from 3 day to 2 day of next month
* (the 2011/11 means 2011/11/03 to 2011/12/02)
*
* if the date is 2011/11/01, moveToMonthJust() moves it to 2011/11/03
* (means the date moves to just beginning of 2011/11)
*
* @param monthBeginDay The local date-time that has the day of month-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginMonth_Day(LocalDateTime monthBeginDay) {
doBeginMonth_Day(toDate(monthBeginDay));
return this;
}
/**
* Begin month from the specified day.
* The date of argument is used as only the day part.
*
* e.g. beginMonth_Day(toDate("2001/01/03"))
* month is from 3 day to 2 day of next month
* (the 2011/11 means 2011/11/03 to 2011/12/02)
*
* if the date is 2011/11/01, moveToMonthJust() moves it to 2011/11/03
* (means the date moves to just beginning of 2011/11)
*
* @param monthBeginDay The date that has the day of month-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginMonth_Day(Date monthBeginDay) {
doBeginMonth_Day(monthBeginDay);
return this;
}
protected void doBeginMonth_Day(Date monthBeginDay) {
assertArgumentNotNull("monthBeginDay", monthBeginDay);
_monthBeginDay = new HandyDate(monthBeginDay).timeZone(getCalendarTimeZone()).getDay();
}
/**
* Begin month from the specified day.
*
* e.g. beginMonth_Day(3)
* month is from 3 day to 2 day of next month
* (the 2011/11 means 2011/11/03 to 2011/12/02)
*
* if the date is 2011/11/01, moveToMonthJust() moves it to 2011/11/03
* (means the date moves to just beginning of 2011/11)
*
* @param monthBeginDay The day for month-begin.
* @return this. (NotNull)
*/
public HandyDate beginMonth_Day(int monthBeginDay) {
assertNotMinusNotOver("monthBeginDay", monthBeginDay, 31);
_monthBeginDay = monthBeginDay;
return this;
}
/**
* Begin year from the specified day of previous month.
*
* e.g. beginMonth_PreviousDay(25)
* month is from 25 day of previous year to 24 day of this month
* (the 2011/11 means 2011/10/25 to 2011/11/24)
*
* if the date is 2011/11/01, moveToMonthJust() moves it to 2011/10/25
* (means the date moves to just beginning of 2011/11)
*
* @param monthBeginDay The day of previous month for month-begin.
* @return this. (NotNull)
*/
public HandyDate beginMonth_PreviousDay(int monthBeginDay) {
assertNotMinusNotOver("monthBeginDay", monthBeginDay, 31);
_monthBeginDay = -monthBeginDay; // to be minus
return this;
}
// -----------------------------------------------------
// Begin Day
// ---------
/**
* Begin day from the specified hour.
*
* e.g. beginDay_Hour(toLocalDate("2001/01/01 06:00:00"))
* day is from 06h to 05h of next day
* (the 2011/11/27 means 2011/11/27 06h to 2011/11/28 05h)
*
* if the date is 2011/11/27 00:00:00, moveToDayJust() moves it to 2011/11/27 06:00:00
* (means the date moves to just beginning of 2011/11/27)
*
* @param dayBeginHour The local date that has the hour of day-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginDay_Hour(LocalDate dayBeginHour) {
doBeginDay_Hour(toDate(dayBeginHour));
return this;
}
/**
* Begin day from the specified hour.
*
* e.g. beginDay_Hour(toLocalDateTime("2001/01/01 06:00:00"))
* day is from 06h to 05h of next day
* (the 2011/11/27 means 2011/11/27 06h to 2011/11/28 05h)
*
* if the date is 2011/11/27 00:00:00, moveToDayJust() moves it to 2011/11/27 06:00:00
* (means the date moves to just beginning of 2011/11/27)
*
* @param dayBeginHour The local date-time that has the hour of day-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginDay_Hour(LocalDateTime dayBeginHour) {
doBeginDay_Hour(toDate(dayBeginHour));
return this;
}
/**
* Begin day from the specified hour.
*
* e.g. beginDay_Hour(toDate("2001/01/01 06:00:00"))
* day is from 06h to 05h of next day
* (the 2011/11/27 means 2011/11/27 06h to 2011/11/28 05h)
*
* if the date is 2011/11/27 00:00:00, moveToDayJust() moves it to 2011/11/27 06:00:00
* (means the date moves to just beginning of 2011/11/27)
*
* @param dayBeginHour The date that has the hour of day-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginDay_Hour(Date dayBeginHour) {
doBeginDay_Hour(dayBeginHour);
return this;
}
protected void doBeginDay_Hour(Date dayBeginHour) {
assertArgumentNotNull("dayBeginHour", dayBeginHour);
_dayBeginHour = new HandyDate(dayBeginHour).timeZone(getCalendarTimeZone()).getHour();
}
/**
* Begin day from the specified hour.
*
* e.g. beginDay_Hour(6)
* day is from 06h to 05h of next day
* (the 2011/11/27 means 2011/11/27 06h to 2011/11/28 05h)
*
* if the date is 2011/11/27 00:00:00, moveToDayJust() moves it to 2011/11/27 06:00:00
* (means the date moves to just beginning of 2011/11/27)
*
* @param dayBeginHour The day of day-begin.
* @return this. (NotNull)
*/
public HandyDate beginDay_Hour(int dayBeginHour) {
assertNotMinusNotOver("dayBeginHour", dayBeginHour, 23);
_dayBeginHour = dayBeginHour;
return this;
}
/**
* Begin day from the specified hour of previous day.
*
* e.g. beginDay_PreviousHour(22)
* day is from 22h of previous day to 21h of this day
* (the 2011/11/27 means 2011/11/26 22h to 2011/11/27 21h)
*
* if the date is 2011/11/27 00:00:00, moveToDayJust() moves it to 2011/11/26 22:00:00
* (means the date moves to just beginning of 2011/11/27)
*
* @param dayBeginHour The day of day-begin.
* @return this. (NotNull)
*/
public HandyDate beginDay_PreviousHour(int dayBeginHour) {
assertNotMinusNotOver("dayBeginHour", dayBeginHour, 23);
_dayBeginHour = -dayBeginHour; // to be minus
return this;
}
// -----------------------------------------------------
// Begin Week
// ----------
/**
* Begin week from the specified day of week.
*
* e.g. beginWeek_DayOfWeek(toLocalDate("2011/11/28")) *means Monday
* week starts Monday (the 2011/11/27 belongs the week, 2011/11/21 to 2011/11/27)
*
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/21
* (means the date moves to just beginning of week containing 2011/11/27)
*
* @param weekBeginDayOfWeek The local date that has the day of day-of-week-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek(LocalDate weekBeginDayOfWeek) {
doBeginWeek_DayOfWeek(toDate(weekBeginDayOfWeek));
return this;
}
/**
* Begin week from the specified day of week.
*
* e.g. beginWeek_DayOfWeek(toLocalDateTime("2011/11/28")) *means Monday
* week starts Monday (the 2011/11/27 belongs the week, 2011/11/21 to 2011/11/27)
*
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/21
* (means the date moves to just beginning of week containing 2011/11/27)
*
* @param weekBeginDayOfWeek The local date-time that has the day of day-of-week-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek(LocalDateTime weekBeginDayOfWeek) {
doBeginWeek_DayOfWeek(toDate(weekBeginDayOfWeek));
return this;
}
/**
* Begin week from the specified day of week.
*
* e.g. beginWeek_DayOfWeek(toDate("2011/11/28")) *means Monday
* week starts Monday (the 2011/11/27 belongs the week, 2011/11/21 to 2011/11/27)
*
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/21
* (means the date moves to just beginning of week containing 2011/11/27)
*
* @param weekBeginDayOfWeek The date that has the day of day-of-week-begin. (NotNull)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek(Date weekBeginDayOfWeek) {
doBeginWeek_DayOfWeek(weekBeginDayOfWeek);
return this;
}
protected void doBeginWeek_DayOfWeek(Date weekBeginDayOfWeek) {
assertArgumentNotNull("weekBeginDayOfWeek", weekBeginDayOfWeek);
_weekBeginDay = new HandyDate(weekBeginDayOfWeek).timeZone(getCalendarTimeZone()).getDayOfWeek();
}
/**
* Begin week from Sunday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/27
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek1st_Sunday() {
_weekBeginDay = Calendar.SUNDAY;
return this;
}
/**
* Begin week from Monday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/21
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek2nd_Monday() {
_weekBeginDay = Calendar.MONDAY;
return this;
}
/**
* Begin week from Tuesday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/22
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek3rd_Tuesday() {
_weekBeginDay = Calendar.TUESDAY;
return this;
}
/**
* Begin week from Wednesday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/23
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek4th_Wednesday() {
_weekBeginDay = Calendar.WEDNESDAY;
return this;
}
/**
* Begin week from Thursday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/24
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek5th_Thursday() {
_weekBeginDay = Calendar.THURSDAY;
return this;
}
/**
* Begin week from Friday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/25
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek6th_Friday() {
_weekBeginDay = Calendar.FRIDAY;
return this;
}
/**
* Begin week from Saturday.
* if the date is 2011/11/27 00:00:00, moveToWeekJust() moves it to 2011/11/26
* (means the date moves to just beginning of week containing 2011/11/27)
* @return this. (NotNull)
*/
public HandyDate beginWeek_DayOfWeek7th_Saturday() {
_weekBeginDay = Calendar.SATURDAY;
return this;
}
// ===================================================================================
// Get Date
// ========
/**
* Get created new local date that has the same time of this handy date.
* The conversion logic uses the TimeZone saved in calendar, might be null.
* @return The instance of local date. (NotNull)
*/
public LocalDate getLocalDate() {
return DfTypeUtil.toLocalDate(getDate(), getCalendarTimeZone());
}
/**
* Get created new local date-time that has the same time of this handy date.
* The conversion logic uses the TimeZone saved in calendar, might be null.
* @return The instance of local date-time. (NotNull)
*/
public LocalDateTime getLocalDateTime() {
return DfTypeUtil.toLocalDateTime(getDate(), getCalendarTimeZone());
}
/**
* Get created new date that has the same time of this handy date.
* @return The instance of date. (NotNull)
*/
public Date getDate() {
return new Date(_cal.getTimeInMillis());
}
/**
* Get created new time-stamp that has the same time of this handy date.
* @return The instance of time-stamp. (NotNull)
*/
public Timestamp getTimestamp() {
return new Timestamp(_cal.getTimeInMillis());
}
/**
* Get time-zone used in the handy-date.
* @return The instance of time-zone. (NullAllowed: when no time-zone)
*/
public TimeZone getTimeZone() {
return getCalendarTimeZone();
}
/**
* Get time-zone used in the handy-date.
* @return The instance of time-zone. (NullAllowed: when no time-zone)
*/
protected TimeZone getCalendarTimeZone() {
return _cal.getTimeZone();
}
// ===================================================================================
// Get Parts
// =========
public int getYear() {
final int year = _cal.get(Calendar.YEAR);
final int era = _cal.get(Calendar.ERA);
return era == GregorianCalendar.AD ? year : -year;
}
public Month getMonth() { // resolved zero origin headache
return Month.of(getMonthAsOneOrigin());
}
public int getMonthAsOneOrigin() { // resolved zero origin headache
return _cal.get(Calendar.MONTH) + 1;
}
public int getMonthAsZeroOrigin() { // for calendar
return _cal.get(Calendar.MONTH);
}
public int getDay() {
return _cal.get(Calendar.DAY_OF_MONTH);
}
public int getHour() {
return _cal.get(Calendar.HOUR_OF_DAY);
}
public int getMinute() {
return _cal.get(Calendar.MINUTE);
}
public int getSecond() {
return _cal.get(Calendar.SECOND);
}
public int getMillisecond() {
return _cal.get(Calendar.MILLISECOND);
}
public int getDayOfWeek() {
return _cal.get(Calendar.DAY_OF_WEEK);
}
public int getWeekOfMonth() {
return _cal.get(Calendar.WEEK_OF_MONTH);
}
public int getWeekOfYear() {
return _cal.get(Calendar.WEEK_OF_YEAR);
}
public int getFirstDayOfMonth() {
return _cal.getActualMinimum(Calendar.DAY_OF_MONTH);
}
public int getLastDayOfMonth() {
return _cal.getActualMaximum(Calendar.DAY_OF_MONTH);
}
// ===================================================================================
// To Display
// ==========
/**
* Convert to the display string of the date for the default time-zone.
* @param pattern The pattern of date, which can be used at {@link SimpleDateFormat}. (NotNull)
* @return The display string of the date. (NotNull)
*/
public String toDisp(String pattern) {
assertArgumentNotNull("pattern", pattern);
final Date date = _cal.getTime();
final DateFormat dateFormat = createDateFormat(pattern, getCalendarTimeZone(), null);
return dateFormat.format(date);
}
/**
* Convert to the display string of the date for the specified time-zone.
* @param pattern The pattern of date, which can be used at {@link SimpleDateFormat}. (NotNull)
* @param timeZone The time-zone to format the date. (NotNull)
* @return The display string of the date for the time-zone. (NotNull)
*/
public String toDisp(String pattern, TimeZone timeZone) {
assertArgumentNotNull("pattern", pattern);
assertArgumentNotNull("timeZone", timeZone);
final Date date = _cal.getTime();
final DateFormat dateFormat = createDateFormat(pattern, timeZone, null);
return dateFormat.format(date);
}
/**
* Convert to the display string of the date for the default time-zone.
* @param pattern The pattern of date, which can be used at {@link SimpleDateFormat}. (NotNull)
* @param locale The locale for formatting symbols. (NotNull)
* @return The display string of the date. (NotNull)
*/
public String toDisp(String pattern, Locale locale) {
assertArgumentNotNull("pattern", pattern);
assertArgumentNotNull("locale", locale);
final Date date = _cal.getTime();
final DateFormat dateFormat = createDateFormat(pattern, getCalendarTimeZone(), locale);
return dateFormat.format(date);
}
/**
* Convert to the display string of the date for the specified time-zone.
* @param pattern The pattern of date, which can be used at {@link SimpleDateFormat}. (NotNull)
* @param timeZone The time-zone to format the date. (NotNull)
* @param locale The locale for formatting symbols. (NotNull)
* @return The display string of the date for the time-zone. (NotNull)
*/
public String toDisp(String pattern, TimeZone timeZone, Locale locale) {
assertArgumentNotNull("pattern", pattern);
assertArgumentNotNull("timeZone", timeZone);
assertArgumentNotNull("locale", locale);
final Date date = _cal.getTime();
final DateFormat dateFormat = createDateFormat(pattern, timeZone, locale);
return dateFormat.format(date);
}
/**
* Create the data format for display methods.
* @param pattern The pattern of date, which can be used at {@link SimpleDateFormat}. (NotNull)
* @param timeZone The time-zone to format the date. (NullAllowed)
* @param locale The locale for formatting symbols. (NullAllowed)
* @return The new-created date format. (NotNull)
*/
protected DateFormat createDateFormat(String pattern, TimeZone timeZone, Locale locale) {
final SimpleDateFormat dateFormat = new SimpleDateFormat(pattern, chooseRealLocale(locale));
if (timeZone != null) { // basically true, calendar has default zone
dateFormat.setTimeZone(timeZone);
}
return dateFormat;
}
// ===================================================================================
// Basic Override
// ==============
@Override
public boolean equals(Object obj) {
if (obj instanceof HandyDate) {
final HandyDate date = (HandyDate) obj;
final String pattern = getBasicDispPattern();
return date.toDisp(pattern).equals(toDisp(pattern));
} else {
return false;
}
}
@Override
public int hashCode() {
return toDisp(getBasicDispPattern()).hashCode();
}
@Override
public String toString() {
return toDisp(getBasicDispPattern());
}
protected String getBasicDispPattern() {
final String prefix = isYear_BeforeChrist() ? "'BC'" : "";
return prefix + DfTypeUtil.SLASHED_TIMESTAMP_PATTERN;
}
// *clone() is very hard to use (final field problem)
/**
* Copy this date deeply. (original method)
* @return The copy instance of this date. (NotNull)
*/
public HandyDate deepCopy() {
final HandyDate cloned = createCopyInstance();
inheritBeginAttribute(cloned);
return cloned;
}
/**
* Create new instance for copy.
* @return The new instance of this date. (NotNull)
*/
protected HandyDate createCopyInstance() {
return createCopyInstance(getDate());
}
/**
* Create new instance for copy.
* @param date The local date for new instance. (NotNull)
* @return The new instance of this date. (NotNull)
*/
protected HandyDate createCopyInstance(LocalDate date) {
final HandyDate copy = new HandyDate(date, getCalendarTimeZone());
//inheritTimeZone(copy); already inherited
inheritBeginAttribute(copy);
return copy;
}
/**
* Create new instance for copy.
* @param date The local date-time for new instance. (NotNull)
* @return The new instance of this date. (NotNull)
*/
protected HandyDate createCopyInstance(LocalDateTime date) {
final HandyDate copy = new HandyDate(date, getCalendarTimeZone());
//inheritTimeZone(copy); already inherited
inheritBeginAttribute(copy);
return copy;
}
/**
* Create new instance for copy.
* @param date The date for new instance. (NotNull)
* @return The new instance of this date. (NotNull)
*/
protected HandyDate createCopyInstance(Date date) {
final HandyDate copy = new HandyDate(date);
inheritTimeZone(copy);
inheritBeginAttribute(copy);
return copy;
}
protected void inheritTimeZone(HandyDate copy) {
final TimeZone timeZone = getCalendarTimeZone();
if (timeZone != null) {
copy.timeZone(timeZone);
}
}
protected void inheritBeginAttribute(HandyDate cloned) {
cloned._yearBeginMonth = _yearBeginMonth;
cloned._monthBeginDay = _monthBeginDay;
cloned._dayBeginHour = _dayBeginHour;
cloned._weekBeginDay = _weekBeginDay;
}
// ===================================================================================
// Small Helper
// ============
protected LocalDate toLocalDate(Date date) {
return DfTypeUtil.toLocalDate(date, getCalendarTimeZone());
}
protected LocalDateTime toLocalDateTime(Date date) {
return DfTypeUtil.toLocalDateTime(date, getCalendarTimeZone());
}
protected Date toDate(LocalDate date) {
return DfTypeUtil.toDate(date, getCalendarTimeZone());
}
protected Date toDate(LocalDateTime date) {
return DfTypeUtil.toDate(date, getCalendarTimeZone());
}
protected Date[] toDateArray(LocalDate... dates) {
final Date[] utilDates = new Date[dates.length];
int index = 0;
for (LocalDate localDate : dates) {
utilDates[index] = toDate(localDate);
++index;
}
return utilDates;
}
protected Date[] toDateArray(LocalDateTime... dates) {
final Date[] utilDates = new Date[dates.length];
int index = 0;
for (LocalDateTime localDateTime : dates) {
utilDates[index] = toDate(localDateTime);
++index;
}
return utilDates;
}
protected HandyDate prepareCompareDate(LocalDate date) {
return createCopyInstance(date);
}
protected HandyDate prepareCompareDate(LocalDateTime date) {
return createCopyInstance(date);
}
protected HandyDate prepareCompareDate(Date date) {
return createCopyInstance(date);
}
// ===================================================================================
// Assert Helper
// =============
protected void assertArgumentNotNull(String name, Object value) {
if (value == null) {
String msg = "The argument '" + name + "' should not be null.";
throw new IllegalArgumentException(msg);
}
}
protected void assertNotMinusNotOver(String name, int value, int max) {
if (value < 0) {
String msg = "The argument '" + name + "' should not be minus: value=" + value;
throw new IllegalArgumentException(msg);
}
if (value > max) {
String msg = "The argument '" + name + "' should not be over: value=" + value + " max=" + max;
throw new IllegalArgumentException(msg);
}
}
protected void assertValidMonth(int month) {
if (month < 1 || month > 12) {
String msg = "The argument 'month' should be 1 to 12: " + month;
throw new IllegalArgumentException(msg);
}
}
protected void assertValidDay(int day) {
final int firstDayOfMonth = getFirstDayOfMonth();
final int lastDayOfMonth = getLastDayOfMonth();
if (day < firstDayOfMonth || day > lastDayOfMonth) {
String msg = "The argument 'day' should be " + firstDayOfMonth + " to " + lastDayOfMonth + ": " + day;
throw new IllegalArgumentException(msg);
}
}
protected void assertValidHour(int hour) {
// e.g. 26h allowed
//if (hour < 1 || hour > 12) {
// String msg = "The argument 'hour' should be 0 to 23: " + hour;
// throw new IllegalArgumentException(msg);
//}
}
protected void assertValidMinute(int minute) {
if (minute < 0 || minute > 59) {
String msg = "The argument 'minute' should be 0 to 59: " + minute;
throw new IllegalArgumentException(msg);
}
}
protected void assertValidSecond(int second) {
if (second < 0 || second > 59) {
String msg = "The argument 'second' should be 0 to 59: " + second;
throw new IllegalArgumentException(msg);
}
}
protected void assertValidMillisecond(int millisecond) {
if (millisecond < 0 || millisecond > 999) {
String msg = "The argument 'millisecond' should be 0 to 999: " + millisecond;
throw new IllegalArgumentException(msg);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy