com.hazelcast.internal.util.TimeUtil Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2021, Hazelcast, Inc. 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 com.hazelcast.internal.util;
import java.util.concurrent.TimeUnit;
import static java.lang.String.format;
import static java.util.concurrent.TimeUnit.MILLISECONDS;
import static java.util.concurrent.TimeUnit.NANOSECONDS;
import static java.util.concurrent.TimeUnit.SECONDS;
/**
* Utility class for Time & unit conversions
*/
public final class TimeUtil {
private static final int MILLIS_PER_SECOND = 1000;
private static final int SECONDS_PER_MINUTE = 60;
private static final int MINUTES_PER_HOUR = 60;
private static final int HOURS_PER_DAY = 24;
private TimeUtil() {
}
/**
* Convert nanoseconds to milliseconds
* If conversion result is 0 and {@code nanos} was > 0, then 1 is returned.
*
* @param nanos The number of nanoseconds
* @return The millisecond representation of the input
*/
public static long convertNanosToMillis(long nanos) {
return timeInMsOrOneIfResultIsZero(nanos, NANOSECONDS);
}
/**
* Convert milliseconds to nanoseconds
*
* @param millis The number of milliseconds
* @return The nanoseconds representation of the input
*/
public static long convertMillisToNanos(long millis) {
return MILLISECONDS.toNanos(millis);
}
/**
* Convert time to milliseconds based on the given time unit.
* If conversion result is 0 and {@code time} was > 0, then 1 is returned.
*
* @param time The input time
* @param timeUnit The time unit to base the conversion on
* @return The millisecond representation of the input time
* @throws NullPointerException if time unit is null
*/
public static long timeInMsOrOneIfResultIsZero(long time, TimeUnit timeUnit) {
long timeInMillis = timeUnit.toMillis(time);
if (time > 0 && timeInMillis == 0) {
timeInMillis = 1;
}
return timeInMillis;
}
/**
* Convert time to milliseconds based on the given time unit.
* If time unit is null, then input time is treated as milliseconds.
*
* @param time The input time
* @param timeUnit The time unit to base the conversion on
* @return The millisecond representation of the time based on the unit, or the time
* itself if the unit is null
*/
public static long timeInMsOrTimeIfNullUnit(long time, TimeUnit timeUnit) {
return timeUnit != null ? timeUnit.toMillis(time) : time;
}
/**
* Cleans the milliseconds info from the timestamp
*
* @param timestamp The input timestamp
* @return The timestamp with the milliseconds field filled with zeros
*/
public static long zeroOutMs(long timestamp) {
return SECONDS.toMillis(MILLISECONDS.toSeconds(timestamp));
}
public static String toHumanReadableMillis(long givenMillis) {
long time = givenMillis;
long millis = time % MILLIS_PER_SECOND;
time /= MILLIS_PER_SECOND;
long seconds = time % SECONDS_PER_MINUTE;
time /= SECONDS_PER_MINUTE;
long minutes = time % MINUTES_PER_HOUR;
time /= MINUTES_PER_HOUR;
long hours = time % HOURS_PER_DAY;
time /= HOURS_PER_DAY;
long days = time;
return format("%02dd %02dh %02dm %02ds %02dms", days, hours, minutes, seconds, millis);
}
}