CKTIS / Java
Creare un LocalDateTime e trovare il lunedì di una settimana ISO
Crea date e ore locali a partire da valori fissi, calcola il lunedì della stessa settimana ISO e scegli l’overload che restituisce il tipo desiderato.
Versione: Java SE 21
Sintassi
Java SE 21 — java.time
Static factories:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
The same three component overloads accept Month instead of int for month.
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
Instance methods on a LocalDate named date:
LocalDate date.with(TemporalAdjuster adjuster)
LocalDate date.with(TemporalField field, long newValue)
LocalDateTime date.atTime(int hour, int minute)
LocalDateTime date.atTime(int hour, int minute, int second)
LocalDateTime date.atTime(int hour, int minute, int second, int nanoOfSecond)
LocalDateTime date.atTime(LocalTime time)
OffsetDateTime date.atTime(OffsetTime time)
Common composition: date.with(DayOfWeek.MONDAY).atTime(9, 30)In java.time, il metodo factory statico LocalDate.of crea una data ISO a partire da anno, mese e giorno del mese. Il mese si indica con un numero da 1 a 12 oppure con un valore di Month, come Month.MARCH. Il metodo factory statico LocalDateTime.of accetta gli stessi componenti della data, più l’ora e i minuti; altri overload accettano anche i secondi e poi i nanosecondi. Secondi e nanosecondi omessi valgono zero. Un altro overload combina un LocalDate e un LocalTime esistenti.
Il metodo di istanza LocalDate.with non modifica la data originale: usa il valore restituito. In date.with(DayOfWeek.MONDAY), il valore dell’enumerazione funge da TemporalAdjuster e seleziona il lunedì della stessa settimana ISO (da lunedì a domenica), indipendentemente dalle impostazioni locali. Se la data è già un lunedì, il valore non cambia; altrimenti il risultato è precedente e può cadere in un altro mese o anno. L’overload with(TemporalField, long) imposta un campo a un valore numerico. Per ChronoField.DAY_OF_WEEK, 1 seleziona anch’esso il lunedì della stessa settimana ISO.
Il metodo di istanza LocalDate.atTime combina la data con un LocalTime oppure con i componenti dell’ora: ora e minuti, seguiti facoltativamente dai secondi e poi dai nanosecondi. I componenti omessi valgono zero. Con un LocalTime, date.atTime(time) produce lo stesso valore di LocalDateTime.of(date, time). L’overload con OffsetTime restituisce invece un OffsetDateTime e conserva lo scostamento da UTC.
I metodi of generano una DateTimeException se la data non è valida. Gli overload che accettano componenti orari numerici generano la stessa eccezione quando un componente è fuori intervallo, ad esempio se l’ora è 24. LocalDate e LocalDateTime sono immutabili. Un LocalDateTime non contiene né un fuso orario né uno scostamento da UTC, quindi da solo non identifica un istante.
Esempi
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;
public class Main {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2024, Month.MARCH, 1);
LocalDate monday = date.with(DayOfWeek.MONDAY);
LocalDateTime adjusted = monday.atTime(9, 30);
LocalDateTime direct = LocalDateTime.of(2024, 2, 26, 9, 30);
LocalDateTime combined = LocalDateTime.of(monday, LocalTime.of(9, 30));
System.out.println(date);
System.out.println(adjusted);
System.out.println(adjusted.equals(direct) && adjusted.equals(combined));
}
}Risultato
2024-03-01 2024-02-26T09:30 true
La data di partenza è venerdì `2024-03-01`. Il lunedì corrispondente, `2024-02-26`, cade nel mese precedente. Aggiungendo l’ora `09:30`, tutti e tre gli approcci producono valori `LocalDateTime` uguali, come indica `true`.
Lezioni correlate
- Java · Lezione 60 · Avanzato · Versione: 2