CKTIS / Java
Criar um LocalDateTime e encontrar a segunda-feira de uma semana ISO
Cria datas e horas locais a partir de valores fixos, calcula a segunda-feira da mesma semana ISO e escolhe a sobrecarga que devolve o tipo pretendido.
Versão: Java SE 21
Sintaxe
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)Em java.time, o método de fábrica estático LocalDate.of cria uma data ISO a partir do ano, do mês e do dia do mês. Indica o mês com um número de 1 a 12 ou um valor de Month, como Month.MARCH. O método de fábrica estático LocalDateTime.of recebe os mesmos componentes da data, mais a hora e os minutos; outras sobrecargas aceitam também os segundos e depois os nanossegundos. Os segundos e nanossegundos omitidos valem zero. Outra sobrecarga combina um LocalDate e um LocalTime existentes.
O método de instância LocalDate.with não altera a data original: usa o valor devolvido. Em date.with(DayOfWeek.MONDAY), o valor da enumeração funciona como TemporalAdjuster e seleciona a segunda-feira da mesma semana ISO (de segunda-feira a domingo), independentemente das definições regionais. Se a data já for uma segunda-feira, o valor mantém-se; caso contrário, o resultado é anterior e pode calhar noutro mês ou ano. A sobrecarga with(TemporalField, long) atribui um valor numérico a um campo. Para ChronoField.DAY_OF_WEEK, 1 também seleciona a segunda-feira da mesma semana ISO.
O método de instância LocalDate.atTime combina a data com um LocalTime ou com os componentes da hora: hora e minutos, seguidos opcionalmente de segundos e depois de nanossegundos. Os componentes omitidos valem zero. Com um LocalTime, date.atTime(time) produz o mesmo valor que LocalDateTime.of(date, time). A sobrecarga com OffsetTime devolve, por sua vez, um OffsetDateTime e preserva o desfasamento em relação a UTC.
Os métodos of lançam uma DateTimeException se a data for inválida. As sobrecargas que recebem componentes horários numéricos lançam a mesma exceção se algum componente estiver fora do intervalo permitido, por exemplo, se a hora for 24. LocalDate e LocalDateTime são imutáveis. Um LocalDateTime não contém fuso horário nem desfasamento em relação a UTC, pelo que não identifica por si só um instante.
Exemplos
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));
}
}Resultado
2024-03-01 2024-02-26T09:30 true
A entrada é a sexta-feira `2024-03-01`. A segunda-feira correspondente, `2024-02-26`, calha no mês anterior. Ao acrescentar a hora `09:30`, as três formas produzem valores `LocalDateTime` iguais, como mostra `true`.
Lições relacionadas
- Java · Lição 60 · Avançado · Versão: 2