CKTIS / Java
Tworzenie LocalDateTime i wyznaczanie poniedziałku tygodnia ISO
Twórz daty i czasy lokalne ze stałych danych, wyznaczaj poniedziałek tego samego tygodnia ISO i dobieraj przeciążenie, które zwraca potrzebny typ.
Wersja: Java SE 21
Składnia
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)W pakiecie java.time statyczna metoda LocalDate.of tworzy datę ISO z roku, miesiąca i dnia miesiąca. Miesiąc podaje się jako liczbę od 1 do 12 albo wartość Month, np. Month.MARCH. Statyczna metoda LocalDateTime.of przyjmuje te same składniki daty oraz godzinę i minutę; kolejne przeciążenia przyjmują też sekundy, a następnie nanosekundy. Pominięte sekundy i nanosekundy mają wartość zero. Inne przeciążenie łączy gotowe LocalDate i LocalTime.
Metoda instancyjna LocalDate.with nie zmienia daty źródłowej: użyj zwróconej wartości. W date.with(DayOfWeek.MONDAY) wartość wyliczenia pełni rolę TemporalAdjuster: wynikiem jest poniedziałek tego samego tygodnia ISO (od poniedziałku do niedzieli), niezależnie od ustawień regionalnych. Jeśli data już przypada w poniedziałek, pozostaje taka sama; w przeciwnym razie wynik jest wcześniejszy i może wypaść w innym miesiącu lub roku. Przeciążenie with(TemporalField, long) służy do ustawiania pola na wartość liczbową. W przypadku ChronoField.DAY_OF_WEEK wartość 1 również oznacza poniedziałek tego samego tygodnia ISO.
Metoda instancyjna LocalDate.atTime łączy datę z obiektem LocalTime albo ze składnikami czasu: godziną i minutą, opcjonalnie także sekundami, a następnie nanosekundami. Pominięte składniki mają wartość zero. date.atTime(time) dla LocalTime daje tę samą wartość co LocalDateTime.of(date, time). Przeciążenie z OffsetTime zwraca natomiast OffsetDateTime i zachowuje przesunięcie względem UTC.
Fabryki of zgłaszają DateTimeException dla nieprawidłowej daty, a przeciążenia przyjmujące liczbowe składniki czasu zgłaszają ten wyjątek, gdy składnik jest poza zakresem (np. godzina 24). LocalDate i LocalDateTime są niemutowalne. LocalDateTime nie zawiera strefy czasowej ani przesunięcia względem UTC, więc sam nie wyznacza chwili na osi czasu.
Przykłady
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));
}
}Wynik
2024-03-01 2024-02-26T09:30 true
Data wejściowa to piątek `2024-03-01`. Poniedziałek wypada w poprzednim miesiącu, `2024-02-26`. Po dodaniu `09:30` wszystkie trzy sposoby dają równe wartości `LocalDateTime`, co potwierdza `true`.
Powiązane lekcje
- Java · Lekcja 60 · Zaawansowany · Wersja: 2