com.fizzed.crux.util.DateTimes Maven / Gradle / Ivy
The newest version!
/*
* Copyright 2019 Fizzed, Inc.
*
* 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.fizzed.crux.util;
import java.time.Instant;
import org.joda.time.DateTime;
import org.joda.time.DateTimeZone;
import org.joda.time.Duration;
public class DateTimes {
static public DateTime dateTime(Instant instant) {
if (instant == null) {
return null;
}
return new DateTime(instant.toEpochMilli(), DateTimeZone.UTC);
}
static public Instant javaInstant(DateTime dt) {
if (dt == null) {
return null;
}
return Instant.ofEpochMilli(dt.getMillis());
}
static public java.time.Duration javaDuration(Duration duration) {
if (duration == null) {
return null;
}
return java.time.Duration.ofMillis(duration.getMillis());
}
/**
* Returns now() in UTC.
* @return Now in UTC
*/
static public DateTime now() {
return DateTime.now(DateTimeZone.UTC);
}
/**
* Returns a new DateTime in UTC.
* @param dt
* @return
*/
static public DateTime utc(DateTime dt) {
if (dt == null || dt.getZone() == DateTimeZone.UTC) {
return dt;
}
return dt.withZone(DateTimeZone.UTC);
}
/**
* Tests equality (ignoring timezones).
* @param a
* @param b
* @return
*/
static public boolean equals(DateTime a, DateTime b) {
if (a == null && b == null) {
return true;
}
if (a == null || b == null) {
return false;
}
return a.getMillis() == b.getMillis();
}
/**
* Returns a if less than or equal to b, otherwise b.
* @param a
* @param b
* @return
*/
static public DateTime min(DateTime a, DateTime b) {
if (b == null) {
return a;
} else if (a == null) {
return b;
}
return a.isAfter(b) ? b : a;
}
/**
* Returns the minimum of all datetimes.
*
* @param dts
* @return
*/
static public DateTime min(DateTime... dts) {
if (dts == null) {
return null;
}
DateTime v = null;
for (DateTime dt : dts) {
v = min(v, dt);
}
return v;
}
/**
* Returns a if greater than or equal to b, otherwise b.
* @param a
* @param b
* @return
*/
static public DateTime max(DateTime a, DateTime b) {
if (b == null) {
return a;
} else if (a == null) {
return b;
}
return a.isBefore(b) ? b : a;
}
/**
* Returns the minimum of all datetimes.
*
* @param dts
* @return
*/
static public DateTime max(DateTime... dts) {
if (dts == null) {
return null;
}
DateTime v = null;
for (DateTime dt : dts) {
v = max(v, dt);
}
return v;
}
/**
* Is a value greater than b. If a is not null
* and b is null then this is true.
* @param a
* @param b
* @return
*/
static public boolean gt(DateTime a, DateTime b) {
if (a == null) {
// if a is null then even if b is null it can't be greater than
return false;
}
if (b == null) {
// if a is NOT null and b is then its greater than
return true;
}
return a.getMillis() > b.getMillis();
}
/**
* Is a value greater than or equal to b. Will
* still be true if both values are null OR if a is non-null and b is null.
* @param a
* @param b
* @return
*/
static public boolean gte(DateTime a, DateTime b) {
if (a == null) {
// if a is null and b is null then this is true
return b == null;
}
if (b == null) {
// if a is NOT null and b is then its greater than
return true;
}
return a.getMillis() >= b.getMillis();
}
/**
* Is a value less than b. If b is not null
* and a is null then this is true.
* @param a
* @param b
* @return
*/
static public boolean lt(DateTime a, DateTime b) {
if (b == null) {
// if a is null then even if b is null it can't be greater than
return false;
}
if (a == null) {
// if a is NOT null and b is then its greater than
return true;
}
return a.getMillis() < b.getMillis();
}
/**
* Is a value less than or equal to b. Will
* still be true if both values are null OR if a is non-null and b is null.
* @param a
* @param b
* @return
*/
static public boolean lte(DateTime a, DateTime b) {
if (b == null) {
// if a is null and b is null then this is true
return a == null;
}
if (a == null) {
// if a is NOT null and b is then its greater than
return true;
}
return a.getMillis() <= b.getMillis();
}
/**
* Calculates the age of a datetime from 'now'. Just like your birthday,
* if the datetime is in the past then you a positive duration will be returned,
* if in the future then negative. For example, if the datetime is April 1
* and 'now' is April 2, then the age will be a positive 1 day.
* @param dt The datetime to calculate the age of.
* @return
*/
static public TimeDuration age(DateTime dt) {
return age(dt, System.currentTimeMillis());
}
/**
* Calculates the age of a datetime against a reference epoch millis. If
* the datetime is on April 1 and the epochMillis is on April 2, then the
* age will be a positive 1 day.
* @param dt
* @param epochMillis
* @return
*/
static public TimeDuration age(DateTime dt, long epochMillis) {
if (dt == null) {
return null;
}
long ageMillis = epochMillis - dt.getMillis();
return TimeDuration.millis(ageMillis);
}
/**
* Whether datetime is within start and end datetimes. The min of start and
* end is detected so the ordering does not matter. By default, this method
* makes the start date INCLUSIVE and the end date EXCLUSIVE.
* @param dt The datetime to check
* @param start The start (or end) of the datetime range
* @param end The end (or start) of the datetime range
* @return True if within range, otherwise false.
*/
static public boolean within(DateTime dt, DateTime start, DateTime end) {
return within(dt, start, end, true, false);
}
/**
* Whether datetime is within start and end datetimes.The min of start and
* end is detected so the ordering does not matter. By default, this method
* makes the start date INCLUSIVE and the end date EXCLUSIVE/INCLUSIVE depending
* on what you pass in.
* @param dt The datetime to check
* @param start The start (or end) of the datetime range
* @param end The end (or start) of the datetime range
* @param endInclusive True if the end date is inclusive, otherwise exclusive.
* @return True if within range, otherwise false.
*/
static public boolean within(DateTime dt, DateTime start, DateTime end, boolean endInclusive) {
return within(dt, start, end, true, endInclusive);
}
/**
* Whether datetime is within start and end datetimes.The min of start and
* end is detected so the ordering does not matter.By default, this method
* makes the start date INCLUSIVE and the end date EXCLUSIVE/INCLUSIVE depending
* on what you pass in.
* @param dt The datetime to check
* @param start The start (or end) of the datetime range
* @param end The end (or start) of the datetime range
* @param startInclusive True if the start date is inclusive, otherwise exclusive.
* @param endInclusive True if the end date is inclusive, otherwise exclusive.
* @return True if within range, otherwise false.
*/
static public boolean within(DateTime dt, DateTime start, DateTime end, boolean startInclusive, boolean endInclusive) {
if (dt == null) {
return false;
}
// intelligentally pick start/end
final DateTime _start = min(start, end);
final DateTime _end = max(start, end);
if (startInclusive && lt(dt, _start)) {
return false;
}
if (!startInclusive && lte(dt, _start)) {
return false;
}
if (endInclusive && gt(dt, _end)) {
return false;
}
if (!endInclusive && gte(dt, _end)) {
return false;
}
return true;
}
/**
* Formats a string of "uptime" relative to NOW such as "6m 1s 467ms"
* @param dt
* @return
*/
static public String uptime(DateTime dt) {
if (dt == null) {
return null;
}
return JavaTimes.uptime(dt.getMillis());
}
static public String uptime(DateTime end, DateTime start) {
if (end == null || start == null) {
return null;
}
return JavaTimes.uptime(end.getMillis(), start.getMillis());
}
static public String uptime(Duration duration) {
if (duration == null) {
return null;
}
return JavaTimes.uptime(javaDuration(duration));
}
}© 2015 - 2024 Weber Informatics LLC | Privacy Policy