CKTIS / Java
Analizar, crear y formatear fechas y fechas con hora en Java
Crea fechas a partir de sus campos, analiza texto ISO o con un patrón propio y formatea fechas y horas sin asignarles una zona horaria.
Versión: Java SE 21
Sintaxis
Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter
Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.
Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTimeEn java.time, LocalDate representa solo una fecha ISO, mientras que LocalDateTime combina una fecha ISO con una hora local. Ninguno almacena una zona horaria ni un desfase respecto a UTC, ni identifica por sí solo un instante único. Ambos tipos son inmutables.
LocalDate.of(year, month, dayOfMonth) es un método de fábrica estático que acepta un número de mes del 1 al 12 o una constante Month. El método de fábrica estático LocalDateTime.of(date, time) combina un LocalDate y un LocalTime. Las sobrecargas que reciben campos aceptan un número de mes o un Month, requieren la hora y el minuto y permiten añadir el segundo y luego el nanosegundo. Si se omite el segundo o el nanosegundo, su valor es cero. Los campos no válidos, como el 29 de febrero de un año no bisiesto, provocan una DateTimeException.
El método estático LocalDate.parse(text) usa DateTimeFormatter.ISO_LOCAL_DATE, por ejemplo para 2024-02-29. La sobrecarga LocalDate.parse(text, formatter) usa el formateador indicado, por ejemplo con el patrón dd/MM/uuuu. Si el texto no se puede interpretar como fecha, se lanza DateTimeParseException. DateTimeFormatter.ofPattern usa SMART por defecto, lo que puede ajustar 29/02/2023 al 28 de febrero. Para rechazar estas fechas, usa ResolverStyle.STRICT y uuuu (año), no yyyy (año de la era).
Los métodos de instancia LocalDate.format(formatter) y LocalDateTime.format(formatter) devuelven un String con el formateador indicado sin modificar el valor. Si falta un campo obligatorio, como la hora que pide HH:mm al formatear un LocalDate, se lanza DateTimeException. LocalDate.toString() no recibe formateador y devuelve texto ISO-8601, como 2024-02-29. Los patrones distinguen mayúsculas de minúsculas: MM es el mes, mm el minuto y HH la hora en formato de 24 horas.
Ejemplos
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
DateTimeFormatter dateFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu", Locale.ROOT)
.withResolverStyle(ResolverStyle.STRICT);
DateTimeFormatter dateTimeFormat = DateTimeFormatter
.ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);
LocalDate date = LocalDate.of(2024, 2, 29);
LocalDate fromIso = LocalDate.parse("2024-02-29");
LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);
System.out.println(date.equals(fromIso) && date.equals(fromCustom));
System.out.println(date.toString());
System.out.println(date.format(dateFormat));
LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
System.out.println(dateTime.format(dateTimeFormat));
try {
LocalDate.parse("29/02/2023", dateFormat);
System.out.println("Unexpected success");
} catch (DateTimeParseException e) {
System.out.println("Invalid date rejected");
}
}
}Resultado
true 2024-02-29 29/02/2024 29/02/2024 09:05 Invalid date rejected
La primera línea confirma que ambos valores analizados son iguales a la fecha creada por el método de fábrica. Las tres siguientes muestran la fecha ISO, la fecha en formato personalizado y la fecha con hora. La última muestra que el análisis estricto rechaza el 29 de febrero de 2023.
Lecciones relacionadas
- Java · Lección 61 · Avanzado · Versión: 2