CKTIS / Java
Duration — tiempo transcurrido y diferencias entre instantes
java.time.Duration representa una cantidad de tiempo en segundos y nanosegundos. Duration.between calcula la diferencia entre objetos temporales compatibles; el resultado puede ser positivo, cero o negativo.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Duration.between(Temporal startInclusive, Temporal endExclusive)java.time.Duration representa una cantidad de tiempo inmutable y segura para usar en varios hilos, no una fecha ni un instante. Almacena segundos y una fracción de segundo expresada en nanosegundos. A diferencia de Period, que se basa en el calendario, un día en Duration siempre significa 24 horas, sin tener en cuenta los cambios del horario de verano.
Duration.between(startInclusive, endExclusive) calcula la diferencia desde el inicio incluido hasta el final excluido. Los argumentos deben admitir SECONDS; la precisión completa también requiere NANOS o NANO_OF_SECOND. Si los argumentos son de tipos distintos, el tipo del primero determina cómo se interpreta el segundo. Si el inicio es un LocalDateTime, el final puede ser un OffsetDateTime: se ignora su desfase con respecto a UTC. En el orden inverso, la llamada lanza DateTimeException porque LocalDateTime no tiene desfase con respecto a UTC. Los objetos incompatibles pueden provocar DateTimeException, y un desbordamiento provoca ArithmeticException.
El ejemplo usa valores fijos de Instant, por lo que no depende del reloj ni de la zona horaria predeterminada. El resultado PT1H30M45S significa 1 hora, 30 minutos y 45 segundos. toMinutes() devuelve el número total de minutos completos, es decir, 90, no el componente de minutos 30. En este ejemplo, invertir el orden de los argumentos da una duración negativa.
Ejemplos
import java.time.Duration;
import java.time.Instant;
public class Main {
public static void main(String[] args) {
Instant start = Instant.parse("2025-01-01T10:00:00Z");
Instant end = Instant.parse("2025-01-01T11:30:45Z");
Duration elapsed = Duration.between(start, end);
System.out.println(elapsed);
System.out.println(elapsed.toMinutes());
System.out.println(Duration.between(end, start).isNegative());
}
}Resultado
PT1H30M45S 90 true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.