La Luxon-biblioteket bære belastningen av dato- og klokkesletthåndtering for JavaScript-appene dine.

Du kan bruke JavaScript til å bygge dynamiske nettapplikasjoner og applikasjoner som kjører i andre miljøer, inkludert skrivebordet. Mange apper trenger å håndtere datoer og klokkeslett, fra planleggere og chatteapplikasjoner til apper for bestilling av arrangementer.

Luxon tilbyr et overlegent alternativ til det opprinnelige JavaScript Dato objekt, med mer brukervennlige, pålitelige måter å håndtere dato- og klokkeslettoperasjoner på.

Installerer Luxon

Du kan legge Luxon til JavaScript-appen din på flere måter, avhengig av hvilken metode du foretrekker. De to vanligste metodene er å bruke npm for å installere biblioteket eller bruke en CDN-kobling for å inkludere biblioteket i applikasjonen din.

For å installere Luxon i et Node.js-prosjekt, kjør følgende npm-kommando i terminalen din:

npm install --save luxon

Bruk biblioteket i JavaScript-filen din ved å kreve luxon:

konst { DateTime } = krever("luxon");

Denne koden bruker gjenstandsdestrukturering å importere Dato tid klasse fra Luxon-biblioteket og opprette en ny variabel Dato tid refererer til den klassen.

Dette lar deg lage forekomster av datoer og klokkeslett og utføre operasjoner som formatering av datoer for visning.

Alternativt kan du inkludere Luxon i søknaden din ved å bruke en CDN-lenke. For å gjøre dette, legg til følgende markering i HTML-filen din:

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

Ved å bruke denne tilnærmingen kan du kjøre skript ved hjelp av Luxon i hoveddelen av HTML-en din.

Funksjoner av Luxon

Luxon gir mange funksjoner, noe som gjør det til en verdifull pakke for håndtering av datoer og klokkeslett i JavaScript-applikasjoner.

Omfattende dato- og tidsmanipulasjon

Luxon tilbyr ulike metoder for å opprette, manipulere og hente datoer og klokkeslett. Luxon forenkler oppgaver som å legge til eller trekke fra varigheter, angi spesifikke dato/tidskomponenter og utføre relative tidsberegninger.

Formatering og lokalisering

Luxons formateringsalternativer lar deg vise datoer og klokkeslett i mange formater. Luxon støtter forskjellige formatmønstre og lar deg angi datoer og klokkeslett i henhold til andre språk.

Tidssonestøtte

Med Luxon kan du effektivt arbeide med datoer og tider i ulike tidssoner. Luxon tilbyr metoder for å angi og konvertere mellom tidssoner.

Uforanderlig design

Luxon følger et uforanderlig designmønster, noe som sikrer det Dato tid objekter er uforanderlige. Denne designtilnærmingen gir forutsigbar og konsistent oppførsel når du arbeider med datoer og klokkeslett.

Omfattende API-dokumentasjon

Luxons API-dokumentasjon er svært detaljert, noe som gjør det enkelt å utforske og forstå tilgjengelige metoder, alternativer og funksjonalitet.

DateTime-klassen i Luxon

De Dato tid klasse i Luxon representerer en bestemt dato og klokkeslett. Den tilbyr både klasse- og instansmetoder som lar deg utføre ulike oppgaver. Disse oppgavene inkluderer å lage, analysere, hente, endre og formatere datoer og klokkeslett.

Her er noen av de forskjellige måtene å lage en ny forekomst av Dato Time-klassen på i Luxon:

  • De DateTime.local() metode:
    konst dt = DateTime.local(2023, 5, 21, 1, 22, 37, 845);
    Denne koden oppretter en ny DateTime-forekomst ved hjelp av DateTime.local() metode. Metoden tar syv argumenter som representerer verdiene for år, måned, dag, time, minutt, sekund og millisekund for datoen og klokkeslettet du vil opprette.
  • De DateTime.fromJSDate() metode:
    konst nå = nyDato();
    konst dt = DateTime.fromJSDate (nå);
    Koden oppretter en ny opprinnelig JavaScript-dato instans og sender den til DateTime.fromJSDate() metode. Denne metoden returnerer et DateTime-objekt som representerer samme dato og klokkeslett.
  • De DateTime.fromObject() metode:
    konst dt = DateTime.fromObject({
     år: 2023,
     måned: 1,
     dag: 1,
     time: 0,
     minutt:0,
     sekund: 0,
     millisekund: 0
    });
    Denne kodeblokken viser hvordan du oppretter en ny DateTime-forekomst ved hjelp av DateTime.fromObject() metode. Metoden tar et objekt med egenskaper som representerer verdiene for år, måned, dag, time, minutt, sekund og millisekund for datoen og klokkeslettet du vil opprette.
  • Bruker DateTime.now() metode:
    konst dt = DatoTid.nå();
    Denne kodeblokken viser hvordan du oppretter en ny Dato Time-forekomst ved hjelp av DateTime.now() metode. Metoden returnerer en ny DateTime-forekomst som representerer gjeldende dato og klokkeslett i den lokale tidssonen.

Formatere DateTime-objekter til strenger

Luxon forenkler formateringen av Dato tid objekter i strenger som representerer bestemte datoer og klokkeslett. Du kan bruke Luxon til å formatere datoer og klokkeslett på ulike metoder.

ISO 8601

ISO 8601-formatet er mye brukt for standardisert dato- og tidsrepresentasjon. For å formatere en Dato tid objekt som en ISO 8601-streng, bruk toISO() metode:

konst nå = DateTime.local();
konsoll.log (nå.toISO()); // 2023-05-21T15:20:07.936+01:00

Lesbare formater for mennesker

Luxon støtter menneskelesbare formater som du kan tilpasse for lokale språk. Du kan formatere en Dato tid objekt til en menneskelesbar streng med toLocaleString() metode:

konst nå = DateTime.local();
konsoll.log (now.toLocaleString()); // 5/21/2023

Tokenbasert formatering

Tokenbasert formatering lar deg formatere dato og klokkeslett til egendefinerte strenger ved å bruke plassholdere kalt tokens. For å formatere en Dato tid objekt ved hjelp av tokens, bruk toFormat() metode:

konst nå = DateTime.local();
konsoll.log (now.toFormat("åååå-MM-dd TT: mm: ss")); //2023-05-21 15:16:57

I eksemplet ovenfor, formatstrengen åååå-MM-dd TT: mm: ss representerer ønsket utdataformat. Tokenene åååå, MM, dd, HH, mm, og ss tilsvarer år, måned, dag, time, minutt og sekund av Dato tid objekt, henholdsvis.

Luxon lar deg utføre et bredt spekter av dato- og tidsrepresentasjoner ved å tilby et omfattende sett med tokens.

Parsing og validering av datoer og klokkeslett i Luxon

Luxon tilbyr robuste metoder for å analysere og validere datoer og klokkeslett. Disse funksjonene er nyttige for oppgaver som å validere brukerinndata eller konvertere strengrepresentasjoner av datoer og klokkeslett til Dato tid gjenstander.

fromFormat()-metoden

De fromFormat() metode lar deg analysere en strengrepresentasjon av en dato og klokkeslett, og konvertere den til en Dato tid gjenstand. Det tar to argumenter, inndatastrengen og en formatstreng som spesifiserer inputformatet.

For eksempel:

DatoTime.fromFormat("25. mai 2023", "LLLL dd åååå")

Validering av datoer og klokkeslett med isValid-metoden

De er gyldig metoden sjekker om en Dato tid objektet representerer en gyldig dato og klokkeslett. Den kommer tilbake ekte hvis objektet er gyldig og falsk ellers.

Som så:

konst invalidDate = DateTime.fromObject({ år: 2022, måned: 2, dag: 29 });
konsoll.log (ugyldig Date.isValid); // falsk
konst validDate = DateTime.fromObject({ år: 2022, måned: 2, dag: 28 });
konsoll.log (validDate.isValid); // sant

I eksemplet, den første Dato tid objektet representerer en ugyldig dato fordi 29. februar 2022 ikke er gyldig. Den andre Dato tid objektet representerer en gyldig dato 28. februar 2022.

Parsing- og valideringsfunksjoner i Luxon hjelper deg med å håndtere datoer og klokkeslett nøyaktig, validere inndata og gi pålitelige representasjoner av dato- og klokkeslettdata.

Alternativer til Luxon

Du har lært hvordan du oppretter, formaterer og validerer dato- og klokkeslettforekomster med Luxon. Disse tipsene vil hjelpe deg når du bygger nettapper som krever håndtering av dato og klokkeslett.

Du kan også bruke andre JavaScript-pakker for å oppnå dato- og klokkesletthåndtering i nettapplikasjonene dine, inkludert Day.js og Date.fns. Disse pakkene har sine fordeler og ulemper, og du bør basere dine preferanser på dine spesifikke behov.