Tutorial Java: API java.time

Java proporciona una API robusta y completa para el manejo de fechas y horas, conocida como la API java.time. Esta API fue introducida en Java 8 para abordar las deficiencias de las clases anteriores, como java.util.Date y java.util.Calendar. La API java.time está basada en el proyecto Joda-Time, y tiene en cuenta las consideraciones modernas, como el soporte para husos horarios y ajustes de tiempo de verano.

Las clases más utilizadas de la API java.time son:

1. LocalDate: representa una fecha sin hora ni zona horaria.
2. LocalTime: representa una hora sin fecha ni zona horaria.
3. LocalDateTime: representa una fecha y hora sin zona horaria.
4. Instant: representa un instante en la línea del tiempo, normalmente utilizado para marcar eventos en aplicaciones.

Vamos a revisar en detalle cada uno de estos.

LocalDate

La clase LocalDate representa una fecha en el formato de año-mes-día (AAAA-MM-DD). Esta clase no tiene en cuenta la hora ni la zona horaria.

Un ejemplo de cómo utilizar LocalDate sería:

import java.time.LocalDate;

// Obtener la fecha actual
LocalDate hoy = LocalDate.now();
System.out.println("Fecha actual: " + hoy);

// Crear una fecha específica
LocalDate fechaEspecifica = LocalDate.of(2023, 07, 28);
System.out.println("Fecha específica: " + fechaEspecifica);

LocalTime

La clase LocalTime representa una hora en el formato de horas-minutos-segundos (HH:MM:SS). Esta clase no tiene en cuenta la fecha ni la zona horaria.

Un ejemplo de cómo utilizar LocalTime sería:

import java.time.LocalTime;

// Obtener la hora actual
LocalTime ahora = LocalTime.now();
System.out.println("Hora actual: " + ahora);

// Crear una hora específica
LocalTime horaEspecifica = LocalTime.of(10, 30);
System.out.println("Hora específica: " + horaEspecifica);

LocalDateTime

La clase LocalDateTime representa una combinación de fecha y hora. Esta clase no tiene en cuenta la zona horaria.

Un ejemplo de cómo utilizar LocalDateTime sería:

import java.time.LocalDateTime;

// Obtener la fecha y hora actual
LocalDateTime ahora = LocalDateTime.now();
System.out.println("Fecha y hora actual: " + ahora);

// Crear una fecha y hora específica
LocalDateTime fechaHoraEspecifica = LocalDateTime.of(2023, 07, 28, 10, 30);
System.out.println("Fecha y hora específica: " + fechaHoraEspecifica);

Instant

La clase Instant representa un instante en el tiempo, útil para registrar eventos o marcas de tiempo en aplicaciones.

Un ejemplo de cómo utilizar Instant sería:

import java.time.Instant;

// Obtener el instante actual
Instant ahora = Instant.now();
System.out.println("Instante actual: " + ahora);

Estas clases son inmutables y seguras para el uso en hilos (thread-safe), lo que las hace ideales para su uso en aplicaciones Java modernas y multi-hilo. También proporcionan una gran cantidad de métodos útiles para el manejo de fechas y horas, como la adición o sustracción de días, meses o años, la comparación de fechas y horas, la formateación y el análisis de cadenas de fechas y horas, entre otros.