Lăsați biblioteca Luxon să suporte sarcina de gestionare a datei și a orei pentru aplicațiile dvs. JavaScript.

Puteți utiliza JavaScript pentru a crea aplicații web dinamice și aplicații care rulează în alte medii, inclusiv desktop. Multe aplicații trebuie să gestioneze datele și orele, de la programatori și aplicații de chat până la aplicații de rezervare a evenimentelor.

Luxon oferă o alternativă superioară JavaScript-ului nativ Data obiect, cu modalități mai ușor de utilizat și mai fiabile de a gestiona operațiunile de dată și oră.

Instalarea Luxon

Puteți adăuga Luxon la aplicația JavaScript în mai multe moduri, în funcție de metoda preferată. Cele mai comune două metode sunt de a folosi npm pentru a instala biblioteca sau pentru a utiliza o legătură CDN pentru a include biblioteca în aplicația dvs.

Pentru a instala Luxon într-un proiect Node.js, rulați următoarea comandă npm în terminalul dvs.:

npm install --save luxon

Utilizați biblioteca din fișierul JavaScript, solicitând luxon:

const { DateTime } = cere("luxon");
instagram viewer

Acest cod folosește destructurarea obiectelor pentru a importa DateTime clasa din biblioteca Luxon și creați o nouă variabilă DateTime făcând referire la acea clasă.

Acest lucru vă permite să creați cazuri de date și ore și să efectuați operațiuni precum formatarea datelor pentru afișare.

Alternativ, puteți include Luxon în aplicația dvs. folosind un Legătura CDN. Pentru a face acest lucru, adăugați următorul marcaj în fișierul HTML:

<scenariusrc=" https://cdn.jsdelivr.net/npm/[email protected]/build/global/luxon.min.js">scenariu>

Folosind această abordare, puteți rula scripturi folosind Luxon în corpul HTML-ului dvs.

Caracteristicile Luxon

Luxon oferă multe caracteristici, ceea ce îl face un pachet valoros pentru gestionarea datelor și orelor în aplicațiile JavaScript.

Manipulare cuprinzătoare a datei și orei

Luxon oferă diverse metode pentru crearea, manipularea și preluarea datelor și orelor. Luxon simplifică sarcini precum adăugarea sau scăderea duratelor, setarea anumitor componente date/ora și efectuarea de calcule de timp relativ.

Formatare și localizare

Opțiunile de formatare ale Luxon vă permit să afișați datele și orele în mai multe formate. Luxon acceptă diferite modele de format și vă permite să setați datele și orele în funcție de alte limbi.

Suport pentru fus orar

Cu Luxon, puteți lucra eficient cu date și ore în diferite fusuri orare. Luxon oferă metode de setare și conversie între fusurile orare.

Design imuabil

Luxon urmează un model de design imuabil, asigurând acest lucru DateTime obiectele sunt imuabile. Această abordare de proiectare oferă un comportament previzibil și consecvent atunci când lucrați cu date și ore.

Documentație extinsă API

Documentația API-ului Luxon este foarte detaliată, facilitând explorarea și înțelegerea metodelor, opțiunilor și funcționalității disponibile.

Clasa DateTime din Luxon

The DateTime clasa în Luxon reprezintă o anumită dată și oră. Oferă atât metode de clasă, cât și metode de instanță care vă permit să efectuați diverse sarcini. Aceste sarcini includ crearea, analizarea, preluarea, modificarea și formatarea datelor și orelor.

Iată câteva dintre modalitățile diferite de a crea o nouă instanță a clasei Date Time în Luxon:

  • The DateTime.local() metodă:
    const dt = DateTime.local(2023, 5, 21, 1, 22, 37, 845);
    Acest cod creează o nouă instanță DateTime folosind DateTime.local() metodă. Metoda ia șapte argumente reprezentând valorile anului, lunii, zilei, orei, minutului, secundei și milisecunde ale datei și orei pe care doriți să le creați.
  • The DateTime.fromJSDate() metodă:
    const acum = nouData();
    const dt = DateTime.fromJSDate (acum);
    Codul creează un nou Data nativă JavaScript instanță și o transmite către DateTime.fromJSDate() metodă. Metoda respectivă returnează un obiect DateTime reprezentând aceeași dată și oră.
  • The DateTime.fromObject() metodă:
    const dt = DateTime.fromObject({
     an: 2023,
     lună: 1,
     zi: 1,
     ora: 0,
     minut:0,
     al doilea: 0,
     milisecunda: 0
    });
    Acest bloc de cod arată cum să creați o nouă instanță DateTime folosind DateTime.fromObject() metodă. Metoda preia un obiect cu proprietăți care reprezintă anul, luna, ziua, ora, minutul, secunda și valorile milisecunde ale datei și orei pe care doriți să le creați.
  • Folosind DateTime.now() metodă:
    const dt = DateTime.now();
    Acest bloc de cod arată cum să creați o nouă instanță Date Time folosind DateTime.now() metodă. Metoda returnează o nouă instanță DateTime reprezentând data și ora curente în fusul orar local.

Formatarea obiectelor DateTime în șiruri

Luxon simplifică formatarea DateTime obiecte în șiruri de caractere reprezentând date și ore specifice. Puteți utiliza Luxon pentru a formata datele și orele în diferite metode.

ISO 8601

Formatul ISO 8601 este utilizat pe scară largă pentru reprezentarea standardizată a datei și orei. Pentru a formata a DateTime obiect ca șir ISO 8601, utilizați la ISO() metodă:

const acum = DateTime.local();
consolă.log (acum.toISO()); // 2023-05-21T15:20:07.936+01:00

Formate care pot fi citite de om

Luxon acceptă formate care pot fi citite de om pe care le puteți personaliza pentru limbile locale. Puteți formata a DateTime obiect la un șir care poate fi citit de om cu toLocaleString() metodă:

const acum = DateTime.local();
consolă.log (acum.toLocaleString()); // 5/21/2023

Formatare bazată pe token

Formatarea bazată pe jetoane vă permite să formatați data și ora în șiruri personalizate folosind substituenți numiti token-uri. Pentru a formata a DateTime obiect folosind jetoane, utilizați toFormat() metodă:

const acum = DateTime.local();
consolă.log (acum.toFormat(„aaaa-LL-zz HH: mm: ss”)); //2023-05-21 15:16:57

În exemplul de mai sus, șirul de format aaaa-LL-zz HH: mm: ss reprezintă formatul de ieșire dorit. Jetoanele aaaa, MM, dd, HH, mm, și ss corespund anului, lunii, zilei, orei, minutului și secundei DateTime obiect, respectiv.

Luxon vă permite să efectuați o gamă largă de reprezentări de dată și oră, oferind un set extins de jetoane.

Analizarea și validarea datelor și orelor în Luxon

Luxon oferă metode robuste pentru analizarea și validarea datelor și orelor. Aceste caracteristici sunt utile pentru activități precum validarea intrărilor utilizatorului sau conversia reprezentărilor șir de date și ore în DateTime obiecte.

Metoda fromFormat().

The din format() metoda vă permite să analizați o reprezentare șir a unei date și ore și să o convertiți în a DateTime obiect. Este nevoie de două argumente, șirul de intrare și un șir de format care specifică formatul de intrare.

De exemplu:

DateTime.fromFormat(„25 mai 2023”, „LLLL zz aaaa”)

Validarea datelor și orelor cu metoda isValid

The este valabil metoda verifică dacă a DateTime obiectul reprezintă o dată și o oră valide. Se întoarce Adevărat dacă obiectul este valabil şi fals in caz contrar.

Ca astfel:

const invalidDate = DateTime.fromObject({ an: 2022, lună: 2, zi: 29 });
consolă.log (invalidDate.isValid); // fals
const validDate = DateTime.fromObject({ an: 2022, lună: 2, zi: 28 });
consolă.log (validDate.isValid); // Adevărat

În exemplu, primul DateTime obiectul reprezintă o dată nevalidă, deoarece 29 februarie 2022 nu este validă. Al doilea DateTime obiectul reprezintă o dată valabilă de 28 februarie 2022.

Funcțiile de analizare și validare din Luxon vă ajută să gestionați cu precizie datele și orele, să validați intrările și să oferiți reprezentări fiabile ale datelor de dată și oră.

Alternative la Luxon

Ați învățat cum să creați, să formatați și să validați instanțe de dată și oră cu Luxon. Aceste sfaturi vă vor ajuta atunci când creați aplicații web care necesită gestionarea datei și a orei.

De asemenea, puteți utiliza alte pachete JavaScript pentru a realiza gestionarea datei și a orei în aplicațiile dvs. web, inclusiv Day.js și Date.fns. Aceste pachete au avantajele și dezavantajele lor și ar trebui să vă bazați preferințele pe nevoile dvs. specifice.