CKTIS / Java
TemporalAdjusters: próximo dia da semana e fim do mês
Aplique regras de calendário através de LocalDate.with(...). Distinga next de nextOrSame e encontre o último dia de um mês com lastDayOfMonth, sem alterar a data de entrada.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
date.with(TemporalAdjusters.next(dayOfWeek))
date.with(TemporalAdjusters.nextOrSame(dayOfWeek))
date.with(TemporalAdjusters.lastDayOfMonth())TemporalAdjusters disponibiliza fábricas estáticas de objetos TemporalAdjuster. Aplique uma regra através de date.with(...) e guarde o resultado: LocalDate é imutável, pelo que a data de entrada permanece inalterada.
TemporalAdjusters.next(dayOfWeek) seleciona o dia da semana indicado estritamente depois da data de entrada, avançando 1–7 dias. TemporalAdjusters.nextOrSame(dayOfWeek) inclui a data de entrada, avançando 0–6 dias. O argumento DayOfWeek não pode ser null; o resultado pode ocorrer no mês ou ano seguinte.
TemporalAdjusters.lastDayOfMonth() seleciona o último dia do mês da data de entrada, tendo em conta os anos bissextos. «Mês» refere-se ao dessa data, não ao relógio do sistema. LocalDate não contém hora nem fuso horário.
O exemplo usa a quinta-feira 2024-02-29: mostra a diferença entre next e nextOrSame, o fim de fevereiro num ano bissexto e que a data de entrada não é alterada.
Exemplos
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2024, 2, 29);
System.out.println(date.with(TemporalAdjusters.next(DayOfWeek.THURSDAY)));
System.out.println(date.with(TemporalAdjusters.nextOrSame(DayOfWeek.THURSDAY)));
System.out.println(date.with(TemporalAdjusters.lastDayOfMonth()));
System.out.println(date);
}
}Resultado
2024-03-07 2024-02-29 2024-02-29 2024-02-29
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.