Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/******************************************************************************
* Copyright 2009-2018 Exactpro (Exactpro Systems Limited)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
******************************************************************************/
package com.exactpro.sf.actions;
import com.exactpro.sf.actions.data.DateComponent;
import com.exactpro.sf.actions.data.DateModificator;
import com.exactpro.sf.aml.Description;
import com.exactpro.sf.common.util.EPSCommonException;
import com.exactpro.sf.configuration.ResourceAliases;
import com.exactpro.sf.scriptrunner.AbstractCaller;
import com.exactpro.sf.scriptrunner.utilitymanager.UtilityMethod;
import com.exactpro.sf.util.DateTimeUtility;
import org.jetbrains.annotations.NotNull;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.time.DayOfWeek;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.temporal.Temporal;
import java.util.Collection;
import java.util.Collections;
import java.util.EnumSet;
import java.util.List;
import java.util.Objects;
import java.util.Set;
import java.util.concurrent.TimeUnit;
import java.util.stream.Collectors;
import java.util.stream.Stream;
import static com.exactpro.sf.util.DateTimeUtility.toZonedDateTime;
/**
*
* @author dmitry.guriev
*
*/
@MatrixUtils
@ResourceAliases("DateUtil")
public class DateUtil extends AbstractCaller {
private static final Logger logger = LoggerFactory.getLogger(DateUtil.class);
private static final String DATE_COMPONENTS =
"
Y
Year" +
"
M
Month" +
"
D
Day";
private static final String TIME_COMPONENTS =
"
h
Hour" +
"
m
Minute" +
"
s
Second" +
"
ms
Millisecond" +
"
mc
Microsecond" +
"
ns
Nanosecond";
public static final String DATE_COMPONENTS_TABLE =
"
" +
"
" +
"
Field
Component" +
DATE_COMPONENTS +
"
" +
"
";
public static final String TIME_COMPONENTS_TABLE =
"
" +
"
" +
"
Field
Component" +
TIME_COMPONENTS +
"
" +
"
";
public static final String DATE_TIME_COMPONENTS_TABLE =
"
" +
"The following pattern fields are defined:" +
DATE_TIME_COMPONENTS_TABLE +
"The following pattern operators are defined:" +
"
" +
"
" +
"
Operator
Action" +
"
+
Add value to time field" +
"
-
Substract value from time field" +
"
=
Set time field to value" +
"
" +
"
" +
"Value should be an unsigned integer amount of time
" +
"For example, Y+1:M-2:D=3:h+4:m-5:s=6:ms=7 will modify 2017-05-30T14:00:23.439 to 2018-03-03T17:55:06.007 ";
public static final String OFFSET_ID_HELP =
"
Date and Time offset id
" +
"The following pattern formats are defined:" +
"
" +
"
" +
"
Format
" +
"
+h
" +
"
+hh
" +
"
+hh:mm
" +
"
-hh:mm
" +
"
+hhmm
" +
"
-hhmm
" +
"
+hh:mm:ss
" +
"
-hh:mm:ss
" +
"
+hhmmss
" +
"
-hhmmss
" +
"
" +
"
" +
"Thе ± means either a plus or a minus symbol. " +
"The maximum supported range is from +18:00 to -18:00 inclusive.
" +
"For example, +03:30 ";
private static final String WEEKEND_DAYS_OF_WEEK = "By default, weekends are SATURDAY and SUNDAY. If you want to specify custom weekends, please list them by comma. "
+ "The available days are SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY and SATURDAY. ";
private static final Set DEFAULT_WEEKENDS = Collections.unmodifiableSet(EnumSet.of(DayOfWeek.SATURDAY, DayOfWeek.SUNDAY));
@Description("Returns the current time in the UTC time zone Example: #{getTime()}")
@UtilityMethod
public LocalTime getTime() {
return DateTimeUtility.nowLocalTime();
}
@Description("Returns the current time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{getTime(modifyPattern)}")
@UtilityMethod
public LocalTime getTime(String modifyPattern) {
return toTime(getDateTime(modifyPattern));
}
@Description("Returns the current time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{getTimeByZoneId(modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalTime getTimeByZoneId(String modifyPattern, String timeZoneId) {
return toTime(getDateTimeByZoneId(modifyPattern, timeZoneId));
}
@Description("Returns the current date in the UTC time zone Example: #{getDate()}")
@UtilityMethod
public LocalDate getDate() {
return DateTimeUtility.nowLocalDate();
}
@Description("Returns the current date in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{getDate(modifyPattern)}")
@UtilityMethod
public LocalDate getDate(String modifyPattern) {
return toDate(getDateTime(modifyPattern));
}
@Description("Returns the current date in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{getDateByZoneId(modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDate getDateByZoneId(String modifyPattern, String timeZoneId) {
return toDate(getDateTimeByZoneId(modifyPattern, timeZoneId));
}
@Description("Returns the current date/time in the UTC time zone Example: #{getDateTime()}")
@UtilityMethod
public final LocalDateTime getDateTime() {
return DateTimeUtility.nowLocalDateTime();
}
@Description("Returns the current date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{getDateTime(modifyPattern)}")
@UtilityMethod
public final LocalDateTime getDateTime(String modifyPattern) {
return modifyDateTime(getDateTime(), modifyPattern);
}
@Description("Returns the current date/time in the UTC time zone modified according to a pattern "
+ "If modified date time is on weekend and skipWeekends is true then the next working in direction of modification will be returned"
+ MODIFY_HELP
+ "Example: #{getDateTime(modifyPattern, skipWeekends)}"
)
@UtilityMethod
public final LocalDateTime getDateTime(String modifyPattern, boolean skipWeekends) {
LocalDateTime nowDate = DateTimeUtility.nowLocalDateTime();
return modifyDateTime(nowDate, modifyPattern, skipWeekends);
}
@Description("Returns the current date/time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware). "
+ "If modified date time is on weekend and skipWeekends is true then the next working day in direction of modification will be returned"
+ MODIFY_HELP
+ "Example: #{getDateTimeByZoneId(modifyPattern, skipWeekends, timeZoneId)}"
)
@UtilityMethod
public final LocalDateTime getDateTimeByZoneId(String modifyPattern, boolean skipWeekends, String timeZoneId) {
ZoneId zoneId = ZoneId.of(timeZoneId);
LocalDateTime nowDate = LocalDateTime.now(zoneId);
nowDate = modifyDateTime(nowDate, modifyPattern, skipWeekends);
return ZonedDateTime.of(nowDate, zoneId).withZoneSameInstant(ZoneOffset.UTC).toLocalDateTime();
}
@Description("Returns provided datetime in the UTC time zone modified according to a pattern "
+ "If modified date time is on weekend and skipWeekends is true then the next working day in direction of modification will be returned"
+ MODIFY_HELP
+ "Example: #{modifyDateTime(dateTime, modifyPattern, skipWeekends)}"
)
@UtilityMethod
public final LocalDateTime modifyDateTime(LocalDateTime dateTime, String modifyPattern, boolean skipWeekends){
LocalDateTime modifiedDate = modifyTemporal(dateTime, modifyPattern);
if (skipWeekends) {
DayOfWeek dayOfWeek = modifiedDate.getDayOfWeek();
long currentMillis = DateTimeUtility.getMillisecond(dateTime);
long modifiedMillis = DateTimeUtility.getMillisecond(modifiedDate);
if(dayOfWeek == DayOfWeek.SATURDAY) {
int shift = modifiedMillis - currentMillis >= 0 ? 2 : -1;
return modifiedDate.plusDays(shift);
} else if(dayOfWeek == DayOfWeek.SUNDAY) {
int shift = modifiedMillis - currentMillis >= 0 ? 1 : -2;
return modifiedDate.plusDays(shift);
}
}
return modifiedDate;
}
@Description("Returns the date/time in UTC applying a time offset pattern to the current date/time in the specified time zone." + MODIFY_HELP + OFFSET_ID_HELP + "Example: #{getDateTimeByZoneId(modifyPattern, timeZoneId)}")
@UtilityMethod
public final LocalDateTime getDateTimeByZoneId(String modifyPattern, String timeZoneId) {
return DateTimeUtility.toLocalDateTime(modifyTemporal(DateTimeUtility.nowZonedDateTime(timeZoneId), modifyPattern));
}
@Description("Returns the current date/time in the UTC time zone modified according to a pattern (weekends are skipped during modification). "
+ WEEKEND_DAYS_OF_WEEK
+ MODIFY_HELP + "Example: #{getBusinessDateTime(\"modifyPattern\")} - default weekends. "
+ "#{getBusinessDateTime(\"modifyPattern\", \"SUNDAY\")} - custom weekends")
@UtilityMethod
public final LocalDateTime getBusinessDateTime(String modifyPattern, String... weekends) {
return modifyBusinessDateTime(getDateTime(), modifyPattern, weekends);
}
@Description("Returns the current date/time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware). Weekends are skipped during modification. "
+ WEEKEND_DAYS_OF_WEEK
+ MODIFY_HELP + "Example: #{getBusinessDateTimeByZoneId(\"modifyPattern\", \"timeZoneId\")} - default weekends. "
+ "#{getBusinessDateTimeByZoneId(\"modifyPattern\", \"timeZoneId\", \"SUNDAY\")} - custom weekends")
@UtilityMethod
public final LocalDateTime getBusinessDateTimeByZoneId(String modifyPattern, String timeZoneId, String... weekends) {
return modifyBusinessDateTimeByZoneId(getDateTime(), modifyPattern, timeZoneId, weekends);
}
@Description("Modifies provided date time in the UTC time zone modified according to a pattern (weekends are skipped during modification). "
+ WEEKEND_DAYS_OF_WEEK
+ MODIFY_HELP + "Usage: #{modifyBusinessDateTime(dateTime, \"modifyPattern\")} - default weekends. "
+ "#{modifyBusinessDateTime(dateTime, \"modifyPattern\", \"SUNDAY\")} - custom weekends")
@UtilityMethod
public final LocalDateTime modifyBusinessDateTime(LocalDateTime dateTime, String modifyPattern, String... weekends) {
return getBusinessDateTime(dateTime, modifyDateTime(dateTime, modifyPattern), weekends);
}
@Description("Modifies provided date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware). Weekends are skipped during modification. "
+ WEEKEND_DAYS_OF_WEEK
+ MODIFY_HELP + "Usage: #{modifyBusinessDateTimeByZoneId(dateTime, \"modifyPattern\", \"timeZoneId\")} - default weekends. "
+ "#{modifyBusinessDateTimeByZoneId(dateTime, \"modifyPattern\", \"timeZoneId\", \"SUNDAY\")} - custom weekends")
@UtilityMethod
public final LocalDateTime modifyBusinessDateTimeByZoneId(LocalDateTime dateTime, String modifyPattern, String timeZoneId, String... weekends) {
LocalDateTime originalConverted = ZonedDateTime.of(dateTime, ZoneOffset.UTC).withZoneSameInstant(ZoneId.of(timeZoneId)).toLocalDateTime();
LocalDateTime targetTimezoneZoneResult = getBusinessDateTime(originalConverted, modifyTemporal(originalConverted, modifyPattern), weekends);
return ZonedDateTime.of(targetTimezoneZoneResult, ZoneId.of(timeZoneId)).withZoneSameInstant(ZoneOffset.UTC).toLocalDateTime();
}
@Description("Converts epoch milliseconds to time in the UTC time zone Example: #{toTime(epochMillis)}")
@UtilityMethod
public LocalTime toTime(long epochMillis) {
return DateTimeUtility.toLocalTime(epochMillis);
}
@Description("Converts epoch milliseconds to time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toTime(epochMillis, modifyPattern)}")
@UtilityMethod
public LocalTime toTime(long epochMillis, String modifyPattern) {
return toTime(toDateTime(epochMillis, modifyPattern));
}
@Description("Converts epoch milliseconds to time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toTimeByZoneId(epochMillis, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalTime toTimeByZoneId(long epochMillis, String modifyPattern, String timeZoneId) {
ZonedDateTime time = DateTimeUtility.toZonedDateTime(epochMillis).withZoneSameInstant(ZoneId.of(timeZoneId));
time = modifyTemporal(time, modifyPattern);
return toTime(DateTimeUtility.toLocalDateTime(time));
}
@Description("Converts a string using format pattern to time in the UTC time zone." + FORMAT_HELP + "Example: #{toTime(source, formatPattern)}")
@UtilityMethod
public LocalTime toTime(String source, String formatPattern) {
return toTime(toDateTime(source, formatPattern));
}
@Description("Converts a string using format pattern to time in the UTC time zone modified according to a pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{toTime(source, formatPattern, modifyPattern)}")
@UtilityMethod
public LocalTime toTime(String source, String formatPattern, String modifyPattern) {
return toTime(toDateTime(source, formatPattern, modifyPattern));
}
@Description("Converts a string using format pattern to time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{toTimeByZoneId(source, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalTime toTimeByZoneId(String source, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(source, formatPattern);
return toTimeByZoneId(time, modifyPattern, timeZoneId);
}
@Description("Converts the date/time to time in the UTC time zone Example: #{toTime(dateTime)}")
@UtilityMethod
public LocalTime toTime(LocalDateTime dateTime) {
return DateTimeUtility.toLocalTime(dateTime);
}
@Description("Converts the date/time to time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toTime(dateTime, modifyPattern)}")
@UtilityMethod
public LocalTime toTime(LocalDateTime dateTime, String modifyPattern) {
return toTime(modifyDateTime(dateTime, modifyPattern));
}
@Description("Converts the date/time to time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toTimeByZoneId(dateTime, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalTime toTimeByZoneId(LocalDateTime dateTime, String modifyPattern, String timeZoneId) {
return toTime(modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId));
}
@Description("Converts epoch milliseconds to date in the UTC time zone Example: #{toDate(epochMillis)}")
@UtilityMethod
public LocalDate toDate(long epochMillis) {
return DateTimeUtility.toLocalDate(epochMillis);
}
@Description("Converts epoch milliseconds to date in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toDate(epochMillis, modifyPattern)}")
@UtilityMethod
public LocalDate toDate(long epochMillis, String modifyPattern) {
return toDate(toDateTime(epochMillis, modifyPattern));
}
@Description("Converts epoch milliseconds to date in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toDateByZoneId(epochMillis, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDate toDateByZoneId(long epochMillis, String modifyPattern, String timeZoneId) {
return toDate(toDateTimeByZoneId(epochMillis, modifyPattern, timeZoneId));
}
@Description("Converts a string using format pattern to date in the UTC time zone." + FORMAT_HELP + "Example: #{toDate(source, formatPattern)}")
@UtilityMethod
public LocalDate toDate(String source, String formatPattern) {
return toDate(toDateTime(source, formatPattern));
}
@Description("Converts a string using format pattern to date in the UTC time zone modified according to a pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{toDate(source, formatPattern, modifyPattern)}")
@UtilityMethod
public LocalDate toDate(String source, String formatPattern, String modifyPattern) {
return toDate(toDateTime(source, formatPattern, modifyPattern));
}
@Description("Converts a string using format pattern to date in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{toDateByZoneId(source, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDate toDateByZoneId(String source, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(source, formatPattern);
return toDateByZoneId(time, modifyPattern, timeZoneId);
}
@Description("Converts date/time to date in the UTC time zone Example: #{toDate(dateTime)}")
@UtilityMethod
public LocalDate toDate(LocalDateTime dateTime) {
return DateTimeUtility.toLocalDate(dateTime);
}
@Description("Converts date/time to date in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toDate(dateTime, modifyPattern)}")
@UtilityMethod
public LocalDate toDate(LocalDateTime dateTime, String modifyPattern) {
return toDate(modifyDateTime(dateTime, modifyPattern));
}
@Description("Converts date/time to date in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toDateByZoneId(dateTime, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDate toDateByZoneId(LocalDateTime dateTime, String modifyPattern, String timeZoneId) {
return toDate(modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId));
}
@Description("Converts epoch milliseconds to date/time in the UTC time zone Example: #{toDateTime(epochMillis)}")
@UtilityMethod
public LocalDateTime toDateTime(long epochMillis) {
return DateTimeUtility.toLocalDateTime(epochMillis);
}
@Description("Converts epoch milliseconds to date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toDateTime(epochMillis, modifyPattern)}")
@UtilityMethod
public LocalDateTime toDateTime(long epochMillis, String modifyPattern) {
return modifyDateTime(toDateTime(epochMillis), modifyPattern);
}
@Description("Converts epoch milliseconds to date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toDateTimeByZoneId(epochMillis, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime toDateTimeByZoneId(long epochMillis, String modifyPattern, String timeZoneId) {
ZonedDateTime time = toZonedDateTime(epochMillis).withZoneSameInstant(ZoneId.of(timeZoneId));
time = modifyTemporal(time, modifyPattern);
return DateTimeUtility.toLocalDateTime(time);
}
@Description("Converts a string using automatic format pattern detection to date/time in the UTC time zone "
+ "One of the following date/time pattern is defined:"
+ "
"
+ "
"
+ "
"
+ "
Pattern"
+ "
Date/time value"
+ "
"
+ "
yyyy-MM-dd HH:mm:ss.SSS Z"
+ "
2000-01-01 00:00:00.000 -0700"
+ "
"
+ "
yyyy-MM-dd HH:mm:ss.SSS"
+ "
2000-01-01 00:00:00.000"
+ "
"
+ "
yyyy-MM-dd HH:mm:ss"
+ "
2000-01-01 00:00:00"
+ "
"
+ "
yyyy-MM-dd HH:mm"
+ "
2000-01-01 00:00"
+ "
"
+ "
yyyy-MM-dd HH"
+ "
2000-01-01 00"
+ "
"
+ "
yyyy-MM-dd"
+ "
2000-01-01"
+ "
"
+ "
yyyy-MM"
+ "
2000-01"
+ "
"
+ "
yyyy"
+ "
2000"
+ "
"
+ "
"
+ "Example: #{toDateTime(source)}")
@UtilityMethod
public LocalDateTime toDateTime(String source) {
Objects.requireNonNull(source, "Date argument is null");
StringBuilder builder = new StringBuilder();
switch (source.length()) {
case 29:
builder.insert(0, " Z");
case 23:
builder.insert(0, ".SSS");
case 19:
builder.insert(0, ":ss");
case 16:
builder.insert(0, ":mm");
case 13:
builder.insert(0, " HH");
case 10:
builder.insert(0, "-dd");
case 7:
builder.insert(0, "-MM");
case 4:
builder.insert(0, "yyyy");
break;
default:
throw new IllegalArgumentException("Unsupported date format " + source);
}
try {
return toDateTime(source, builder.toString());
} catch (DateTimeParseException e) {
throw new IllegalArgumentException("Incorrect date value " + source, e);
}
}
@Description("Converts a string using format pattern to date/time in the UTC time zone." + FORMAT_HELP + "Example: #{toDateTime(source, formatPattern)}")
@UtilityMethod
public LocalDateTime toDateTime(String source, String formatPattern) {
int yearPos = formatPattern.lastIndexOf('y') + 1;
if (yearPos > 0 && formatPattern.length() > yearPos && !Character.isDigit(formatPattern.charAt(yearPos))) {
formatPattern = new StringBuilder(formatPattern).insert(yearPos, ' ').toString();
source = new StringBuilder(source).insert(yearPos, ' ').toString();
}
return DateTimeUtility.toLocalDateTime(DateTimeUtility.createFormatter(formatPattern).parse(source));
}
@Description("Converts a string using format pattern to date/time in the UTC time zone modified according to a pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{toDateTime(source, formatPattern, modifyPattern)}")
@UtilityMethod
public LocalDateTime toDateTime(String source, String formatPattern, String modifyPattern) {
return modifyDateTime(toDateTime(source, formatPattern), modifyPattern);
}
@Description("Converts a string using format pattern to date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{toDateTimeByZoneId(source, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime toDateTimeByZoneId(String source, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(source, formatPattern);
return modifyDateTimeByZoneId(time, modifyPattern, timeZoneId);
}
@Description("Converts time to date time in the UTC time zone Example: #{toDateTime(time)}")
@UtilityMethod
public LocalDateTime toDateTime(LocalTime time) {
return DateTimeUtility.toLocalDateTime(time);
}
@Description("Converts time to date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toDateTime(time, modifyPattern)}")
@UtilityMethod
public LocalDateTime toDateTime(LocalTime time, String modifyPattern) {
return modifyDateTime(toDateTime(time), modifyPattern);
}
@Description("Converts time to date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toDateTimeByZoneId(time, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime toDateTimeByZoneId(LocalTime time, String modifyPattern, String timeZoneId) {
return modifyDateTimeByZoneId(toDateTime(time), modifyPattern, timeZoneId);
}
@Description("Converts date to date/time in the UTC time zone Example: #{toDateTime(date)}")
@UtilityMethod
public LocalDateTime toDateTime(LocalDate date) {
return DateTimeUtility.toLocalDateTime(date);
}
@Description("Converts date to date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{toDateTime(date, modifyPattern)}")
@UtilityMethod
public LocalDateTime toDateTime(LocalDate date, String modifyPattern) {
return modifyDateTime(toDateTime(date), modifyPattern);
}
@Description("Converts date to date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{toDateTimeByZoneId(date, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime toDateTimeByZoneId(LocalDate date, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(date);
return modifyDateTimeByZoneId(time, modifyPattern, timeZoneId);
}
@Description("Formats time in the UTC time zone into a string using format pattern." + FORMAT_HELP + "Example: #{formatTime(time, formatPattern)}")
@UtilityMethod
public String formatTime(LocalTime time, String formatPattern) {
return formatDateTime(toDateTime(time), formatPattern);
}
@Description("Formats time in the UTC time zone modified according to a pattern into a string using format pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatTime(time, formatPattern, modifyPattern)}")
@UtilityMethod
public String formatTime(LocalTime time, String formatPattern, String modifyPattern) {
return formatDateTime(toDateTime(time), formatPattern, modifyPattern);
}
@Description("Formats time in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatTimeByZoneId(time, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatTimeByZoneId(LocalTime time, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime dateTime = toDateTime(time);
dateTime = modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId);
return formatDateTimeByZoneId(dateTime, formatPattern, timeZoneId);
}
@Description("Formats date in the UTC time zone into a string using format pattern." + FORMAT_HELP + "Example: #{formatDate(date, formatPattern)}")
@UtilityMethod
public String formatDate(LocalDate date, String formatPattern) {
return formatDateTime(toDateTime(date), formatPattern);
}
@Description("Formats date in the UTC time zone modified according to a pattern into a string using format pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDate(date, formatPattern, modifyPattern)}")
@UtilityMethod
public String formatDate(LocalDate date, String formatPattern, String modifyPattern) {
return formatDateTime(toDateTime(date), formatPattern, modifyPattern);
}
@Description("Formats date in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateByZoneId(date, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatDateByZoneId(LocalDate date, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime dateTime = toDateTime(date);
dateTime = modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId);
return formatDateTimeByZoneId(dateTime, formatPattern, timeZoneId);
}
@Description("Formats date/time in the UTC time zone into a string using format pattern." + FORMAT_HELP + "Example: #{formatDateTime(dateTime, formatPattern)}")
@UtilityMethod
public String formatDateTime(LocalDateTime dateTime, String formatPattern) {
return formatTemporal(dateTime, formatPattern);
}
@Description("Formats date time in the UTC time zone modified according to a pattern into a string using format pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateTime(dateTime, formatPattern, modifyPattern)}")
@UtilityMethod
public String formatDateTime(LocalDateTime dateTime, String formatPattern, String modifyPattern) {
return formatTemporal(modifyDateTime(dateTime, modifyPattern), formatPattern);
}
@Description("Formats date time in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateTimeByZoneId(dateTime, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatDateTimeByZoneId(LocalDateTime dateTime, String formatPattern, String modifyPattern, String timeZoneId) {
dateTime = modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId);
return formatDateTimeByZoneId(dateTime, formatPattern, timeZoneId);
}
@Description("Merges date and time into date/time in the UTC time zone Example: #{mergeDateTime(date, time)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDate date, LocalTime time) {
return DateTimeUtility.toLocalDateTime(date, time);
}
@Description("Merges date and time into date time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{mergeDateTime(date, time, modifyPattern)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDate date, LocalTime time, String modifyPattern) {
return modifyDateTime(mergeDateTime(date, time), modifyPattern);
}
@Description("Merges date and time into date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{mergeDateTimeByZoneId(date, time, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime mergeDateTimeByZoneId(LocalDate date, LocalTime time, String modifyPattern, String timeZoneId) {
LocalDateTime localDateTime = mergeDateTime(date, time);
return modifyDateTimeByZoneId(localDateTime, modifyPattern, timeZoneId);
}
@Description("Merges date and date/time (only time is used) into date/time in the UTC time zone Example: #{mergeDateTime(date, dateTime)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDate date, LocalDateTime dateTime) {
return mergeDateTime(date, toTime(dateTime));
}
@Description("Merges date and date/time (only time is used) into date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{mergeDateTime(date, dateTime, modifyPattern)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDate date, LocalDateTime dateTime, String modifyPattern) {
return mergeDateTime(date, toTime(dateTime), modifyPattern);
}
@Description("Merges date and date time (only time is used) into date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{mergeDateTimeByZoneId(date, dateTime, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime mergeDateTimeByZoneId(LocalDate date, LocalDateTime dateTime, String modifyPattern, String timeZoneId) {
return mergeDateTimeByZoneId(date, dateTime.toLocalTime(), modifyPattern, timeZoneId);
}
@Description("Merges date/time (only date is used) and time into date/time in the UTC time zone Example: #{mergeDateTime(dateTime, time)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDateTime dateTime, LocalTime time) {
return mergeDateTime(toDate(dateTime), time);
}
@Description("Merges date/time (only date is used) and time into date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{mergeDateTime(dateTime, time, modifyPattern)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDateTime dateTime, LocalTime time, String modifyPattern) {
return mergeDateTime(toDate(dateTime), time, modifyPattern);
}
@Description("Merges date time (only date is used) and time into date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{mergeDateTimeByZoneId(dateTime, time, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime mergeDateTimeByZoneId(LocalDateTime dateTime, LocalTime time, String modifyPattern, String timeZoneId) {
return mergeDateTimeByZoneId(dateTime.toLocalDate(), time, modifyPattern, timeZoneId);
}
@Description("Merges date/time (only date is used) and date/time (only time is used) into date/time in the UTC time zone Example: #{mergeDateTime(firstDateTime, secondDateTime)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDateTime firstDateTime, LocalDateTime secondDateTime) {
return mergeDateTime(toDate(firstDateTime), toTime(secondDateTime));
}
@Description("Merges date/time (only date is used) and date/time (only time is used) into date/time in the UTC time zone modified according to a pattern." + MODIFY_HELP + "Example: #{mergeDateTime(firstDateTime, secondDateTime, modifyPattern)}")
@UtilityMethod
public LocalDateTime mergeDateTime(LocalDateTime firstDateTime, LocalDateTime secondDateTime, String modifyPattern) {
return mergeDateTime(toDate(firstDateTime), toTime(secondDateTime), modifyPattern);
}
@Description("Merges date time (only date is used) and date time (only time is used) into date time in the UTC time zone modified according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{mergeDateTimeByZoneId(firstDateTime, secondDateTime, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime mergeDateTimeByZoneId(LocalDateTime firstDateTime, LocalDateTime secondDateTime, String modifyPattern, String timeZoneId) {
return mergeDateTimeByZoneId(firstDateTime.toLocalDate(), secondDateTime.toLocalTime(), modifyPattern, timeZoneId);
}
@Description("Formats the current time in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatTimeByZoneId(formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatTimeByZoneId(String formatPattern, String modifyPattern, String timeZoneId) {
return formatTimeByZoneId(getTime(), formatPattern, modifyPattern, timeZoneId);
}
@Description("Formats the current date in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateByZoneId(formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatDateByZoneId(String formatPattern, String modifyPattern, String timeZoneId) {
return formatDateByZoneId(getDate(), formatPattern, modifyPattern, timeZoneId);
}
@Description("Formats the current date/time in the UTC time zone into a string using format pattern." + FORMAT_HELP + "Example: #{formatDateTime(formatPattern)}")
@UtilityMethod
public String formatDateTime(String formatPattern) {
return formatDateTime(getDateTime(), formatPattern);
}
@Description("Formats the current date/time in the UTC time zone modified according to a pattern into a string using format pattern." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateTime(formatPattern, modifyPattern)}")
@UtilityMethod
public String formatDateTime(String formatPattern, String modifyPattern) {
return formatDateTime(getDateTime(), formatPattern, modifyPattern);
}
@Description("Formats the current date time in the UTC time zone modified according to a pattern into a string using format pattern after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example: #{formatDateTimeByZoneId(formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String formatDateTimeByZoneId(String formatPattern, String modifyPattern, String timeZoneId) {
return formatDateTimeByZoneId(getDateTime(), formatPattern, modifyPattern, timeZoneId);
}
@Description("Modifies a date/time string using format and modify patterns." + FORMAT_HELP + MODIFY_HELP + "Example; #{modifyDateTime(source, formatPattern, modifyPattern)}")
@UtilityMethod
public String modifyDateTime(String source, String formatPattern, String modifyPattern) {
return formatDateTime(toDateTime(source, formatPattern, modifyPattern), formatPattern);
}
@Description("Modifies a date/time string using format and modify patterns after applying time zone offset (DST aware)." + FORMAT_HELP + MODIFY_HELP + "Example; #{modifyDateTimeByZoneId(source, formatPattern, modifyPattern, timeZoneId)}")
@UtilityMethod
public String modifyDateTimeByZoneId(String source, String formatPattern, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(source);
time = modifyDateTimeByZoneId(time, modifyPattern, timeZoneId);
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(formatPattern).withZone(ZoneId.of(timeZoneId));
return time.format(formatter);
}
@Description("Modifies time in the UTC time zone according to a pattern." + MODIFY_HELP + "Example: #{modifyTime(time, modifyPattern)}")
@UtilityMethod
public LocalTime modifyTime(LocalTime time, String modifyPattern) {
return toTime(toDateTime(time, modifyPattern));
}
@Description("Modifies time in the UTC time zone according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{modifyTimeByZoneId(time, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalTime modifyTimeByZoneId(LocalTime time, String modifyPattern, String timeZoneId) {
return toTime(modifyDateTimeByZoneId(toDateTime(time), modifyPattern, timeZoneId));
}
@Description("Modifies date in the UTC time zone according to a pattern." + MODIFY_HELP + "Example: #{modifyDate(date, modifyPattern)}")
@UtilityMethod
public LocalDate modifyDate(LocalDate date, String modifyPattern) {
return toDate(toDateTime(date, modifyPattern));
}
@Description("Modifies date in the UTC time zone according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{modifyDateByZoneId(date, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDate modifyDateByZoneId(LocalDate date, String modifyPattern, String timeZoneId) {
LocalDateTime time = toDateTime(date);
return toDate(modifyDateTimeByZoneId(time, modifyPattern, timeZoneId));
}
@Description("Modifies date/time in the UTC time zone according to a pattern." + MODIFY_HELP + "Example: #{modifyDateTime(dateTime, modifyPattern)}")
@UtilityMethod
public LocalDateTime modifyDateTime(LocalDateTime dateTime, String modifyPattern) {
return modifyTemporal(dateTime, modifyPattern);
}
@Description("Modifies date/time in the UTC time zone according to a pattern after applying time zone offset (DST aware)." + MODIFY_HELP + "Example: #{modifyDateTimeByZoneId(dateTime, modifyPattern, timeZoneId)}")
@UtilityMethod
public LocalDateTime modifyDateTimeByZoneId(LocalDateTime dateTime, String modifyPattern, String timeZoneId) {
LocalDateTime convertedToTargetZone = ZonedDateTime.of(dateTime, ZoneOffset.UTC)
.withZoneSameInstant(ZoneId.of(timeZoneId)).toLocalDateTime();
return ZonedDateTime.of(modifyTemporal(convertedToTargetZone, modifyPattern), ZoneId.of(timeZoneId))
.withZoneSameInstant(ZoneOffset.UTC).toLocalDateTime();
}
@Description("Returns the difference between minuend and subtrahend date/time in specified date component "
+ "The following date components are defined:"
+ DATE_TIME_COMPONENTS_TABLE
+ "Example: #{diffDateTime(minuend, subtrahend, dateComponent)}")
@UtilityMethod
public long diffDateTime(LocalDateTime minuend, LocalDateTime subtrahend, String dateComponent) {
Objects.requireNonNull(dateComponent, "datePart argument is null");
Objects.requireNonNull(minuend, "The first argument is null");
Objects.requireNonNull(subtrahend, "The second argument is null");
DateComponent enumDateComponent = DateComponent.parse(dateComponent);
if (enumDateComponent != null) {
return enumDateComponent.diff(minuend, subtrahend);
} else {
throw new IllegalArgumentException("Unsupported date component " + dateComponent);
}
}
@Description("Returns the difference between an ISO string minuend and subtrahend date/time in a specified date component "
+ "The following date components are defined:"
+ DATE_TIME_COMPONENTS_TABLE
+ "Example: #{diffDateTimeISO(minuend, subtrahend, dateComponent)}")
@UtilityMethod
public long diffDateTimeISO(String minuend, String subtrahend, String dateComponent) {
Objects.requireNonNull(dateComponent, "datePart argument is null");
Objects.requireNonNull(minuend, "The first argument is null");
Objects.requireNonNull(subtrahend, "The second argument is null");
return diffDateTime(DateTimeUtility.toLocalDateTime(ZonedDateTime.parse(minuend)),
DateTimeUtility.toLocalDateTime(ZonedDateTime.parse(subtrahend)), dateComponent);
}
@Description("Returns value of choose date component from LocalDate "
+ "The following date components are defined:"
+ DATE_COMPONENTS_TABLE
+ "Usage: #{getDateComponent(source, dateComponent)} "
+ "Example: #{getDateComponent(#{toDate(\"2018-08-15\", \"yyyy-MM-dd\")}, \"M\")} returns 8")
@UtilityMethod
public int getDateComponent(LocalDate source, String dateComponent) {
return getComponent(source, dateComponent);
}
@Description("Returns value of choose date component from LocalTime "
+ "The following date components are defined:"
+ TIME_COMPONENTS_TABLE
+ "Usage: #{getDateComponent(source, dateComponent)} "
+ "Example: #{getDateComponent(#{toTime(\"14:35:48.456\", \"HH:mm:ss.SSS\")}, \"ms\")} returns 456")
@UtilityMethod
public int getDateComponent(LocalTime source, String dateComponent) {
return getComponent(source, dateComponent);
}
@Description("Returns value of choose date component from LocalDateTime "
+ "The following date components are defined:"
+ DATE_TIME_COMPONENTS_TABLE
+ "Usage: #{getDateComponent(source, dateComponent)} "
+ "Example: #{getDateComponent(#{toDateTime(\"2018-08-15 14:35:48.456\")}, \"s\")} returns 48")
@UtilityMethod
public int getDateComponent(LocalDateTime source, String dateComponent) {
return getComponent(source, dateComponent);
}
@Description("Return UTC time in nanoseconds "
+ "Example: #{getUTCTimeNanosecond()}")
@UtilityMethod
public long getUTCTimeNanosecond() {
Instant inst = Instant.now();
long epochSecond = inst.getEpochSecond();
long nanos = TimeUnit.SECONDS.toNanos(epochSecond);
long epochNano = nanos + inst.getNano();
return epochNano;
}
/**
* Formats date/time in the UTC time zone into a string using format pattern after applying time zone offset (DST aware).
* @param dateTime LocalDateTime in UTC timeZone
* @param formatPattern Format pattern
* @param timeZoneId Target time zone offset
* @return
*/
@NotNull
private String formatDateTimeByZoneId(LocalDateTime dateTime, String formatPattern, String timeZoneId) {
return DateTimeFormatter
.ofPattern(formatPattern)
.withZone(ZoneId.of(timeZoneId))
.format(ZonedDateTime.of(dateTime, ZoneOffset.UTC));
}
private int getComponent(Temporal source, String dateComponent) {
Objects.requireNonNull(source, "source argument is null");
Objects.requireNonNull(dateComponent, "dataComponent parameter is null");
DateComponent component = DateComponent.parse(dateComponent);
if (component == null) {
throw new IllegalArgumentException("Unknown date component: " + dateComponent);
}
try {
return component.extract(source);
} catch (Exception ex) {
throw new EPSCommonException(String.format("Can't extract %s from %s [%s]", dateComponent, source, source.getClass().getSimpleName()), ex);
}
}
private String formatTemporal(Temporal source, String pattern) {
DateTimeFormatter formatter = DateTimeUtility.createFormatter(pattern);
return formatter.format(source);
}
private static Set parseWeekends(String[] weekends) {
if (weekends != null && weekends.length > 0) {
return Stream.of(weekends)
.map(String::toUpperCase)
.map(DayOfWeek::valueOf)
.collect(Collectors.collectingAndThen(Collectors.toSet(), Collections::unmodifiableSet));
}
return DEFAULT_WEEKENDS;
}
private LocalDateTime getBusinessDateTime(LocalDateTime original, LocalDateTime modified, String[] weekends) {
return getBusinessDateTime(original, modified, parseWeekends(weekends));
}
private LocalDateTime getBusinessDateTime(LocalDateTime original, LocalDateTime modified, Collection weekends) {
LocalDateTime after = DateTimeUtility.toLocalDateTime(modified);
LocalDateTime iter = DateTimeUtility.toLocalDateTime(original);
boolean past = false;
if (after.isBefore(iter)) {
past = true;
}
int counter = past ? -1 : 1;
while (past ? !iter.toLocalDate().isBefore(after.toLocalDate()) : !iter.toLocalDate().isAfter(after.toLocalDate())) {
DayOfWeek dayOfWeek = iter.getDayOfWeek();
if(weekends.contains(dayOfWeek)) {
after = after.plusDays(counter);
}
iter = iter.plusDays(counter);
if (logger.isDebugEnabled()) {
logger.debug("{} : {} {}", iter.isAfter(after), iter, after);
}
}
return after;
}
public static T modifyTemporal(T source, String modifyPattern) {
List modificators = DateModificator.parse(modifyPattern);
for (DateModificator dateModificator : modificators) {
source = dateModificator.modify(source);
}
return source;
}
public static LocalDateTime modifyLocalDateTime(String modifyPattern) {
return modifyTemporal(DateTimeUtility.nowLocalDateTime(), modifyPattern);
}
public static long getMilliseconds(LocalDateTime date) {
return DateTimeUtility.getMillisecond(date);
}
/**
*
* @param modifyPattern
* @param format
* @param timeZoneId
* @return
*/
public static final String formatDateTime(String modifyPattern, String format, String timeZoneId) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(format).withZone(ZoneId.of(timeZoneId));
return modifyZonedDateTime(modifyPattern).format(formatter);
}
public static final ZonedDateTime modifyZonedDateTime(String modifyPattern) {
ZonedDateTime zonedDateTime = ZonedDateTime.of(modifyTemporal(DateTimeUtility.nowLocalDateTime(), modifyPattern), ZoneOffset.UTC);
return zonedDateTime;
}
}
