Moment.js: Explicație completă și exemple practice ale bibliotecii de date

Ultima actualizare: 28 iulie 2025
  • Moment.js simplifică gestionarea datei și orei în JavaScript cu o API curată și puternică.
  • Vă permite să analizați, să manipulați, să validați și să afișați date în orice format și fus orar.
  • Se integrează ușor în proiecte și este compatibil cu plugin-uri și biblioteci externe, cum ar fi IronPDF.

moment.js

Lucrul cu date și ore în JavaScript poate fi o adevărată provocare pentru dezvoltatorii web . Din fericire, instrumente precum Moment.js simplifică semnificativ acest proces, facilitând mult totul, de la formatarea de bază a datelor până la operațiuni complexe de manipulare și validare. Dacă v-ați simțit vreodată frustrați încercând să convertiți, să comparați sau să afișați corect datele în proiectele dvs., Moment.js a fost probabil unul dintre cei mai buni prieteni ai dvs. sau cel puțin ar trebui să luați în considerare utilizarea lui.

În acest articol, vă voi spune tot ce trebuie să știți despre Moment.js : de la funcțiile sale principale și trucuri mai puțin cunoscute, la exemple practice și integrarea sa cu alte biblioteci, inclusiv o explicație clară a sintaxei sale și a sarcinilor pe care le puteți îndeplini cu acesta. De asemenea, vom analiza limitele sale, actualizările recente și ce alternative aveți dacă sunteți în căutarea a ceva mai modern.

Ce este Moment.js și de ce a devenit atât de popular?

Moment.js este o bibliotecă JavaScript concepută pentru a facilita lucrul cu date și ore . Vă permite să creați, să analizați, să manipulați și să afișați date în aproape orice format imaginabil, cu o sintaxă simplă, dar puternică. Ani de zile, această bibliotecă a fost principala soluție a comunității pentru depășirea limitărilor obiectului Date() nativ din JavaScript.

Nucleul Moment.js se învârte în jurul obiectului `moment()` , care poate construi date din aproape orice intrare validă: șiruri de text, obiecte Date, timestamp-uri sau direct cu argumente numerice. Acest lucru îl face extrem de flexibil și util în toate tipurile de proiecte, de la scripturi mici la aplicații enterprise care gestionează fusuri orare internaționale sau înregistrări istorice.

Ce a făcut-o atât de reușită? Fiabilitatea, ușurința în utilizare și varietatea de instrumente și plugin-uri însoțitoare . Chiar și atunci când proiectul a intrat în modul de mentenanță, Moment.js menține o bază mare de utilizatori și o documentație extinsă , consolidându-i poziția de soluție de date lider în JavaScript și Node.js.

  Ghid complet pentru OpenCode: Cum să programezi cu inteligență artificială folosind ChatGPT, Claude și Gemini

Caracteristici și beneficii cheie ale Moment.js

  • API simplu și intuitivUnul dintre cele mai mari puncte forte ale Moment.js este sintaxa sa clară. Puteți efectua operațiuni simple, cum ar fi obținerea datei curente sau convertirea unui șir de caractere într-un format specific, sau calcule și validări complexe în doar câteva rânduri.
  • Analiză și formatare flexibileAnalizarea șirurilor de date în aproape orice format și convertirea acestora în rezultatul dorit nu a fost niciodată mai ușoară. Moment.js facilitează și accelerează formatarea datelor în prezentările personalizate..
  • Manipularea datelorAdunarea sau scăderea zilelor, lunilor, anilor, săptămânilor sau a oricărei alte unități de timp este la fel de simplă ca utilizarea metodelor adăuga() y scădea()Acest lucru este foarte util atunci când trebuie să lucrați cu date relative, date scadente sau intervale de timp care variază dinamic.
  • Validare robustăDacă trebuie să verificați dacă o dată este validă sau există (de exemplu, 30 februarie), Moment.js vă ușurează procesul. Metoda este valabil() Este capabil să detecteze erori subtile în formatul sau logica datelor.
  • Suport pentru fusuri orare și localizareMulțumesc pluginului tău moment-fus orarEste foarte ușor să convertiți datele între diferite fusuri orare. De asemenea, puteți afișa date adaptate limbii utilizatorului și convențiilor regionale, ceea ce este esențial în aplicațiile globale.
  • Ecosistem de pluginuriPe lângă biblioteca principală, există un ecosistem de plugin-uri pentru a-i extinde funcționalitatea (calendar, compatibilitate cu alte framework-uri, formate exotice...).

Cum să începi să folosești Moment.js în proiectul tău

Instalarea este foarte simplă . Poți include Moment.js în HTML cu o singură linie:

<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/moment.min.js"></script>

Dacă lucrați cu Node.js sau cu un mediu de dezvoltare modern, este obișnuit să îl instalați folosind npm sau yarn:

npm install moment

După ce ați terminat, puteți importa Moment.js conform sintaxei pe care o utilizați:

// Versión CommonJS
var moment = require('moment');
moment().format();

// ES6
import moment from 'moment';
moment().format();

Crearea datelor: diferite metode și exemple practice

Creați date cu ușurință

Pentru a obține data și ora curente, pur și simplu folosește moment():

console.log(moment()); // Devuelve la fecha actual en formato ISO8601

Puteți construi o dată specifică prin transmiterea de argumente:

moment("2022-10-14"); // Crea el 14 de octubre de 2022

De asemenea, puteți începe de la un șir și un format dat, chiar și în modul strict:

moment("25/12/1995", "DD/MM/YYYY", true); // Analiza y comprueba el formato

Ai un obiect Date nativ?

const fechaJS = new Date();
const miFecha = moment(fechaJS);

Formatarea și afișarea datelor

Moment.js vă permite să afișați date în orice format imaginabil . De exemplu, pentru a afișa data curentă ca zi/lună/an:

moment().format('DD/MM/YYYY');

Dacă doriți un lanț mai umanizat, puteți folosi:

moment().format('MMMM Do YYYY, h:mm:ss a'); // Ejemplo: "marzo 8º 2024, 3:21:10 pm"

Câteva jetoane utile pentru formatare :

  • YYYYan cu 4 cifre
  • MM: Ale mele
  • DDziua lunii
  • hh o HH: oră (format 12h sau 24h)
  • mmminute
  • sssecunde
  • a: dimineața/duminică
  Explorarea celor mai bune cadre Java

De exemplu, pentru a afișa doar ora:

moment().format('HH:mm:ss');

Formatare avansată cu token-uri și suport regional

Moment.js acceptă mai multe formate localizate și traduceri . Este posibil să schimbați limbile în timp real pentru a afișa numele lunilor și zilelor într-o altă limbă.

moment.locale('es'); // Cambia a español
document.write(moment().format('LLLL'));
// Ejemplo: martes, 8 de marzo de 2024 15:21

Manipularea datelor: adunare, scădere și comparare

Lucrul cu date relative este unul dintre punctele forte ale Moment.js.

  • Adăugați zile, luni sau ani:
    moment().add(3, 'days').format('DD/MM/YYYY');
  • Scăderea unităților:
    moment().subtract(2, 'months').format('DD/MM/YYYY');
  • Începutul și sfârșitul perioadelor:
    moment().startOf('month').format('DD/MM/YYYY'); // Primer día del mes
    moment().endOf('month').format('DD/MM/YYYY');   // Último día del mes

Validarea datelor și detectarea erorilor

Înainte de a opera cu date, este vital să se confirme că acestea sunt corecte:

moment('2024-02-30', 'YYYY-MM-DD').isValid(); // false, el 30 de febrero no existe

Acest lucru previne erorile neașteptate în aplicațiile care primesc date de la utilizator.

Compararea datelor: verifică dacă o dată se află printre altele

Moment.js include mai multe metode pentru compararea datelor:

  • esteÎnainte()Verifică dacă o dată este anterioară alteia.
  • esteDupă()Verifică dacă o dată este ulterioară.
  • esteÎntre(): Indică dacă o dată se află între două date date.
let hoy = moment();
let ayer = moment().subtract(1, 'days');
console.log(hoy.isAfter(ayer)); // true

Gestionarea fusurilor orare și a datelor internaționale

Când lucrați cu utilizatori din diferite părți ale lumii, fusurile orare pot fi o adevărată bătaie de cap . Cu pluginul moment-timezone , puteți converti cu ușurință datele între regiuni.

const moment = require('moment-timezone');
const fechaUTC = moment('2024-05-25');
const fechaNY = fechaUTC.tz('America/New_York').format('YYYY-MM-DD HH:mm:ss');
console.log(fechaNY);
// Ejemplo: "2024-05-24 20:00:00"

În plus, Moment.js poate afișa date adaptate setărilor regionale ale utilizatorului , indicând numele lunilor și zilelor traduse corect.

Exemple cheie de utilizare și sfaturi avansate

Obțineți diferențele dintre date

Puteți calcula timpul scurs între două date în unități diferite:

let inicio = moment('2024-01-01');
let fin = moment('2024-03-08');
let dias = fin.diff(inicio, 'days'); // Devuelve el número de días entre ambas

Date relative și timpuri umane

Moment.js este excelent pentru afișarea mesajelor precum „acum 3 zile” sau „în 5 ore”:

moment().subtract(3, 'days').fromNow(); // "hace 3 días"
moment().add(2, 'hours').fromNow();    // "en 2 horas"

Calendarul uman

Funcția calendar () afișează date relative precum „ieri la 17:00”, „mâine la 9:00”, ceea ce o face foarte utilizabilă pentru aplicațiile de calendar.

moment().subtract(1, 'days').calendar(); // "Ayer a las..."
moment().add(3, 'days').calendar();     // "Próximo martes a las..."

Suport pentru schimbări de an și zile speciale

Vrei să știi dacă un an este bisect?

moment([2024]).isLeapYear(); // true

Metoda isLeapYear() îți oferă răspunsul direct.

  Cum să eviți oboseala și epuizarea Full Stack: un ghid complet și aplicabil

Personalizare avansată: formate, token-uri și analiză strictă

Moment.js vă permite să lucrați cu șiruri de caractere și token-uri personalizate pentru a crea sau citi date în nenumărate formate . În plus, modul strict necesită potriviri exacte, prevenind erorile subtile și surprizele nedorite.

De exemplu, pentru a analiza o dată în formatul „zi/lună/an”:

moment('12/03/2023', 'DD/MM/YYYY', true);

Listă de token-uri comune și exemple

  • An: AAAA (2024), AA (24), A (-500)
  • LunăMM (01 – 12), MMM (ianuarie), MMMM (ianuarie)
  • ZiZZ (01 – 31), C (1 – 31)
  • Timp: HH (00 – 23), hh (01 – 12), mm (minute), ss (secunde)
  • Fusul orarZ, ZZ

Aceste token-uri pot fi combinate pentru a crea rezultate complet personalizate. Consultați documentația pentru lista completă și cazurile speciale.

TecnoDigital

TecnoDigital

Pasionat de tehnologie și dezvoltare de software, mă afund în lumea sistemelor și a computerului cu scopul de a stimula inovația și de a rezolva provocări complexe.