База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Създаване и изместване на локална дата и час

Създай локална дата и час с `LocalDateTime.of`, след което добави часове или минути, без да променяш първоначалната стойност.

Версия: Java SE 21

Синтаксис

import java.time.LocalDateTime;

LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);

// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.

java.time.LocalDateTime обединява календарна дата и час, какъвто виждаш на часовника. Не съхранява часова зона или отместване спрямо UTC и сам по себе си не определя конкретен момент. Изчисленията не отчитат преминаването между стандартно и лятно часово време.

В показания вариант статичният фабричен метод LocalDateTime.of(year, month, dayOfMonth, hour, minute) приема пет аргумента от тип int, като месеците са номерирани от 1 до 12. Методът задава нула в полетата за секунди и наносекунди. Други претоварени варианти позволяват да зададеш секунди и по желание наносекунди, да използваш константа от Month вместо номер на месеца или да съчетаеш LocalDate и LocalTime. При вариантите, които приемат отделни полета, невалидна дата или стойност на поле извън допустимия диапазон предизвиква DateTimeException.

Методите на екземпляра plusHours(long hours) и plusMinutes(long minutes) добавят съответно часове и минути. Отрицателна стойност измества датата и часа назад, а при преминаване през полунощ се променя и датата. Ако резултатът е извън поддържания диапазон от дати, се хвърля DateTimeException.

LocalDateTime е неизменяем: методите връщат резултата, без да променят обекта, върху който са извикани. Запази върнатата стойност или я използвай направо в следващото извикване, както в start.plusHours(1).plusMinutes(20).

Примери

import java.time.LocalDateTime;

public class LocalDateTimeDemo {
    public static void main(String[] args) {
        LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
        LocalDateTime afterHours = start.plusHours(1);
        LocalDateTime afterMinutes = afterHours.plusMinutes(20);

        System.out.println(start);
        System.out.println(afterHours);
        System.out.println(afterMinutes);
        System.out.println(start);
    }
}

Резултат

2026-04-30T22:50
2026-04-30T23:50
2026-05-01T00:10
2026-04-30T22:50

Добавянето на един час дава 23:50, а още 20 минути преместват резултата на 1 май в 00:10. Последният ред повтаря първоначалната дата и час. При отпечатване датата и часът са разделени със знака `T`, а полетата за секунди и наносекунди са пропуснати, защото са нулеви.

Свързани уроци

  • Java · Урок 68 · Начално · Версия: 2

Източници