Classe Java LocalDateTime, ses utilisations et ses méthodes utilitaires
Java a ajouté un nouveau LocalDateTime à Java 8 pour représenter la date et l'heure locales et gérer les opérations associées.
Il représente la date et l'heure à la fois les informations sans fuseau horaire.
La date et l'heure sont liées au fuseau horaire local dans lequel le code Java s'exécute.
Il est bon d'utiliser la classe LocalDateTime lorsque nous n'avons pas besoin de fuseau horaire avec la date et l'heure.
Il suit le système de calendrier standard ISO-8601 pour générer la date et l'heure sans fuseau horaire.
Il représente le format date-heure sous la forme 2022-03-14T17:28:13.048999208.
La classe LocalDateTime est une classe immuable. L'ajout de jours ou d'heures ne modifie pas l'objet d'origine mais renvoie plutôt une copie d'un nouvel objet date-heure local.
Cette classe ne stocke ni ne représente un fuseau horaire, à cette fin, Java fournit ZonedDateTime classe.
Voyons la syntaxe de cette classe.
Déclaration LocalDateTime
public final class LocalDateTime extends Object implements Temporal, TemporalAdjuster, ChronoLocalDateTime<LocalDate>, Serializable
points clés :
-
Il fait partie de java.time paquet.
-
Il a été ajouté dans Java 8.
-
Il est immuable et thread-safe.
-
Il représente la date et l'heure locales en Java.
-
Il se compose de la date et de l'heure dans un seul objet
-
Il n'inclut pas le fuseau horaire.
-
il suit le calendrier ISO-8601.
-
Il fournit des méthodes utilitaires pour que nous puissions effectuer toutes les opérations liées à la date et à l'heure.
-
Il étend Objet et implémente plusieurs interfaces, dont Temporal, TemporalAdjuster, ChronoLocalDateTime
et Serializable. -
La structure ou le format de l'instance localdatetime est : année-mois-jour(T)heures :minutes :secondes.nenosecondes .
Opérations possibles nous pouvons effectuer sur cet objet date-heure local.
- Créer la DateTime actuelle en Java
- Ajouter des années
- Ajouter des mois
- Ajouter des semaines
- Ajouter des jours
- Ajouter des heures
- Ajouter des minutes
- Ajouter des secondes
- Ajouter des nanosecondes
et bien d'autres.
Explorons ses méthodes et champs :
Modificateur et type | Description |
---|---|
statique LocalDateTime MAX | Il représente la valeur LocalDateTime maximale prise en charge :+999999999-12-31T23:59:59.999999999. |
statique LocalDateTime MIN | Il représente la valeur LocalDateTime minimale prise en charge :-999999999-01-01T00:00:00. |
Méthodes Java LocalDateTime
Ce sont les méthodes utiles de cette classe.
Méthode | Description |
---|---|
Ajustement temporelDans(Temporel temporel) | |
OffsetDateTime atOffset(ZoneOffset offset) | |
ZonedDateTime àZone(ZoneId zone) | |
int compareTo(ChronoLocalDateTime> autre) | |
booléen égal(Obj obj) | |
Format de chaîne (formateur DateTimeFormatter) | |
static LocalDateTime from(TemporalAccessor temporal) | |
int get(Champ Temporel) | |
entier getDayOfMonth() | |
GetDayOfWeek() | |
int getDayOfYear() | |
int getHeure() | |
long getLong(champ champ temporel) | |
int getMinute() | |
Mois getMonth() | |
int getMonthValue() | |
int getNano() | |
int getSecond() | |
int getYear() | |
int hashCode() | |
boolean isAfter(ChronoLocalDateTime> autre) | |
booléen isBefore(ChronoLocalDateTime> autre) | |
boolean isEqual(ChronoLocalDateTime> autre) | |
boolean isSupported (champ champ temporel) | |
booléen isSupported (unité TemporalUnit) | |
LocalDateTime minus(long amountToSubtract, TemporalUnit unit) | |
LocalDateTime moins (TemporalAmount amountToSubtract) | |
LocalDateTime minusDays (jours longs) | |
LocalDateTime minusHours (heures longues) | |
LocalDateTime minusMinutes(longues minutes) | |
LocalDateTime minusMonths(longs mois) | |
LocalDateTime moinsNanos(long nanos) | |
LocalDateTime moinsSeconds (longues secondes) | |
LocalDateTime minusWeeks (longues semaines) | |
LocalDateTime minusYears (années longues) | |
statique LocalDateTime maintenant() | |
LocalDateTime statique maintenant (Horloge) | |
LocalDateTime statique maintenant (zone ZoneId) | |
statique LocalDateTime of(int année, int mois, int dayOfMonth, int heure, int minute) | |
statique LocalDateTime of(int année, int mois, int dayOfMonth, int heure, int minute, int seconde) | |
statique LocalDateTime of(int année, int mois, int dayOfMonth, int heure, int minute, int seconde, int nanoOfSecond) | |
statique LocalDateTime of(int année, Mois mois, int jourDuMois, int heure, int minute) | |
statique LocalDateTime of(int année, Mois mois, int jourDuMois, int heure, int minute, int seconde) | |
statique LocalDateTime of(int année, Mois mois, int jourDuMois, int heure, int minute, int seconde, int nanoOfSecond) | |
LocalDateTime statique de (date LocalDate, heure LocalTime) | |
statique LocalDateTime ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset) | |
statique LocalDateTime ofInstant(instantané, zone ZoneId) | |
analyse statique LocalDateTime (texte CharSequence) | |
analyse statique LocalDateTime (texte CharSequence, formateur DateTimeFormatter) | |
LocalDateTime plus (montant long à ajouter, unité TemporalUnit) | |
LocalDateTime plus(TemporalAmount amountToAdd) | |
LocalDateTime plusDays(long days) | |
LocalDateTime plusHeures (heures longues) | |
LocalDateTime plusMinutes(longues minutes) | |
LocalDateTime plusMonths(longs mois) | |
LocalDateTime plusNanos(long nanos) | |
LocalDateTime plusSeconds(longues secondes) | |
LocalDateTime plusWeeks(longues semaines) | |
LocalDateTime plusYears (années longues) | |
| |
Plage de valeurs (champ TemporalField) | |
LocalDate àLocalDate() | |
HeureLocale àHeureLocale() | |
Chaîne versString() | |
LocalDateTime tronqué à (unité TemporalUnit) | |
long jusqu'à(Temporal endExclusive, TemporalUnit unit) | |
LocalDateTime avec (ajusteur TemporalAdjuster) | |
LocalDateTime avec (champ TemporalField, long newValue) | |
LocalDateTime withDayOfMonth(int dayOfMonth) | |
LocalDateTime withDayOfYear(int dayOfYear) | |
LocalDateTime withHeure(int heure) | |
LocalDateTime withMinute(int minute) | |
LocalDateTime withMonth(int month) | |
LocalDateTime withNano(int nanoOfSecond) | |
LocalDateTime withSecond(int second) | |
LocalDateTime withYear(int année) |