CKTIS / Java
Crear, sumar y convertir valores Duration
Crea una duración a partir de un número de minutos o de dos instantes, suma otra duración y consulta el total en minutos u horas.
Versión: Java SE 21
Sintaxis
import java.time.Duration;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalUnit;
// Static methods declared by Duration
public static Duration between(Temporal startInclusive, Temporal endExclusive)
public static Duration ofMinutes(long minutes)
// Instance methods declared by Duration
public Duration plus(Duration duration)
public Duration plus(long amountToAdd, TemporalUnit unit)
public long toHours()
public long toMinutes()En Java SE 21, java.time.Duration representa una duración inmutable con signo, no una fecha ni una hora del día. El método de fábrica estático Duration.ofMinutes(long minutes) crea una duración a partir de un número de minutos, que puede ser negativo. Cada minuto equivale exactamente a 60 segundos.
El método estático Duration.between(start, end) calcula la diferencia desde el inicio inclusivo hasta el final exclusivo. El resultado es negativo si el final precede al inicio. Ambos argumentos deben admitir la unidad SECONDS. Si tienen tipos distintos, el cálculo se basa en el tipo del primer argumento. Si no se puede obtener la diferencia en segundos, el método lanza DateTimeException.
Para dos valores Duration, a.plus(b) devuelve la suma sin modificar ninguno; guarda el valor devuelto si quieres usar la suma. La sobrecarga plus(long, TemporalUnit) recibe una cantidad y una unidad de duración exacta, como ChronoUnit.MINUTES. La excepción es ChronoUnit.DAYS, que cuenta 24 horas por día. Una unidad no admitida provoca UnsupportedTemporalTypeException. ofMinutes, between y ambas sobrecargas de plus lanzan ArithmeticException si el resultado queda fuera del rango de Duration.
toMinutes() y toHours() devuelven totales de tipo long, no componentes de minutos u horas. Dividen los segundos almacenados entre 60 o 3600, respectivamente, mediante división entera hacia cero y sin tener en cuenta el campo de nanosegundos. Para 95 minutos, los totales son 95 y 1, respectivamente, mientras que toMinutesPart() devuelve 35.
Ejemplos
import java.time.Duration;
import java.time.Instant;
public class Main {
public static void main(String[] args) {
Instant start = Instant.parse("2025-01-01T09:00:00Z");
Instant end = Instant.parse("2025-01-01T10:15:00Z");
Duration elapsed = Duration.between(start, end);
Duration extra = Duration.ofMinutes(20);
Duration total = elapsed.plus(extra);
System.out.println("elapsed.toMinutes() = " + elapsed.toMinutes());
System.out.println("total.toMinutes() = " + total.toMinutes());
System.out.println("total.toHours() = " + total.toHours());
}
}Resultado
elapsed.toMinutes() = 75 total.toMinutes() = 95 total.toHours() = 1
Entre los instantes fijados transcurren 75 minutos. Al sumar 20 minutos, se obtienen 95 minutos, es decir, 1 hora entera. `elapsed` sigue representando 75 minutos.
Lecciones relacionadas
- Java · Lección 68 · Básico · Versión: 2