mirror of
https://github.com/google/nomulus.git
synced 2025-04-30 20:17:51 +02:00
80 lines
3.2 KiB
Java
80 lines
3.2 KiB
Java
// Copyright 2017 The Nomulus Authors. All Rights Reserved.
|
|
//
|
|
// 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 google.registry.util;
|
|
|
|
import static com.google.common.base.Preconditions.checkArgument;
|
|
|
|
import com.google.common.collect.Iterables;
|
|
import com.google.common.collect.Lists;
|
|
import com.google.common.collect.Ordering;
|
|
import org.joda.time.DateTime;
|
|
import org.joda.time.DateTimeZone;
|
|
|
|
/** Utilities methods and constants related to Joda {@link DateTime} objects. */
|
|
public class DateTimeUtils {
|
|
|
|
/** The start of the epoch, in a convenient constant. */
|
|
public static final DateTime START_OF_TIME = new DateTime(0, DateTimeZone.UTC);
|
|
|
|
/**
|
|
* A date in the far future that we can treat as infinity.
|
|
*
|
|
* <p>This value is (2^63-1)/1000 rounded down. AppEngine stores dates as 64 bit microseconds, but
|
|
* Java uses milliseconds, so this is the largest representable date that will survive a
|
|
* round-trip through Datastore.
|
|
*/
|
|
public static final DateTime END_OF_TIME = new DateTime(Long.MAX_VALUE / 1000, DateTimeZone.UTC);
|
|
|
|
/** Returns the earliest of a number of given {@link DateTime} instances. */
|
|
public static DateTime earliestOf(DateTime first, DateTime... rest) {
|
|
return earliestOf(Lists.asList(first, rest));
|
|
}
|
|
|
|
/** Returns the earliest element in a {@link DateTime} iterable. */
|
|
public static DateTime earliestOf(Iterable<DateTime> dates) {
|
|
checkArgument(!Iterables.isEmpty(dates));
|
|
return Ordering.<DateTime>natural().min(dates);
|
|
}
|
|
|
|
/** Returns the latest of a number of given {@link DateTime} instances. */
|
|
public static DateTime latestOf(DateTime first, DateTime... rest) {
|
|
return latestOf(Lists.asList(first, rest));
|
|
}
|
|
|
|
/** Returns the latest element in a {@link DateTime} iterable. */
|
|
public static DateTime latestOf(Iterable<DateTime> dates) {
|
|
checkArgument(!Iterables.isEmpty(dates));
|
|
return Ordering.<DateTime>natural().max(dates);
|
|
}
|
|
|
|
/** Returns whether the first {@link DateTime} is equal to or earlier than the second. */
|
|
public static boolean isBeforeOrAt(DateTime timeToCheck, DateTime timeToCompareTo) {
|
|
return !timeToCheck.isAfter(timeToCompareTo);
|
|
}
|
|
|
|
/** Returns whether the first {@link DateTime} is equal to or later than the second. */
|
|
public static boolean isAtOrAfter(DateTime timeToCheck, DateTime timeToCompareTo) {
|
|
return !timeToCheck.isBefore(timeToCompareTo);
|
|
}
|
|
|
|
/**
|
|
* Adds years to a date, in the {@code Duration} sense of semantic years. Use this instead of
|
|
* {@link DateTime#plusYears} to ensure that we never end up on February 29.
|
|
*/
|
|
public static DateTime leapSafeAddYears(DateTime now, int years) {
|
|
checkArgument(years >= 0);
|
|
return years == 0 ? now : now.plusYears(1).plusYears(years - 1);
|
|
}
|
|
}
|