Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes