Laissez la bibliothèque Luxon prendre en charge la gestion de la date et de l'heure pour vos applications JavaScript.
Vous pouvez utiliser JavaScript pour créer des applications Web dynamiques et des applications qui s'exécutent dans d'autres environnements, y compris le bureau. De nombreuses applications doivent gérer les dates et les heures, des planificateurs et des applications de chat aux applications de réservation d'événements.
Luxon offre une alternative supérieure au JavaScript natif Date objet, avec des moyens plus conviviaux et fiables de gérer les opérations de date et d'heure.
Installer Luxon
Vous pouvez ajouter Luxon à votre application JavaScript de plusieurs manières, selon votre méthode préférée. Les deux méthodes les plus courantes consistent à utiliser npm pour installer la bibliothèque ou utiliser un lien CDN pour inclure la bibliothèque dans votre application.
Pour installer Luxon dans un projet Node.js, exécutez la commande npm suivante dans votre terminal :
npm install --save luxon
Utilisez la bibliothèque dans votre fichier JavaScript en exigeant luxon :
constante { DateHeure } = exiger("luxon");
Ce code utilise déstructuration d'objet pour importer le DateHeure classe de la bibliothèque Luxon et créez une nouvelle variable DateHeure faisant référence à cette classe.
Cela vous permet de créer des instances de dates et d'heures et d'effectuer des opérations telles que le formatage des dates pour l'affichage.
Alternativement, vous pouvez inclure Luxon dans votre application en utilisant un Lien CDN. Pour ce faire, ajoutez le balisage suivant à votre fichier HTML :
<scénariosrc=" https://cdn.jsdelivr.net/npm/[email protected]/build/global/luxon.min.js">scénario>
En utilisant cette approche, vous pouvez exécuter des scripts en utilisant Luxon dans le corps de votre HTML.
Caractéristiques de Luxon
Luxon fournit de nombreuses fonctionnalités, ce qui en fait un package précieux pour la gestion des dates et des heures dans les applications JavaScript.
Manipulation complète de la date et de l'heure
Luxon propose diverses méthodes pour créer, manipuler et récupérer des dates et des heures. Luxon simplifie les tâches telles que l'ajout ou la soustraction de durées, la définition de composants de date/heure spécifiques et l'exécution de calculs de temps relatifs.
Formatage et localisation
Les options de formatage de Luxon vous permettent d'afficher les dates et les heures dans de nombreux formats. Luxon prend en charge différents modèles de format et vous permet de définir des dates et des heures en fonction d'autres langues.
Prise en charge du fuseau horaire
Avec Luxon, vous pouvez travailler efficacement avec des dates et des heures dans différents fuseaux horaires. Luxon fournit des méthodes pour définir et convertir entre les fuseaux horaires.
Conception immuable
Luxon suit un modèle de conception immuable, garantissant que DateHeure les objets sont immuables. Cette approche de conception offre un comportement prévisible et cohérent lorsque vous travaillez avec des dates et des heures.
Documentation API complète
La documentation de l'API de Luxon est très détaillée, ce qui facilite l'exploration et la compréhension des méthodes, options et fonctionnalités disponibles.
La classe DateTime à Luxon
Le DateHeure classe en Luxon représente une date et une heure particulières. Il propose à la fois des méthodes de classe et d'instance qui vous permettent d'effectuer diverses tâches. Ces tâches incluent la création, l'analyse, la récupération, la modification et le formatage des dates et des heures.
Voici quelques-unes des différentes manières de créer une nouvelle instance de la classe Date Time dans Luxon :
- Le DateHeure.local() méthode:
Ce code crée une nouvelle instance DateTime en utilisant le DateHeure.local() méthode. La méthode prend sept arguments représentant les valeurs d'année, de mois, de jour, d'heure, de minute, de seconde et de milliseconde de la date et de l'heure que vous souhaitez créer.constante dt = DateHeure.local(2023, 5, 21, 1, 22, 37, 845); - Le DateHeure.fromJSDate() méthode:
Le code crée un nouveau Date JavaScript native instance et la transmet à DateHeure.fromJSDate() méthode. Cette méthode renvoie un objet DateTime représentant la même date et la même heure.constante maintenant = nouveauDate();
constante dt = DateTime.fromJSDate (maintenant); - Le DateTime.fromObject() méthode:
Ce bloc de code montre comment créer une nouvelle instance DateTime en utilisant le DateTime.fromObject() méthode. La méthode prend un objet avec des propriétés représentant les valeurs d'année, de mois, de jour, d'heure, de minute, de seconde et de milliseconde de la date et de l'heure que vous souhaitez créer.constante dt = DateHeure.fromObject({
année: 2023,
mois: 1,
jour: 1,
heure: 0,
minute:0,
deuxième: 0,
milliseconde: 0
}); - En utilisant le DateHeure.maintenant() méthode:
Ce bloc de code montre comment créer une nouvelle instance Date Time à l'aide de la DateHeure.maintenant() méthode. La méthode renvoie une nouvelle instance DateTime représentant la date et l'heure actuelles dans le fuseau horaire local.constante dt = DateHeure.maintenant();
Formatage des objets DateTime en chaînes
Luxon simplifie le formatage des DateHeure objets en chaînes représentant des dates et des heures spécifiques. Vous pouvez utiliser Luxon pour formater les dates et les heures de différentes manières.
ISO 8601
Le format ISO 8601 est largement utilisé pour la représentation normalisée de la date et de l'heure. Pour formater un DateHeure objet en tant que chaîne ISO 8601, utilisez la toISO() méthode:
constante maintenant = DateHeure.local();
console.log (now.toISO()); // 2023-05-21T15:20:07.936+01:00
Formats lisibles par l'homme
Luxon prend en charge les formats lisibles par l'homme que vous pouvez personnaliser pour les langues locales. Vous pouvez formater un DateHeure objet à une chaîne lisible par l'homme avec le toLocaleString() méthode:
constante maintenant = DateHeure.local();
console.log (now.toLocaleString()); // 5/21/2023
Formatage basé sur les jetons
Le formatage basé sur les jetons vous permet de formater la date et l'heure dans des chaînes personnalisées à l'aide d'espaces réservés appelés jetons. Pour formater un DateHeure objet à l'aide de jetons, utilisez le formater() méthode:
constante maintenant = DateHeure.local();
console.log (maintenant.toFormat("aaaa-MM-jj HH: mm: ss")); //2023-05-21 15:16:57
Dans l'exemple ci-dessus, la chaîne de format aaaa-MM-jj HH: mm: ss représente le format de sortie souhaité. Les jetons aaaa, MM, jj, HH, millimètre, et ss correspondent à l'année, au mois, au jour, à l'heure, à la minute et à la seconde de la DateHeure objet, respectivement.
Luxon vous permet d'effectuer une large gamme de représentations de date et d'heure en fournissant un ensemble complet de jetons.
Analyse et validation des dates et heures dans Luxon
Luxon fournit des méthodes robustes pour analyser et valider les dates et les heures. Ces fonctionnalités sont utiles pour des tâches telles que la validation des entrées utilisateur ou la conversion de représentations sous forme de chaînes de dates et d'heures en DateHeure objets.
La méthode fromFormat()
Le fromFormat() La méthode vous permet d'analyser une représentation sous forme de chaîne d'une date et d'une heure, et de la convertir en un DateHeure objet. Il prend deux arguments, la chaîne d'entrée et une chaîne de format spécifiant le format d'entrée.
Par exemple:
DateHeure.fromFormat("25 mai 2023", "LLLL jj aaaa")
Validation des dates et des heures avec la méthode isValid
Le est valable méthode vérifie si un DateHeure objet représente une date et une heure valides. Il revient vrai si l'objet est valide et FAUX sinon.
Ainsi:
constante invalidDate = DateTime.fromObject({ année: 2022, mois: 2, jour: 29 });
console.log (invalidDate.isValid); // FAUX
constante validDate = DateHeure.fromObject({ année: 2022, mois: 2, jour: 28 });
console.log (validDate.isValid); // vrai
Dans l'exemple, le premier DateHeure L'objet représente une date non valide car le 29 février 2022 n'est pas valide. La deuxième DateHeure l'objet représente une date valide du 28 février 2022.
Les fonctionnalités d'analyse et de validation de Luxon vous aident à gérer avec précision les dates et les heures, à valider les entrées et à fournir des représentations fiables des données de date et d'heure.
Alternatives à Luxon
Vous avez appris à créer, formater et valider des instances de date et d'heure avec Luxon. Ces conseils vous aideront lors de la création d'applications Web nécessitant une gestion de la date et de l'heure.
Vous pouvez également utiliser d'autres packages JavaScript pour gérer la date et l'heure dans vos applications Web, notamment Day.js et Date.fns. Ces forfaits ont leurs avantages et leurs inconvénients, et vous devez baser votre préférence sur vos besoins spécifiques.
