Java

Tutorial Java: LocalDate

Aprende a usar LocalDate en Java para gestionar fechas sin hora, manipular y comparar fechas con ejemplos prácticos y claros.

Aprende Java y certifícate

LocalDate

La clase LocalDate es una parte fundamental de la API java.time introducida en Java 8, diseñada específicamente para representar una fecha sin hora en el calendario ISO-8601. Esta clase inmutable ofrece una alternativa moderna y más robusta a las antiguas clases Date y Calendar, resolviendo muchas de sus limitaciones y problemas de diseño.

LocalDate almacena únicamente información de año, mes y día, sin incluir componentes de hora ni zona horaria. Esto la hace ideal para representar fechas como cumpleaños, aniversarios, fechas de vencimiento o cualquier otro concepto donde solo importa el día y no la hora exacta.

Creación de objetos LocalDate

Existen varias formas de crear instancias de LocalDate:

  • Fecha actual:
// Obtiene la fecha actual del sistema
LocalDate hoy = LocalDate.now();
System.out.println("Fecha actual: " + hoy); // Ejemplo: 2023-11-15
  • Fecha específica:
// Crear una fecha específica (año, mes, día)
LocalDate fechaEspecifica = LocalDate.of(2023, 12, 31);
System.out.println("Fecha específica: " + fechaEspecifica); // 2023-12-31

// Alternativa usando Month (enum)
LocalDate navidad = LocalDate.of(2023, Month.DECEMBER, 25);
System.out.println("Navidad: " + navidad); // 2023-12-25
  • Desde texto (parsing):
// Convertir texto a LocalDate
LocalDate fechaParseada = LocalDate.parse("2023-07-15");
System.out.println("Fecha parseada: " + fechaParseada); // 2023-07-15

// Con formato personalizado
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate fechaConFormato = LocalDate.parse("15/07/2023", formatter);
System.out.println("Fecha con formato: " + fechaConFormato); // 2023-07-15

Obtención de componentes de la fecha

LocalDate proporciona métodos para extraer los diferentes componentes de una fecha:

LocalDate fecha = LocalDate.of(2023, 11, 15);

// Obtener componentes individuales
int año = fecha.getYear();           // 2023
int mes = fecha.getMonthValue();     // 11
Month mesEnum = fecha.getMonth();    // NOVEMBER
int dia = fecha.getDayOfMonth();     // 15
DayOfWeek diaSemana = fecha.getDayOfWeek();  // WEDNESDAY
int diaDeLaSemana = fecha.getDayOfWeek().getValue(); // 3 (lunes=1, domingo=7)
int diaDelAño = fecha.getDayOfYear(); // 319

Manipulación de fechas

Una característica clave de LocalDate es su inmutabilidad, lo que significa que cada operación que modifica una fecha devuelve una nueva instancia. Esto evita efectos secundarios no deseados y facilita el trabajo con fechas en entornos concurrentes:

  • Sumar o restar períodos:
LocalDate fecha = LocalDate.of(2023, 11, 15);

// Sumar días, semanas, meses o años
LocalDate mañana = fecha.plusDays(1);
LocalDate siguienteSemana = fecha.plusWeeks(1);
LocalDate siguienteMes = fecha.plusMonths(1);
LocalDate siguienteAño = fecha.plusYears(1);

// Restar períodos
LocalDate ayer = fecha.minusDays(1);
LocalDate semanaAnterior = fecha.minusWeeks(1);
LocalDate mesAnterior = fecha.minusMonths(1);
LocalDate añoAnterior = fecha.minusYears(1);
  • Método plus/minus genérico:
// Usando Period para representar un intervalo de tiempo
Period periodo = Period.of(1, 2, 3); // 1 año, 2 meses, 3 días
LocalDate nuevaFecha = fecha.plus(periodo); // 2025-01-18

// Usando ChronoUnit para unidades específicas
LocalDate tresMesesDespues = fecha.plus(3, ChronoUnit.MONTHS); // 2024-02-15

Ajustadores de fechas

Los ajustadores temporales (TemporalAdjusters) permiten realizar operaciones más complejas sobre fechas:

LocalDate fecha = LocalDate.of(2023, 11, 15);

// Primer día del mes
LocalDate primerDia = fecha.with(TemporalAdjusters.firstDayOfMonth()); // 2023-11-01

// Último día del mes
LocalDate ultimoDia = fecha.with(TemporalAdjusters.lastDayOfMonth()); // 2023-11-30

// Próximo lunes
LocalDate proximoLunes = fecha.with(TemporalAdjusters.next(DayOfWeek.MONDAY)); // 2023-11-20

// Día específico del mes
LocalDate dia15 = fecha.withDayOfMonth(15); // 2023-11-15

// Cambiar mes y año
LocalDate navidad = fecha.withMonth(12).withDayOfMonth(25); // 2023-12-25

Comparación de fechas

LocalDate implementa la interfaz Comparable, lo que permite comparar fechas fácilmente:

LocalDate fecha1 = LocalDate.of(2023, 11, 15);
LocalDate fecha2 = LocalDate.of(2023, 12, 25);

// Comparación con métodos específicos
boolean esAntes = fecha1.isBefore(fecha2);      // true
boolean esDespues = fecha1.isAfter(fecha2);     // false
boolean esIgual = fecha1.isEqual(fecha2);       // false

// Comparación con compareTo
int resultado = fecha1.compareTo(fecha2);       // negativo (-1) porque fecha1 es anterior

Cálculo de períodos entre fechas

Para calcular la diferencia entre dos fechas, podemos usar Period o ChronoUnit:

LocalDate inicio = LocalDate.of(2023, 1, 1);
LocalDate fin = LocalDate.of(2023, 12, 31);

// Usando Period
Period periodo = Period.between(inicio, fin);
System.out.println("Período: " + periodo.getYears() + " años, " + 
                   periodo.getMonths() + " meses, " + 
                   periodo.getDays() + " días"); // 0 años, 11 meses, 30 días

// Usando ChronoUnit para unidades específicas
long dias = ChronoUnit.DAYS.between(inicio, fin);  // 364
long meses = ChronoUnit.MONTHS.between(inicio, fin); // 11
long años = ChronoUnit.YEARS.between(inicio, fin);  // 0

Verificación de fechas especiales

LocalDate proporciona métodos útiles para verificar características de una fecha:

LocalDate fecha = LocalDate.of(2024, 2, 29);

// Verificar si el año es bisiesto
boolean esBisiesto = fecha.isLeapYear(); // true para 2024

// Verificar longitud del mes
int diasEnMes = fecha.lengthOfMonth(); // 29 para febrero en año bisiesto
int diasEnAño = fecha.lengthOfYear();  // 366 para año bisiesto

Ejemplo práctico: Calculadora de edad

Un uso común de LocalDate es calcular la edad de una persona:

public static int calcularEdad(LocalDate fechaNacimiento) {
    LocalDate hoy = LocalDate.now();
    return (int) ChronoUnit.YEARS.between(fechaNacimiento, hoy);
}

// Uso
LocalDate fechaNacimiento = LocalDate.of(1990, 5, 15);
int edad = calcularEdad(fechaNacimiento);
System.out.println("Edad: " + edad + " años");

Ejemplo práctico: Verificar días laborables

Podemos usar LocalDate para determinar si una fecha es un día laborable:

public static boolean esDiaLaborable(LocalDate fecha) {
    // Asumimos que los días laborables son de lunes a viernes
    DayOfWeek diaSemana = fecha.getDayOfWeek();
    return diaSemana != DayOfWeek.SATURDAY && diaSemana != DayOfWeek.SUNDAY;
}

// Uso
LocalDate fecha = LocalDate.of(2023, 11, 15); // Miércoles
System.out.println("¿Es día laborable? " + esDiaLaborable(fecha)); // true

Ejemplo práctico: Calendario mensual

Podemos generar un calendario mensual simple utilizando LocalDate:

public static void imprimirCalendarioMensual(int año, int mes) {
    LocalDate fecha = LocalDate.of(año, mes, 1);
    int diasEnMes = fecha.lengthOfMonth();
    
    System.out.println("Calendario para " + fecha.getMonth() + " " + año);
    System.out.println("Lu Ma Mi Ju Vi Sa Do");
    
    // Ajustar el primer día de la semana (1 = lunes, ... 7 = domingo)
    int diaSemana = fecha.getDayOfWeek().getValue();
    
    // Imprimir espacios para alinear el primer día
    for (int i = 1; i < diaSemana; i++) {
        System.out.print("   ");
    }
    
    // Imprimir los días del mes
    for (int dia = 1; dia <= diasEnMes; dia++) {
        System.out.printf("%2d ", dia);
        
        // Salto de línea después del domingo
        if ((dia + diaSemana - 1) % 7 == 0 || dia == diasEnMes) {
            System.out.println();
        }
    }
}

// Uso
imprimirCalendarioMensual(2023, 11);

CONSTRUYE TU CARRERA EN IA Y PROGRAMACIÓN SOFTWARE

Accede a +1000 lecciones y cursos con certificado. Mejora tu portfolio con certificados de superación para tu CV.

30 % DE DESCUENTO

Plan mensual

19.00 /mes

13.30 € /mes

Precio normal mensual: 19 €
63 % DE DESCUENTO

Plan anual

10.00 /mes

7.00 € /mes

Ahorras 144 € al año
Precio normal anual: 120 €
Aprende Java online

Ejercicios de esta lección LocalDate

Evalúa tus conocimientos de esta lección LocalDate con nuestros retos de programación de tipo Test, Puzzle, Código y Proyecto con VSCode, guiados por IA.

Streams: match

Test

Gestión de errores y excepciones

Código

CRUD en Java de modelo Customer sobre un ArrayList

Proyecto

Clases abstractas

Test

Listas

Código

Métodos de la clase String

Código

Streams: reduce()

Test

API java.nio 2

Puzzle

Polimorfismo

Código

Pattern Matching

Código

Streams: flatMap()

Test

Llamada y sobrecarga de funciones

Puzzle

Métodos referenciados

Test

Métodos de la clase String

Código

Representación de Fecha

Puzzle

Operadores lógicos

Test

Inferencia de tipos con var

Código

Tipos de datos

Código

Estructuras de iteración

Puzzle

Streams: forEach()

Test

Objetos

Puzzle

Funciones lambda

Test

Uso de Scanner

Puzzle

Tipos de variables

Puzzle

Streams: collect()

Puzzle

Operadores aritméticos

Puzzle

Arrays y matrices

Código

Clases y objetos

Código

Interfaz funcional Consumer

Test

CRUD en Java de modelo Customer sobre un HashMap

Proyecto

Interfaces

Código

Enumeraciones Enums

Código

API Optional

Test

Interfaz funcional Function

Test

Encapsulación

Test

Interfaces

Código

Uso de API Optional

Puzzle

Representación de Hora

Test

Herencia básica

Test

Clases y objetos

Código

Interfaz funcional Supplier

Puzzle

HashMap

Puzzle

Sobrecarga de métodos

Test

Polimorfismo de tiempo de ejecución

Puzzle

OOP en Java

Proyecto

Sobrecarga de métodos

Código

CRUD de productos en Java

Proyecto

Clases sealed

Código

Creación de Streams

Test

Records

Código

Encapsulación

Código

Streams: min max

Puzzle

Herencia

Código

Métodos avanzados de la clase String

Puzzle

Funciones

Código

Polimorfismo de tiempo de compilación

Test

Reto sintaxis Java

Proyecto

Conjuntos

Código

Estructuras de control

Código

Recursión

Código

Excepciones

Puzzle

Herencia avanzada

Puzzle

Estructuras de selección

Test

Uso de interfaces

Test

Operadores

Código

Variables

Código

HashSet

Test

Objeto Scanner

Test

Streams: filter()

Puzzle

Operaciones de Streams

Puzzle

Interfaz funcional Predicate

Puzzle

Streams: sorted()

Test

Configuración de entorno

Test

Uso de variables

Test

Clases

Test

Streams: distinct()

Puzzle

Streams: count()

Test

ArrayList

Test

Mapas

Código

Datos de referencia

Test

Interfaces funcionales

Puzzle

Métodos básicos de la clase String

Test

Tipos de datos

Código

Clases abstractas

Código

Instalación

Test

Funciones

Código

Excepciones

Código

Estructuras de control

Código

Herencia de clases

Código

La clase Scanner

Código

Generics

Código

Streams: map()

Puzzle

Funciones y encapsulamiento

Test

Todas las lecciones de Java

Accede a todas las lecciones de Java y aprende con ejemplos prácticos de código y ejercicios de programación con IDE web sin instalar nada.

Instalación De Java

Introducción Y Entorno

Configuración De Entorno Java

Introducción Y Entorno

Tipos De Datos

Sintaxis

Variables

Sintaxis

Operadores

Sintaxis

Estructuras De Control

Sintaxis

Funciones

Sintaxis

Recursión

Sintaxis

Arrays Y Matrices

Sintaxis

Excepciones

Programación Orientada A Objetos

Clases Y Objetos

Programación Orientada A Objetos

Encapsulación

Programación Orientada A Objetos

Herencia

Programación Orientada A Objetos

Clases Abstractas

Programación Orientada A Objetos

Interfaces

Programación Orientada A Objetos

Sobrecarga De Métodos

Programación Orientada A Objetos

Polimorfismo

Programación Orientada A Objetos

La Clase Scanner

Programación Orientada A Objetos

Métodos De La Clase String

Programación Orientada A Objetos

Excepciones

Programación Orientada A Objetos

Records

Programación Orientada A Objetos

Pattern Matching

Programación Orientada A Objetos

Inferencia De Tipos Con Var

Programación Orientada A Objetos

Enumeraciones Enums

Programación Orientada A Objetos

Generics

Programación Orientada A Objetos

Clases Sealed

Programación Orientada A Objetos

Listas

Framework Collections

Conjuntos

Framework Collections

Mapas

Framework Collections

Funciones Lambda

Programación Funcional

Interfaz Funcional Consumer

Programación Funcional

Interfaz Funcional Predicate

Programación Funcional

Interfaz Funcional Supplier

Programación Funcional

Interfaz Funcional Function

Programación Funcional

Métodos Referenciados

Programación Funcional

Creación De Streams

Programación Funcional

Operaciones Intermedias Con Streams: Map()

Programación Funcional

Operaciones Intermedias Con Streams: Filter()

Programación Funcional

Operaciones Intermedias Con Streams: Distinct()

Programación Funcional

Operaciones Finales Con Streams: Collect()

Programación Funcional

Operaciones Finales Con Streams: Min Max

Programación Funcional

Operaciones Intermedias Con Streams: Flatmap()

Programación Funcional

Operaciones Intermedias Con Streams: Sorted()

Programación Funcional

Operaciones Finales Con Streams: Reduce()

Programación Funcional

Operaciones Finales Con Streams: Foreach()

Programación Funcional

Operaciones Finales Con Streams: Count()

Programación Funcional

Operaciones Finales Con Streams: Match

Programación Funcional

Api Optional

Programación Funcional

Transformación

Programación Funcional

Reducción Y Acumulación

Programación Funcional

Mapeo

Programación Funcional

Streams Paralelos

Programación Funcional

Agrupación Y Partición

Programación Funcional

Filtrado Y Búsqueda

Programación Funcional

Api Java.nio 2

Entrada Y Salida Io

Fundamentos De Io

Entrada Y Salida Io

Leer Y Escribir Archivos

Entrada Y Salida Io

Httpclient Moderno

Entrada Y Salida Io

Clases De Nio2

Entrada Y Salida Io

Api Java.time

Api Java.time

Localtime

Api Java.time

Localdatetime

Api Java.time

Localdate

Api Java.time

Executorservice

Concurrencia

Virtual Threads (Project Loom)

Concurrencia

Future Y Completablefuture

Concurrencia

Spring Framework

Frameworks Para Java

Micronaut

Frameworks Para Java

Maven

Frameworks Para Java

Gradle

Frameworks Para Java

Lombok Para Java

Frameworks Para Java

Quarkus

Frameworks Para Java

Ecosistema Jakarta Ee De Java

Frameworks Para Java

Introducción A Junit 5

Testing

Accede GRATIS a Java y certifícate

Certificados de superación de Java

Supera todos los ejercicios de programación del curso de Java y obtén certificados de superación para mejorar tu currículum y tu empleabilidad.

En esta lección

Objetivos de aprendizaje de esta lección

  • Comprender qué es LocalDate y su propósito en la API java.time.
  • Crear instancias de LocalDate mediante diferentes métodos.
  • Obtener y manipular componentes de fechas de forma inmutable.
  • Realizar comparaciones y cálculos entre fechas.
  • Aplicar LocalDate en ejemplos prácticos como cálculo de edad y generación de calendarios.