com.microsoft.applicationinsights.telemetry.Duration Maven / Gradle / Ivy
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.
package com.microsoft.applicationinsights.telemetry;
import java.util.Objects;
/**
* This class lets its users define an interval of time which can be defined in terms of days,
* hours, minutes, seconds and milliseconds.
*
* It has various constructors to let the user easily define an interval of time.
*/
public final class Duration {
private static final long SECONDS_IN_ONE_MINUTE = 60;
private static final long SECONDS_IN_ONE_HOUR = 3600;
private static final long SECONDS_IN_ONE_DAY = 86400;
private static final long MINUTES_IN_ONE_HOUR = 60;
private static final long HOURS_IN_ONE_DAY = 24;
private final long days;
private final int hours;
private final int minutes;
private final int seconds;
private final int milliseconds;
/**
* The interval is set by setting all the possible values.
*
* @param days Day(s).
* @param hours Hour(s) in range [-23, 23].
* @param minutes Minute(s) in range [-59, 59].
* @param seconds Second(s) in range [-59, 59].
* @param milliseconds Milliseconds in range [0, 999].
*/
public Duration(long days, int hours, int minutes, int seconds, int milliseconds) {
Preconditions.checkArgument(
hours >= -23 && hours <= 23, "hours argument should be in the [-23, 23] range");
Preconditions.checkArgument(
minutes >= -59 && minutes <= 59, "minutes argument should be in the [-59, 59] range");
Preconditions.checkArgument(
seconds >= -59 && seconds <= 59, "seconds argument should be in the [-59, 59] range");
Preconditions.checkArgument(
milliseconds >= 0 && milliseconds <= 999,
"milliseconds argument should be in the [0, 999] range");
this.days = days;
this.hours = hours;
this.minutes = minutes;
this.seconds = seconds;
this.milliseconds = milliseconds;
}
/**
* The duration is defined by milliseconds. The class will calculate the number of days, hours,
* minutes, seconds and milliseconds from that value.
*
* @param duration The duration in milliseconds.
*/
public Duration(long duration) {
milliseconds = (int) (duration % 1000);
long durationInSeconds = duration / 1000;
seconds = (int) (durationInSeconds % SECONDS_IN_ONE_MINUTE);
minutes = (int) ((durationInSeconds / SECONDS_IN_ONE_MINUTE) % MINUTES_IN_ONE_HOUR);
hours = (int) ((durationInSeconds / SECONDS_IN_ONE_HOUR) % HOURS_IN_ONE_DAY);
days = durationInSeconds / SECONDS_IN_ONE_DAY;
}
/** Gets the days part of the duration. */
public long getDays() {
return days;
}
/** Gets the hours part of the duration. */
public int getHours() {
return hours;
}
/** Gets the minutes part of the duration. */
public int getMinutes() {
return minutes;
}
/** Gets the seconds part of the duration. */
public int getSeconds() {
return seconds;
}
/** Gets the milliseconds part of the duration. */
public int getMilliseconds() {
return milliseconds;
}
/** Gets the total milliseconds of the duration. */
public long getTotalMilliseconds() {
return (days * SECONDS_IN_ONE_DAY * 1000L)
+ (hours * SECONDS_IN_ONE_HOUR * 1000L)
+ (minutes * SECONDS_IN_ONE_MINUTE * 1000L)
+ (seconds * 1000L)
+ milliseconds;
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
if (days != 0) {
sb.append(String.format("%02d.", days));
}
sb.append(String.format("%02d:%02d:%02d", hours, minutes, seconds));
if (milliseconds > 0) {
sb.append(String.format(".%03d0000", milliseconds));
}
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj == null || getClass() != obj.getClass()) {
return false;
}
Duration that = (Duration) obj;
return days == that.days
&& hours == that.hours
&& minutes == that.minutes
&& seconds == that.seconds
&& milliseconds == that.milliseconds;
}
@Override
public int hashCode() {
return Objects.hash(days, hours, minutes, seconds, milliseconds);
}
}