How to Use LocalDateTime in Java: Syntax and Examples

Use LocalDateTime in Java to represent date and time without timezone information. You can create instances using methods like now() or of(), and manipulate them with methods such as plusDays() or minusHours().

Syntax

The LocalDateTime class is part of java.time package and represents date and time without timezone. You can create a LocalDateTime object using:

• LocalDateTime.now() - current date and time
• LocalDateTime.of(year, month, day, hour, minute, second) - specific date and time

It provides methods to add or subtract time units, and to get parts like year, month, day, hour, etc.

java

import java.time.LocalDateTime;

public class SyntaxExample {
    public static void main(String[] args) {
        // Current date and time
        LocalDateTime now = LocalDateTime.now();

        // Specific date and time: 2024-06-01 10:30:45
        LocalDateTime specific = LocalDateTime.of(2024, 6, 1, 10, 30, 45);

        System.out.println("Now: " + now);
        System.out.println("Specific: " + specific);
    }
}

Output

Now: 2024-06-01T10:30:45.123456789
Specific: 2024-06-01T10:30:45

Example

This example shows how to create a LocalDateTime object, add days and hours, and extract parts like year and minute.

java

import java.time.LocalDateTime;

public class LocalDateTimeExample {
    public static void main(String[] args) {
        // Create current date-time
        LocalDateTime dateTime = LocalDateTime.now();

        // Add 5 days and 3 hours
        LocalDateTime updated = dateTime.plusDays(5).plusHours(3);

        // Extract year and minute
        int year = updated.getYear();
        int minute = updated.getMinute();

        System.out.println("Original: " + dateTime);
        System.out.println("Updated: " + updated);
        System.out.println("Year: " + year);
        System.out.println("Minute: " + minute);
    }
}

Output

Original: 2024-06-01T10:30:45.123456789
Updated: 2024-06-06T13:30:45.123456789
Year: 2024
Minute: 30

Common Pitfalls

Common mistakes when using LocalDateTime include:

• Confusing LocalDateTime with ZonedDateTime which includes timezone.
• Using LocalDateTime.now() without specifying a timezone can lead to unexpected results if your system clock changes.
• Trying to format or parse LocalDateTime without a formatter can cause errors.

java

import java.time.LocalDateTime;
import java.time.ZonedDateTime;

public class PitfallExample {
    public static void main(String[] args) {
        // Wrong: Assuming LocalDateTime has timezone
        LocalDateTime localDateTime = LocalDateTime.now();
        // This will NOT print timezone info
        System.out.println("LocalDateTime: " + localDateTime);

        // Correct: Use ZonedDateTime for timezone
        ZonedDateTime zonedDateTime = ZonedDateTime.now();
        System.out.println("ZonedDateTime: " + zonedDateTime);
    }
}

Output

LocalDateTime: 2024-06-01T10:30:45.123456789
ZonedDateTime: 2024-06-01T10:30:45.123456789+02:00[Europe/Paris]

Quick Reference

Here is a quick summary of useful LocalDateTime methods:

Method	Description
now()	Gets current date and time from system clock
of(year, month, day, hour, minute, second)	Creates a specific date and time
plusDays(long days)	Adds days to the date-time
minusHours(long hours)	Subtracts hours from the date-time
getYear()	Gets the year part
getMonthValue()	Gets the month as number (1-12)
getDayOfMonth()	Gets the day of the month
getHour()	Gets the hour of the day
toString()	Converts to ISO-8601 string format

Key Takeaways

LocalDateTime represents date and time without timezone in Java.

Create instances using now() for current time or of() for specific date-time.

Use plusDays(), minusHours(), and similar methods to manipulate date-time.

LocalDateTime does not store timezone info; use ZonedDateTime if needed.

Always format or parse LocalDateTime with a DateTimeFormatter to avoid errors.