You Dont Need Momentjs - You Dont Need Momentjs

Vous n'avez pas (peut-être) un moment.js

Moment.js est une bibliothèque de temps et de date fantastique avec beaucoup de fonctionnalités et de services publics. Cependant, si vous travaillez sur une application Web sensible aux performances, cela pourrait provoquer une énorme surcharge de performances en raison de ses API complexes et de sa grande taille de faisceau.

Grande taille de faisceau

Problèmes avec Moment.js:

Il est fortement basé sur les API OOP, ce qui le fait échouer avec la baisse des arbres, conduisant ainsi à une énorme taille de paquet et à des problèmes de performances.
Il est mutable et provoque des bugs:
- cloner
- Comment puis-je travailler autour de la mutabilité dans un moment.js?
API OOP complexe (qui double un problème de mutabilité). Voici un exemple: https://github.com/moment/moment/blob/develop/src/test/moment/add_substract.js#l244-l286 Moment.js permet d'utiliser a.subtract('ms', 50) , a.subtract(50, 'ms') et même a.subtract('s', '50') .

Si vous n'utilisez pas le fuseau horaire mais seulement quelques fonctions simples de moment.js, cela peut gonfler votre application et est donc considéré comme exagéré. DayJS a un noyau plus petit et a des API très similaires, il est donc très facile de migrer. Date-FNS permet la partage d'arbres et d'autres avantages afin qu'il fonctionne très bien avec React, Sinon.js et WebPack, etc. Voir Moment / Moment # 2373 Pour plus d'idées sur pourquoi et comment les gens passent du moment.js à d'autres solutions.

Brève comparaison

Nom	Chasiations des arbres	Méthodes Richness	Modèle	Lieu	Support du fuseau horaire
Moment.js	Non	Haut	Oo	123	Bon (moment-tempszone)
Luxon	Non	Haut	Oo	-	Bon (intl)
date-fns	Oui	Haut	Fonctionnel	64	Bon (date-fns-tz)
dayjs	Non	Haut	Oo	138	Bon (intl)

Voix des développeurs

Supprimé Moment.js à remplacer par des FN de date - la sortie de construction réduite de 40%

—Jared Farago du projet WebNode.

Bonne bibliothèque si vous cherchez à remplacer le moment.js pour une raison ou une autre. Immuable aussi.

—Dan Abramov, auteur de Redux et co-auteur de Create React App. Construire des outils pour les humains.

Je recommande fortement d'utiliser des date-fns sur Moment.js, il a une API plus agréable et vous ne pouvez inclure que les pièces dont vous avez besoin!

—Matija Marohnić, un développeur frontend averti de la Croatie.

Plugin Eslint

Si vous utilisez Eslint, vous pouvez installer un plugin qui vous aidera à identifier des endroits dans votre base de code où vous n'avez pas (peut ne pas) avoir besoin de moment.js.

Installez le plugin ...

npm install --save-dev eslint-plugin-you-dont-need-momentjs

... puis mettez à jour votre configuration

 "extends" : [ "plugin:you-dont-need-momentjs/recommended" ] ,

Liens rapides

Analyse

Format de chaîne + date
Format de chaîne + temps
Chaîne + format + paramètres régionaux

Obtenez + set

Millisecondes / deuxième / minute / heure
Date du mois
Jour de la semaine
Jour de l'année
Semaine de l'année
Jours en mois
Semaines dans l'année
Maximum des dates données
Minimum des dates données

Manipuler

Ajouter
Soustraire
Début des temps
Fin des temps

Afficher

Format
Temps à partir de maintenant
Temps de x
Différence

Requête

Est avant
Est le même
Est après
Est entre
Est-ce que l'année du leap
Est une date

Parité de caractéristique

️ Indique que d'autres packages ou travail sont nécessaires. Voir les fonctions individuelles ci-dessus.

	Indigène	Luxon	date-fns	dayjs	Temporel
Analyse
Format de chaîne + date	✅	✅	✅	✅	✅
Format de chaîne + temps	✅	✅	✅	️	✅
Chaîne + format + paramètres régionaux		️	✅	️

Obtenez + set
Millisecondes / deuxième / minute / heure	✅	✅	✅	✅	✅
Date du mois	✅	✅	✅	✅	✅
Jour de la semaine	✅	✅	✅	✅	✅
Jour de l'année	✅	✅	✅	✅	✅
Semaine de l'année	✅	✅	✅	️	✅
Jours en mois	✅	✅	✅	✅	✅
Semaines dans l'année			✅	️	✅
Maximum des dates données	✅	✅	✅	️	✅
Minimum des dates données	✅	✅	✅	️	✅

Manipuler
Ajouter	✅	✅	✅	✅	✅
Soustraire	✅	✅	✅	✅	✅
Début des temps		✅	✅	✅	✅
Fin des temps	✅	✅	✅	✅	✅

Afficher
Format	✅	✅	✅	✅	✅
Temps à partir de maintenant	✅		✅	️	✅
Temps de x			✅	️	✅
Différence	✅	✅	✅	✅	✅

Requête
Est avant	✅	✅	✅	✅	✅
Est le même	✅	✅	✅	✅	✅
Est après	✅	✅	✅	✅	✅
Est entre		✅	✅	️
Est-ce que l'année du leap	✅	✅	✅	️	✅
Est une date	✅	✅	✅	✅	✅

Analyse

Format de chaîne + date

Renvoie la date analysée à partir de la chaîne de date à l'aide de la chaîne de format donné.

 // Moment.js
moment ( '12-25-1995' , 'MM-DD-YYYY' ) ;
// => "1995-12-24T13:00:00.000Z"

// Native
const datePattern = / ^(d{2})-(d{2})-(d{4})$ / ;
const [ , month , day , year ] = datePattern . exec ( '12-25-1995' ) ;
new Date ( ` ${ month } , ${ day } ${ year } ` ) ;
// => "1995-12-24T13:00:00.000Z"

// date-fns
import parse from 'date-fns/parse' ;
parse ( '12-25-1995' , 'MM-dd-yyyy' , new Date ( ) ) ;
// => "1995-12-24T13:00:00.000Z"

// dayjs
dayjs ( '12-25-1995' ) ;
// => "1995-12-24T13:00:00.000Z"

// luxon
DateTime . fromFormat ( '12-25-1995' , 'MM-dd-yyyy' ) . toJSDate ( ) ;
// => "1995-12-24T13:00:00.000Z"

// Temporal
const datePattern = / ^(d{2})-(d{2})-(d{4})$ / ;
const [ , month , day , year ] = datePattern . exec ( '12-25-1995' ) ;
new Temporal . ZonedDateTime . from ( { year , month , day , timeZone : Temporal . Now . timeZone ( ) } ) ;
// => "1995-12-24T13:00:00.000Z"

⬆ Retour en haut

Format de chaîne + temps

Renvoie la date analysée à partir de la chaîne de temps à l'aide de la chaîne de format donné.

 // Moment.js
moment ( '2010-10-20 4:30' , 'YYYY-MM-DD HH:mm' ) ;
// => "2010-10-19T17:30:00.000Z"

// Native
const datePattern = / ^(d{4})-(d{2})-(d{2})s(d{1,2}):(d{2})$ / ;
const [ , year , month , day , rawHour , min ] = datePattern . exec ( '2010-10-20 4:30' ) ;
new Date ( ` ${ year } - ${ month } - ${ day } T ${ ( '0' + rawHour ) . slice ( - 2 ) } : ${ min } :00` ) ;
// => "2010-10-19T17:30:00.000Z"

// date-fns
import parse from 'date-fns/parse' ;
parse ( '2010-10-20 4:30' , 'yyyy-MM-dd H:mm' , new Date ( ) ) ;
// => "2010-10-19T17:30:00.000Z"

// dayjs ️ requires customParseFormat plugin
import customParseFormat from 'dayjs/plugin/customParseFormat' ;
dayjs . extend ( customParseFormat ) ;
dayjs ( '2010-10-20 4:30' , 'YYYY-MM-DD HH:mm' ) ;
// => "2010-10-19T17:30:00.000Z"

// luxon
DateTime . fromFormat ( '2010-10-20 4:30' , 'yyyy-MM-dd H:mm' ) . toJSDate ( ) ;
// => "2010-10-19T17:30:00.000Z"

// Temporal
const datePattern = / ^(d{4})-(d{2})-(d{2})s(d{1,2}):(d{2})$ / ;
const [ , year , month , day , hour , minute ] = datePattern . exec ( '2010-10-20 4:30' ) ;
new Temporal . ZonedDateTime . from ( { year , month , day , hour , minute , timeZone : Temporal . Now . timeZone ( ) } ) ;
// => "2010-10-19T17:30:00.000Z"

⬆ Retour en haut

Chaîne + format + paramètres régionaux

Renvoie la date analysée de la chaîne à l'aide de la chaîne de format et des paramètres régionaux donnés.

 // Moment.js
moment ( '2012 mars' , 'YYYY MMM' , 'fr' ) ;
// => "2012-02-29T13:00:00.000Z"

// date-fns
import parse from 'date-fns/parse' ;
import fr from 'date-fns/locale/fr' ;
parse ( '2012 mars' , 'yyyy MMMM' , new Date ( ) , { locale : fr } ) ;
// => "2012-02-29T13:00:00.000Z"

// dayjs ️ requires customParseFormat plugin
import customParseFormat from 'dayjs/plugin/customParseFormat' ;
import 'dayjs/locale/fr' ;
dayjs . extend ( customParseFormat ) ;
dayjs ( '2012 mars' , 'YYYY MMM' , 'fr' ) ;
// => "2012-02-29T13:00:00.000Z"

// Luxon  does not support Locale for node unless https://moment.github.io/luxon/docs/manual/install.html#node
DateTime . fromFormat ( '2012 mars' , 'yyyy MMMM' , { locale : 'fr' } ) ;
// => "2012-02-29T13:00:00.000Z"

⬆ Retour en haut

Obtenez + set

Millisecondes / deuxième / minute / heure

Obtenez la Millisecond/Second/Minute/Hour de la date donnée.

 // Moment.js
moment ( ) . seconds ( ) ;
// => 49
moment ( ) . hours ( ) ;
// => 19

// Native
new Date ( ) . getSeconds ( ) ;
// => 49
new Date ( ) . getHours ( ) ;
// => 19

// date-fns
import getSeconds from 'date-fns/getSeconds' ;
import getHours from 'date-fns/getHours' ;
getSeconds ( new Date ( ) ) ;
// => 49
getHours ( new Date ( ) ) ;
// => 19

// dayjs
dayjs ( ) . second ( ) ;
// => 49
dayjs ( ) . hour ( ) ;
// => 19

// Luxon
DateTime . local ( ) . second ;
// => 49
DateTime . local ( ) . hour ;
// => 19

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . second ;
// => 49
Temporal . Now . zonedDateTimeISO ( ) . hour ;
// => 19

Tests de performance

Bibliothèque	Temps
Moment	1500,703 ms
Indigène	348.411ms
Datefns	520,670 ms
Dayjs	494.234ms
Luxon	1208.368 ms
Temporel	-

Réglez la Millisecond/Second/Minute/Hour de la date donnée.

 // Moment.js
moment ( ) . seconds ( 30 ) ;
// => "2018-09-09T09:12:30.695Z"
moment ( ) . hours ( 13 ) ;
// => "2018-09-09T03:12:49.695Z"

// Native
new Date ( new Date ( ) . setSeconds ( 30 ) ) ;
// => "2018-09-09T09:12:30.695Z"
new Date ( new Date ( ) . setHours ( 13 ) ) ;
// => "2018-09-09T03:12:49.695Z"

// date-fns
import setSeconds from 'date-fns/setSeconds' ;
import setHours from 'date-fns/setHours' ;
setSeconds ( new Date ( ) , 30 ) ;
// => "2018-09-09T09:12:30.695Z"
setHours ( new Date ( ) , 13 ) ;
// => "2018-09-09T03:12:49.695Z"

// dayjs
dayjs ( ) . set ( 'second' , 30 ) ;
// => "2018-09-09T09:12:30.695Z"
dayjs ( ) . set ( 'hour' , 13 ) ;
// => "2018-09-09T03:12:49.695Z"

// luxon
DateTime . utc ( )
  . set ( { second : 30 } )
  . toJSDate ( ) ;
// => "2018-09-09T09:12:30.695Z"
DateTime . utc ( )
  . set ( { hour : 13 } )
  . toJSDate ( ) ;
// => "2018-09-09T03:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . with ( { second : 30 } ) ;
// => "2018-09-09T09:12:30.695Z"
Temporal . Now . zonedDateTimeISO ( ) . with ( { hour : 13 } ) ;
// => "2018-09-09T03:12:49.695Z"

Tests de performance

Bibliothèque	Temps
Moment	1689.744ms
Indigène	636.741ms
Datefns	714.148 ms
Dayjs	2037.603 ms
Luxon	2897.571ms
Temporel	-

⬆ Retour en haut

Date du mois

Obtient ou définit le jour du mois.

 // Moment.js
moment ( ) . date ( ) ;
// => 9
moment ( ) . date ( 4 ) ;
// => "2018-09-04T09:12:49.695Z"

// Native
new Date ( ) . getDate ( ) ;
// => 9
new Date ( ) . setDate ( 4 ) ;
// => "2018-09-04T09:12:49.695Z"

// date-fns
import getDate from 'date-fns/getDate' ;
import setDate from 'date-fns/setDate' ;
getDate ( new Date ( ) ) ;
// => 9
setDate ( new Date ( ) , 4 ) ;
// => "2018-09-04T09:12:49.695Z"

// dayjs
dayjs ( ) . date ( ) ;
// => 9
dayjs ( ) . set ( 'date' , 4 ) ;
// => "2018-09-04T09:12:49.695Z"

// luxon
DateTime . utc ( ) . day ;
// => 9
DateTime . utc ( )
  . set ( { day : 4 } )
  . toString ( ) ;
// => "2018-09-04T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . day ;
// => 9
Temporal . Now . zonedDateTimeISO ( ) . with ( { day : 4 } ) ;
// => "2018-09-04T09:12:49.695Z"

Tests de performance

Bibliothèque	Temps
Moment	1381,669 ms
Indigène	397.415ms
Datefns	588.004ms
Dayjs	1218.025ms
Luxon	2705.606 ms
Temporel	-

⬆ Retour en haut

Jour de la semaine

Obtient ou définit le jour de la semaine.

 // Moment.js
moment ( ) . day ( ) ;
// => 0 (Sunday)
moment ( ) . day ( - 14 ) ;
// => "2018-08-26T09:12:49.695Z"

// Native
new Date ( ) . getDay ( ) ;
// => 0 (Sunday)
new Date ( ) . setDate ( new Date ( ) . getDate ( ) - 14 ) ;
// => "2018-08-26T09:12:49.695Z"

// date-fns
import getDay from 'date-fns/getDay' ;
import setDay from 'date-fns/setDay' ;
getDay ( new Date ( ) ) ;
// => 0 (Sunday)
setDay ( new Date ( ) , - 14 ) ;
// => "2018-08-26T09:12:49.695Z"

// dayjs
dayjs ( ) . day ( ) ;
// => 0 (Sunday)
dayjs ( ) . set ( 'day' , - 14 ) ;
// => "2018-08-26T09:12:49.695Z"

// Luxon
DateTime . local ( ) . weekday ;
// => 7 (Sunday)
DateTime . local ( )
  . minus ( { day : 14 } )
  . toJSDate ( ) ;
// => "2018-08-26T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . dayOfWeek ;
// => 7 (Sunday)
Temporal . Now . zonedDateTimeISO ( ) . subtract ( Temporal . Duration . from ( { days : 14 } ) ) ;
// => "2018-09-04T09:12:49.695Z"

Bibliothèque	Temps
Moment	1919.404ms
Indigène	543,466 ms
Datefns	841.436ms
Dayjs	1229.475 ms
Luxon	3936.282 ms
Temporel	-

⬆ Retour en haut

Jour de l'année

Obtient ou définit le jour de l'année.

 // Moment.js
moment ( ) . dayOfYear ( ) ;
// => 252
moment ( ) . dayOfYear ( 256 ) ;
// => "2018-09-13T09:12:49.695Z"

// Native
Math . floor (
  ( new Date ( ) - new Date ( new Date ( ) . getFullYear ( ) , 0 , 0 ) ) / 1000 / 60 / 60 / 24
) ;
// => 252

// date-fns
import getDayOfYear from 'date-fns/getDayOfYear' ;
import setDayOfYear from 'date-fns/setDayOfYear' ;
getDayOfYear ( new Date ( ) ) ;
// => 252
setDayOfYear ( new Date ( ) , 256 ) ;
// => "2018-09-13T09:12:49.695Z"

// dayjs ️ requires dayOfYear plugin
import dayOfYear from 'dayjs/plugin/dayOfYear' ;
dayjs . extend ( dayOfYear ) ;
dayjs ( ) . dayOfYear ( ) ;
// => 252
dayjs ( ) . dayOfYear ( 256 ) ;
// => "2018-09-13T09:12:49.695Z"

// Luxon
DateTime . local ( ) . ordinal ;
// => 252
DateTime . local ( )
  . set ( { ordinal : 256 } )
  . toString ( ) ;
// => "2018-09-13T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . dayOfYear ;
// => 252
Temporal . Now . zonedDateTimeISO ( ) . with ( { month : 1 , day : 1 } ) . add ( Temporal . Duration . from ( { days : 256 } ) ) ;
// => "2018-09-04T09:12:49.695Z"

Bibliothèque	Temps
Moment	5511.172ms
Indigène	530,592 ms
Datefns	2079.043ms
Dayjs	-
Luxon	3540,810 ms
Temporel	-

⬆ Retour en haut

Semaine de l'année

Obtient ou définit la semaine de l'année.

 // Moment.js
moment ( ) . week ( ) ;
// => 37
moment ( ) . week ( 24 ) ;
// => "2018-06-10T09:12:49.695Z"

// date-fns
import getWeek from 'date-fns/getWeek' ;
import setWeek from 'date-fns/setWeek' ;
getWeek ( new Date ( ) ) ;
// => 37
setWeek ( new Date ( ) , 24 ) ;
// => "2018-06-10T09:12:49.695Z"

// native getWeek
const day = new Date ( ) ;
const MILLISECONDS_IN_WEEK = 604800000 ;
const firstDayOfWeek = 1 ; // monday as the first day (0 = sunday)
const startOfYear = new Date ( day . getFullYear ( ) , 0 , 1 ) ;
startOfYear . setDate (
  startOfYear . getDate ( ) + ( firstDayOfWeek - ( startOfYear . getDay ( ) % 7 ) )
) ;
const dayWeek = Math . round ( ( day - startOfYear ) / MILLISECONDS_IN_WEEK ) + 1 ;
// => 37

// native setWeek
const day = new Date ( ) ;
const week = 24 ;
const MILLISECONDS_IN_WEEK = 604800000 ;
const firstDayOfWeek = 1 ; // monday as the first day (0 = sunday)
const startOfYear = new Date ( day . getFullYear ( ) , 0 , 1 ) ;
startOfYear . setDate (
  startOfYear . getDate ( ) + ( firstDayOfWeek - ( startOfYear . getDay ( ) % 7 ) )
) ;
const dayWeek = Math . round ( ( day - startOfYear ) / MILLISECONDS_IN_WEEK ) + 1 ;
day . setDate ( day . getDate ( ) - ( dayWeek - week ) * 7 ) ;
day . toISOString ( ) ;
// => "2018-06-10T09:12:49.794Z

// dayjs ️ requires weekOfYear plugin
import weekOfYear from 'dayjs/plugin/weekOfYear' ;
dayjs . extend ( weekOfYear ) ;
dayjs ( ) . week ( ) ;
// => 37
dayjs ( ) . week ( 24 ) ;
// => "2018-06-10T09:12:49.695Z"

// Luxon
DateTime . local ( ) . weekNumber ;
// => 37
DateTime . local ( )
  . set ( { weekNumber : 23 } )
  . toString ( ) ;
// => "2018-06-10T09:12:49.794Z

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . weekOfYear ;
// => 252
Temporal . Now . zonedDateTimeISO ( ) . with ( { month : 1 , day : 1 } ) . add ( Temporal . Duration . from ( { weeks : 23 } ) ) ;
// => "2018-09-04T09:12:49.695Z"

Bibliothèque	Temps
Moment	7147.201ms
Indigène	1371.631 ms
Datefns	5834.815 ms
Dayjs	-
Luxon	4514.771 ms
Temporel	-

⬆ Retour en haut

Jours en mois

Obtenez le nombre de jours dans le mois en cours.

 // Moment.js
moment ( '2012-02' , 'YYYY-MM' ) . daysInMonth ( ) ;
// => 29

// Native
new Date ( 2012 , 02 , 0 ) . getDate ( ) ;
// => 29

// date-fns
import getDaysInMonth from 'date-fns/getDaysInMonth' ;
getDaysInMonth ( new Date ( 2012 , 1 ) ) ;
// => 29

// dayjs
dayjs ( '2012-02' ) . daysInMonth ( ) ;
// => 29

// Luxon
DateTime . local ( 2012 , 2 ) . daysInMonth ;
// => 29

// Temporal
( new Temporal . PlainYearMonth ( 2012 , 2 ) ) . daysInMonth
// or
Temporal . PlainYearMonth . from ( '2012-02' ) . daysInMonth
// => 29

Bibliothèque	Temps
Moment	4415.065ms
Indigène	186.196ms
Datefns	634.084ms
Dayjs	1922.774 ms
Luxon	1403.032 ms
Temporel	-

⬆ Retour en haut

Semaines dans l'année

Obtient le nombre de semaines au cours de l'année en cours, selon les semaines ISO.

 // Moment.js
moment ( ) . isoWeeksInYear ( ) ;
// => 52

// Native
const year = new Date ( ) . getFullYear ( ) ;
const MILLISECONDS_IN_WEEK = 604800000 ;
const firstMondayThisYear = new Date ( + year ,   0 , 5 - ( new Date ( + year ,   0 , 4 ) . getDay ( ) || 7 ) ) ;
const firstMondayNextYear = new Date ( + year + 1 , 0 , 5 - ( new Date ( + year + 1 , 0 , 4 ) . getDay ( ) || 7 ) ) ;
( firstMondayNextYear - firstMondayThisYear ) / MILLISECONDS_IN_WEEK ;
// => 52

// date-fns
import getISOWeeksInYear from 'date-fns/getISOWeeksInYear' ;
getISOWeeksInYear ( new Date ( ) ) ;
// => 52

// dayjs ️ requires isoWeeksInYear plugin
import isoWeeksInYear from 'dayjs/plugin/isoWeeksInYear' ;
dayjs . extend ( isoWeeksInYear ) ;
dayjs ( ) . isoWeeksInYear ( ) ;
// => 52

// Luxon
DateTime . local ( ) . weeksInWeekYear ;
// => 52

// Temporal
Temporal . PlainDate . from ( { day : 31 , month : 12 , year : Temporal . Now . plainDateISO ( ) } ) . weekOfYear
// => 52

Bibliothèque	Temps
Moment	1065.247ms
Indigène	-
Datefns	4954.042ms
Dayjs	-
Luxon	1134.483 ms
Temporel	-

⬆ Retour en haut

Maximum des dates données

Renvoie le maximum (avenir le plus lointain) de la date donnée.

 const array = [
  new Date ( 2017 , 4 , 13 ) ,
  new Date ( 2018 , 2 , 12 ) ,
  new Date ( 2016 , 0 , 10 ) ,
  new Date ( 2016 , 0 , 9 ) ,
] ;
// Moment.js
moment . max ( array . map ( a => moment ( a ) ) ) ;
// => "2018-03-11T13:00:00.000Z"

// Native
new Date ( Math . max . apply ( null , array ) ) . toISOString ( ) ;
// => "2018-03-11T13:00:00.000Z"

// date-fns
import max from 'date-fns/max' ;
max ( array ) ;
// => "2018-03-11T13:00:00.000Z"

// dayjs ️ requires minMax plugin
import minMax from 'dayjs/plugin/minMax' ;
dayjs . extend ( minMax ) ;
dayjs . max ( array . map ( a => dayjs ( a ) ) ) ;
// => "2018-03-11T13:00:00.000Z"

// Luxon
DateTime . max ( ... array . map ( a => DateTime . fromJSDate ( a ) ) ) . toJSDate ( ) ;
// => "2018-03-11T13:00:00.000Z"

// Temporal
Temporal . Instant . fromEpochMilliseconds ( Math . max . apply ( null , array ) )
// => "2018-03-11T13:00:00.000Z"

Bibliothèque	Temps
Moment	1780.075 ms
Indigène	828.332 ms
Datefns	980,938 ms
Dayjs	-
Luxon	2694.702 ms
Temporel	-

⬆ Retour en haut

Minimum des dates données

Renvoie le minimum (avenir le plus lointain) de la date donnée.

 const array = [
  new Date ( 2017 , 4 , 13 ) ,
  new Date ( 2018 , 2 , 12 ) ,
  new Date ( 2016 , 0 , 10 ) ,
  new Date ( 2016 , 0 , 9 ) ,
] ;
// Moment.js
moment . min ( array . map ( a => moment ( a ) ) ) ;
// => "2016-01-08T13:00:00.000Z"

// Native
new Date ( Math . min . apply ( null , array ) ) . toISOString ( ) ;
// => "2016-01-08T13:00:00.000Z"

// date-fns
import min from 'date-fns/min' ;
min ( array ) ;
// => "2016-01-08T13:00:00.000Z"

// dayjs ️ requires minMax plugin
import minMax from 'dayjs/plugin/minMax' ;
dayjs . extend ( minMax ) ;
dayjs . min ( array . map ( a => dayjs ( a ) ) ) ;
// => "2016-01-08T13:00:00.000Z"

// Luxon
DateTime . min ( ... array . map ( a => DateTime . fromJSDate ( a ) ) ) . toJSDate ( ) ;
// => "2016-01-08T13:00:00.000Z"

// Temporal
Temporal . Instant . fromEpochMilliseconds ( Math . min . apply ( null , array ) )
// => "2018-03-11T13:00:00.000Z"

Bibliothèque	Temps
Moment	1744.459 ms
Indigène	819.646 ms
Datefns	841.249ms
Dayjs	-
Luxon	2720.462 ms
Temporel	-

⬆ Retour en haut

Manipuler

Ajouter

Ajoutez le nombre de jours spécifié à la date donnée.

 // Moment.js
moment ( ) . add ( 7 , 'days' ) ;
// => "2018-09-16T09:12:49.695Z"

// Native
const now = new Date ( ) ;
now . setDate ( now . getDate ( ) + 7 ) ;
// => "Sun Sep 16 2018 09:12:49"

// date-fns
import addDays from 'date-fns/addDays' ;
addDays ( new Date ( ) , 7 ) ;
// => "2018-09-16T09:12:49.695Z"

// dayjs
dayjs ( ) . add ( 7 , 'day' ) ;
// => "2018-09-16T09:12:49.695Z"

// Luxon
DateTime . local ( )
  . plus ( { day : 7 } )
  . toJSDate ( ) ;
// => "2018-09-16T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . add ( Temporal . Duration . from ( { days : 7 } ) ) ;
// => "2018-09-16T09:12:49.695Z"

Bibliothèque	Temps
Moment	1309.485 ms
Indigène	259.932 ms
Datefns	385.394ms
Dayjs	1911.881 ms
Luxon	3919.797ms
Temporel	-

⬆ Retour en haut

Soustraire

Soustrayez le nombre spécifié de jours à partir de la date donnée.

 // Moment.js
moment ( ) . subtract ( 7 , 'days' ) ;
// => "2018-09-02T09:12:49.695Z"

// Native
const now = new Date ( ) ;
now . setDate ( now . getDate ( ) - 7 ) ;
// => Sun Sep 09 2018 09:12:49

// date-fns
import subDays from 'date-fns/subDays' ;
subDays ( new Date ( ) , 7 ) ;
// => "2018-09-02T09:12:49.695Z"

// dayjs
dayjs ( ) . subtract ( 7 , 'day' ) ;
// => "2018-09-02T09:12:49.695Z"

// Luxon
DateTime . local ( )
  . minus ( { day : 7 } )
  . toJSDate ( ) ;
// => "2018-09-02T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . subtract ( Temporal . Duration . from ( { days : 7 } ) ) ;
// => "2018-09-02T09:12:49.695Z"

Bibliothèque	Temps
Moment	1278.384ms
Indigène	215.255 ms
Datefns	379.057ms
Dayjs	1772.593 ms
Luxon	4028.866 ms
Temporel	-

⬆ Retour en haut

Début des temps

Renvoyez le début d'une unité de temps pour la date donnée.

 // Moment.js
moment ( ) . startOf ( 'month' ) ;
// => "2018-08-31T14:00:00.000Z"

// date-fns
import startOfMonth from 'date-fns/startOfMonth' ;
startOfMonth ( new Date ( ) ) ;
// => "2018-08-31T14:00:00.000Z"

// dayjs
dayjs ( ) . startOf ( 'month' ) ;
// => "2018-08-31T14:00:00.000Z"

// Luxon
DateTime . local ( ) . startOf ( 'month' ) ;
// => "2018-09-02T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . with ( { day : 1 } ) ;
// => "2018-09-01T14:00:00.000Z"

Bibliothèque	Temps
Moment	1078.948 ms
Indigène	-
Datefns	398.107ms
Dayjs	765.358 ms
Luxon	2306.765 ms
Temporel	-

⬆ Retour en haut

Fin des temps

Renvoyez la fin d'une unité de temps pour la date donnée.

 // Moment.js
moment ( ) . endOf ( 'day' ) ;
// => "2018-09-09T13:59:59.999Z"

// Native
const end = new Date ( ) ;
end . setHours ( 23 , 59 , 59 , 999 ) ;
end . toISOString ( ) ;
// => "2018-09-09T16:59:59.999Z"

// date-fns
import endOfDay from 'date-fns/endOfDay' ;
endOfDay ( new Date ( ) ) ;
// => "2018-09-09T13:59:59.999Z"

// dayjs
dayjs ( ) . endOf ( 'day' ) ;
// => "2018-09-09T13:59:59.999Z"

// Luxon
DateTime . local ( ) . endOf ( 'day' ) ;
// => "2018-09-02T09:12:49.695Z"

// Temporal
Temporal . Now . zonedDateTimeISO ( ) . withPlainTime ( new Temporal . PlainTime ( 23 , 59 , 59 , 999 , 999 , 999 ) ) ;
// => "2018-09-09T16:59:59.999999999Z"

Bibliothèque	Temps
Moment	1241.304ms
Indigène	225.519 ms
Datefns	319.773 ms
Dayjs	914.425 ms
Luxon	9920.529ms
Temporel	-

⬆ Retour en haut

Afficher

Format

Renvoie la chaîne de date formatée au format donné.

 // Moment.js
moment ( ) . format ( 'dddd, MMMM Do YYYY, h:mm:ss A' ) ;
// => "Sunday, September 9th 2018, 7:12:49 PM"
moment ( ) . format ( 'ddd, hA' ) ;
// => "Sun, 7PM"

// Native
new Intl . DateTimeFormat ( 'en-US' , { dateStyle : 'full' , timeStyle : 'medium' } ) . format ( new Date ( ) )
// => "Sunday, September 9, 2018 at 7:12:49 PM"
new Intl . DateTimeFormat ( 'en-US' , { weekday : 'short' , hour : 'numeric' } ) . format ( new Date ( ) )
// => "Sun, 7 PM"

// date-fns
import { intlFormat } from 'date-fns'
intlFormat ( new Date ( ) , { dateStyle : 'full' , timeStyle : 'medium' } , { locale : 'en-US' , } )
// => "Sunday, September 9, 2018 at 7:12:49 PM"
intlFormat ( new Date ( ) , { weekday : 'short' , hour : 'numeric' } , { locale : 'en-US' , } )
// => "Sun, 7 PM"

// dayjs
dayjs ( ) . format ( 'dddd, MMMM D YYYY, h:mm:ss A' ) ;
// => "Sunday, September 9 2018, 7:12:49 PM"
dayjs ( ) . format ( 'ddd, hA' ) ;
// => "Sun, 7PM"
// dayjs ️ requires advancedFormat plugin to support more format tokens
import advancedFormat from 'dayjs/plugin/advancedFormat' ;
dayjs . extend ( advancedFormat ) ;
dayjs ( ) . format ( 'dddd, MMMM Do YYYY, h:mm:ss A' ) ;
// => "Sunday, September 9th 2018, 7:12:49 PM"

// Luxon
DateTime . fromMillis ( time ) . toFormat ( 'EEEE, MMMM dd yyyy, h:mm:ss a' ) ;
// => "Sunday, September 9 2018, 7:12:49 PM" ️  not support 9th
DateTime . fromMillis ( time ) . toFormat ( 'EEE, ha' ) ;
// => "Sun, 7PM"

// Temporal
new Intl . DateTimeFormat ( 'en-US' , { dateStyle : 'full' , timeStyle : 'medium' } ) . format ( Temporal . Now . zonedDateTimeISO ( ) )
// => "Sunday, September 9, 2018 at 7:12:49 PM"
new Intl . DateTimeFormat ( 'en-US' , { weekday : 'short' , hour : 'numeric' } ) . format ( Temporal . Now . zonedDateTimeISO ( ) )
// => "Sun, 7 PM"

⬆ Retour en haut

Temps à partir de maintenant

Heure de retour à partir de maintenant.

 // Moment.js
moment ( 1536484369695 ) . fromNow ( ) ;
// => "4 days ago"

// Native
new Intl . RelativeTimeFormat ( ) . format ( - 4 , 'day' ) ;
// => "4 days ago"

// date-fns
import formatDistance from 'date-fns/formatDistance' ;
formatDistance ( new Date ( 1536484369695 ) , new Date ( ) , { addSuffix : true } ) ;
// => "4 days ago"

// dayjs ️ requires relativeTime plugin
import relativeTime from 'dayjs/plugin/relativeTime' ;
dayjs . extend ( relativeTime ) ;

dayjs ( 1536484369695 ) . fromNow ( ) ;
// => "5 days ago" ️  the rounding method of this plugin is different from moment.js and date-fns, use with care.

// luxon requires Intl.RelativeTimeFormat
DateTime . local ( 2022 , 1 , 27 ) . toRelative ( { base : this } )
// => "in 4 months"

// Temporal
new Intl . RelativeTimeFormat ( ) . format ( - 4 , 'day' ) ;
// => "4 days ago"

⬆ Retour en haut

Temps de x

Heure de retour à partir de x.

 // Moment.js
moment ( [ 2007 , 0 , 27 ] ) . to ( moment ( [ 2007 , 0 , 29 ] ) ) ;
// => "in 2 days"

// date-fns
import formatDistance from 'date-fns/formatDistance' ;
formatDistance ( new Date ( 2007 , 0 , 27 ) , new Date ( 2007 , 0 , 29 ) ) ;
// => "2 days"

// dayjs ️ requires relativeTime plugin
import relativeTime from 'dayjs/plugin/relativeTime' ;
dayjs . extend ( relativeTime ) ;
dayjs ( '2007-01-27' ) . to ( dayjs ( '2007-01-29' ) ) ;
// => "in 2 days"

// luxon  does not support relative time

// Temporal
Temporal . PlainDate . from ( '2007-01-27' ) . until ( '2007-01-29' ) ;
// => Temporal.Duration('P2D')

⬆ Retour en haut

Différence

Obtenez l'unité de temps entre les dates données.

 // Moment.js
moment ( [ 2007 , 0 , 27 ] ) . diff ( moment ( [ 2007 , 0 , 29 ] ) ) ;
// => -172800000
moment ( [ 2007 , 0 , 27 ] ) . diff ( moment ( [ 2007 , 0 , 29 ] ) , 'days' ) ;
// => -2

// Native
new Date ( 2007 , 0 , 27 ) - new Date ( 2007 , 0 , 29 ) ;
// => -172800000
Math . ceil (
  ( new Date ( 2007 , 0 , 27 ) - new Date ( 2007 , 0 , 29 ) ) / 1000 / 60 / 60 / 24
) ;
// => -2

// date-fns
import differenceInMilliseconds from 'date-fns/differenceInMilliseconds' ;
differenceInMilliseconds ( new Date ( 2007 , 0 , 27 ) , new Date ( 2007 , 0 , 29 ) ) ;
// => -172800000
import differenceInDays from 'date-fns/differenceInDays' ;
differenceInDays ( new Date ( 2007 , 0 , 27 ) , new Date ( 2007 , 0 , 29 ) ) ;
// => -2

// dayjs
dayjs ( '2007-01-27' ) . diff ( dayjs ( '2007-01-29' ) , 'milliseconds' ) ;
// => -172800000
dayjs ( '2007-01-27' ) . diff ( dayjs ( '2007-01-29' ) , 'days' ) ;
// => -2

// luxon
DateTime . local ( 2007 , 1 , 27 ) . diff ( DateTime . local ( 2007 , 1 , 29 ) ) . milliseconds ;
// => -172800000
DateTime . local ( 2007 , 1 , 27 ) . diff ( DateTime . local ( 2007 , 1 , 29 ) , 'days' ) . days ;
// => -2

// Temporal
Temporal . PlainDate . from ( '2007-01-27' ) . since ( '2007-01-29' ) . total ( { unit : 'millisecond' } ) ;
// => -172800000
Temporal . PlainDate . from ( '2007-01-27' ) . since ( '2007-01-29' ) . total ( { unit : 'day' } ) ;
// => -2

⬆ Retour en haut

Requête

Est avant

Vérifiez si une date est avant une autre date.

 // Moment.js
moment ( '2010-10-20' ) . isBefore ( '2010-10-21' ) ;
// => true

// Native
new Date ( 2010 , 10 , 20 ) < new Date ( 2010 , 10 , 21 ) ;
// => true

// date-fns
import isBefore from 'date-fns/isBefore' ;
isBefore ( new Date ( 2010 , 9 , 20 ) , new Date ( 2010 , 9 , 21 ) ) ;
// => true

// dayjs
dayjs ( '2010-10-20' ) . isBefore ( '2010-10-21' ) ;
// => true

// luxon
DateTime . fromISO ( '2010-10-20' ) < DateTime . fromISO ( '2010-10-21' ) ;
// => true

// Temporal
Temporal . PlainDate . compare ( '2010-10-20' , '2010-10-21' ) === - 1 ;
// => true

⬆ Retour en haut

Est le même

Vérifiez si une date est la même qu'une autre date.

 // Moment.js
moment ( '2010-10-20' ) . isSame ( '2010-10-21' ) ;
// => false
moment ( '2010-10-20' ) . isSame ( '2010-10-20' ) ;
// => true
moment ( '2010-10-20' ) . isSame ( '2010-10-21' , 'month' ) ;
// => true

// Native
new Date ( 2010 , 9 , 20 ) . valueOf ( ) === new Date ( 2010 , 9 , 21 ) . valueOf ( ) ;
// => false
new Date ( 2010 , 9 , 20 ) . valueOf ( ) === new Date ( 2010 , 9 , 20 ) . valueOf ( ) ;
// => true
new Date ( 2010 , 9 , 20 ) . getTime ( ) === new Date ( 2010 , 9 , 20 ) . getTime ( ) ;
// => true
new Date ( 2010 , 9 , 20 ) . valueOf ( ) === new Date ( 2010 , 9 , 20 ) . getTime ( ) ;
// => true
new Date ( 2010 , 9 , 20 ) . toDateString ( ) . substring ( 4 , 7 ) ===
  new Date ( 2010 , 9 , 21 ) . toDateString ( ) . substring ( 4 , 7 ) ;
// => true

// date-fns
import isSameDay from 'date-fns/isSameDay' ;
import isSameMonth from 'date-fns/isSameMonth' ;
isSameDay ( new Date ( 2010 , 9 , 20 ) , new Date ( 2010 , 9 , 21 ) ) ;
// => false
isSameDay ( new Date ( 2010 , 9 , 20 ) , new Date ( 2010 , 9 , 20 ) ) ;
// => true
isSameMonth ( new Date ( 2010 , 9 , 20 ) , new Date ( 2010 , 9 , 21 ) ) ;
// => true

// dayjs
dayjs ( '2010-10-20' ) . isSame ( '2010-10-21' ) ;
// => false
dayjs ( '2010-10-20' ) . isSame ( '2010-10-20' ) ;
// => true
dayjs ( '2010-10-20' ) . isSame ( '2010-10-21' , 'month' ) ;
// => true

// luxon
( + DateTime . fromISO ( '2010-10-20' ) ===
  + DateTime . fromISO ( '2010-10-21' ) +
    // => false
    DateTime . fromISO ( '2010-10-20' ) ) ===
  + DateTime . fromISO ( '2010-10-20' ) ;
// => true
DateTime . fromISO ( '2010-10-20' ) . hasSame ( DateTime . fromISO ( '2010-10-21' ) , 'month' ) ;
// => true

// Temporal
Temporal . PlainDate . from ( '2010-10-20' ) . equals ( '2010-10-21' ) ;
// => false
Temporal . PlainDate . from ( '2010-10-20' ) . equals ( '2010-10-20' ) ;
// => true
Temporal . PlainDate . from ( '2010-10-20' ) . month === Temporal . PlainDate . from ( '2010-10-21' ) . month ;
// => true

⬆ Retour en haut

Est après

Vérifiez si une date est après une autre date.

 // Moment.js
moment ( '2010-10-20' ) . isAfter ( '2010-10-19' ) ;
// => true

// Native
new Date ( 2010 , 9 , 20 ) > new Date ( 2010 , 9 , 19 ) ;
// => true

// date-fns
import isAfter from 'date-fns/isAfter' ;
isAfter ( new Date ( 2010 , 9 , 20 ) , new Date ( 2010 , 9 , 19 ) ) ;
// => true

// dayjs
dayjs ( '2010-10-20' ) . isAfter ( '2010-10-19' ) ;
// => true

// luxon
DateTime . fromISO ( '2010-10-20' ) > DateTime . fromISO ( '2010-10-19' ) ;
// => true

// Temporal
Temporal . PlainDate . compare ( '2010-10-20' , '2010-10-19' ) === 1 ;
// => true

⬆ Retour en haut

Est entre

Vérifiez si une date se situe entre deux autres dates.

 // Moment.js
moment ( '2010-10-20' ) . isBetween ( '2010-10-19' , '2010-10-25' ) ;
// => true

// date-fns
import isWithinInterval from 'date-fns/isWithinInterval' ;
isWithinInterval ( new Date ( 2010 , 9 , 20 ) , {
  start : new Date ( 2010 , 9 , 19 ) ,
  end : new Date ( 2010 , 9 , 25 ) ,
} ) ;
// => true

// dayjs ️ requires isBetween plugin
import isBetween from 'dayjs/plugin/isBetween' ;
dayjs . extend ( isBetween ) ;
dayjs ( '2010-10-20' ) . isBetween ( '2010-10-19' , '2010-10-25' ) ;
// => true

// luxon
Interval . fromDateTimes (
  DateTime . fromISO ( '2010-10-19' ) ,
  DateTime . fromISO ( '2010-10-25' )
) . contains ( DateTime . fromISO ( '2010-10-20' ) ) ;
// => true

⬆ Retour en haut

Est-ce que l'année du leap

Vérifiez si un an est une année de saut.

 // Moment.js
moment ( [ 2000 ] ) . isLeapYear ( ) ;
// => true

// Native
new Date ( 2000 , 1 , 29 ) . getDate ( ) === 29 ;
// => true

// date-fns
import isLeapYear from 'date-fns/isLeapYear' ;
isLeapYear ( new Date ( 2000 , 0 , 1 ) ) ;
// => true

// dayjs ️ requires isLeapYear plugin
import isLeapYear from 'dayjs/plugin/isLeapYear' ;
dayjs . extend ( isLeapYear ) ;
dayjs ( '2000-01-01' ) . isLeapYear ( ) ;
// => true

// luxon
expect ( DateTime . local ( 2000 ) . isInLeapYear ) . toBeTruthy ( ) ;
// => true

// Temporal
Temporal . PlainDate . from ( '2000-01-01' ) . inLeapYear ;
// => true

⬆ Retour en haut

Est une date

Vérifiez si une variable est un objet de date JS natif.

 // Moment.js
moment . isDate ( new Date ( ) ) ;
// => true

// Native
new Date ( ) instanceof Date ;
// => true

// date-fns
import isDate from 'date-fns/isDate' ;
isDate ( new Date ( ) ) ;
// => true

// dayjs
dayjs ( new Date ( ) ) . isValid ( ) ;

// luxon
DateTime . local ( ) . isValid ;
// => true

// Temporal
new Date ( ) instanceof Date ;
Temporal . Now . plainTimeISO ( ) instanceof Temporal . PlainTime ;
Temporal . Now . plainDateISO ( ) instanceof Temporal . PlainDate ;
Temporal . Now . plainDateTimeISO ( ) instanceof Temporal . PlainDateTime ;
Temporal . Now . zonedDateTimeISO ( ) instanceof Temporal . ZonedDateTime ;
// => true

⬆ Retour en haut

Licence

Mit

Développer