You Dont Need Momentjs - You Dont Need Momentjs

Você não precisa (não pode precisar de momento.js

Moment.js é uma biblioteca de horários e data fantástica, com muitos ótimos recursos e serviços públicos. No entanto, se você estiver trabalhando em um aplicativo da Web sensível ao desempenho, isso pode causar uma enorme sobrecarga de desempenho por causa de suas APIs complexas e tamanho grande do pacote.

Grande tamanho do pacote

Problemas com Moment.js:

É altamente baseado nas APIs OOP, o que faz com que não funcione com a troca de árvores, levando a um enorme tamanho de pacote e problemas de desempenho.
É mutável e causa bugs:
- clone
- Como faço para trabalhar em torno da mutabilidade no momento.js?
API OOP complexa (que dobra o problema de mutabilidade). Aqui está um exemplo: https://github.com/moment/moment/blob/devell/src/test/moment/add_subtract.js#l244-l286 Moment.js permite usar a.subtract('ms', 50) , a.subtract(50, 'ms') a.subtract('s', '50') e até

Se você não estiver usando o fuso horário, mas apenas algumas funções simples do momento.js, isso pode inchar seu aplicativo e, portanto, é considerado um exagero. O DayJS tem um núcleo menor e tem APIs muito semelhantes, por isso facilita a migração. O DATE-FNS permite o troca de árvores e outros benefícios para que funcione muito bem com o React, Sinon.js e Webpack, etc. Veja o momento/momento#2373 para obter mais idéias sobre o porquê e como as pessoas mudam do Moment.js para outras soluções.

Breve comparação

Nome	Troca de árvores	Métodos Riqueza	Padrão	Localidade	Suporte do fuso horário
Moment.js	Não	Alto	OO	123	Bom (Moment-timesone)
Luxon	Não	Alto	OO	-	Bom (intl)
data-fns	Sim	Alto	Funcional	64	Bom (data-fns-tz)
Dayjs	Não	Alto	OO	138	Bom (intl)

Voz de desenvolvedores

Moment.js removido para substituir por data -fns - a produção de construção reduzida em 40%

- Jared Farago do WebNode Project.

Boa biblioteca se você deseja substituir o Moment.js por um motivo ou outro. Imutável também.

-Dan Abramov, autor de Redux e co-autor do Create React App. Ferramentas de construção para humanos.

Eu recomendo fortemente o uso de data-fns no momento.js, ele tem uma API melhor e você pode incluir apenas peças necessárias!

—Matija Marohnić, um desenvolvedor de frontend que conhece o design da Croácia.

Plug -in ESLint

Se você estiver usando o ESLINT, pode instalar um plug -in que o ajudará a identificar locais na sua base de código onde não precisará (pode não) precisar de momentos.js.

Instale o plugin ...

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

... então atualize sua configuração

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

Links rápidos

Analisar

String + Data Formato
String + Formato de tempo
String + formato + localidade

Obtenha + definido

Milissegundo/segundo/minuto/hora
Data do mês
Dia da semana
Dia do ano
Semana do ano
Dias em mês
Semanas de ano
Máximo das datas dadas
Mínimo das datas dadas

Manipular

Adicionar
Subtrair
Começo de tempo
Fim de tempo

Mostrar

Formatar
Tempo a partir de agora
Tempo de x
Diferença

Consulta

É antes
É o mesmo
Está depois
Está entre
É o ano bisseiro
É uma data

Paridade do recurso

️ Indica que outros pacotes ou trabalho são necessários. Veja funções individuais acima.

	Nativo	Luxon	data-fns	Dayjs	Temporal
Analisar
String + Data Formato	✅	✅	✅	✅	✅
String + Formato de tempo	✅	✅	✅	️	✅
String + formato + localidade		️	✅	️

Obtenha + definido
Milissegundo/segundo/minuto/hora	✅	✅	✅	✅	✅
Data do mês	✅	✅	✅	✅	✅
Dia da semana	✅	✅	✅	✅	✅
Dia do ano	✅	✅	✅	✅	✅
Semana do ano	✅	✅	✅	️	✅
Dias em mês	✅	✅	✅	✅	✅
Semanas de ano			✅	️	✅
Máximo das datas dadas	✅	✅	✅	️	✅
Mínimo das datas dadas	✅	✅	✅	️	✅

Manipular
Adicionar	✅	✅	✅	✅	✅
Subtrair	✅	✅	✅	✅	✅
Começo de tempo		✅	✅	✅	✅
Fim de tempo	✅	✅	✅	✅	✅

Mostrar
Formatar	✅	✅	✅	✅	✅
Tempo a partir de agora	✅		✅	️	✅
Tempo de x			✅	️	✅
Diferença	✅	✅	✅	✅	✅

Consulta
É antes	✅	✅	✅	✅	✅
É o mesmo	✅	✅	✅	✅	✅
Está depois	✅	✅	✅	✅	✅
Está entre		✅	✅	️
É o ano bisseiro	✅	✅	✅	️	✅
É uma data	✅	✅	✅	✅	✅

Analisar

String + Data Formato

Retorne a data analisada da string de data usando a sequência de formato fornecida.

 // 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"

⬆ de volta ao topo

String + Formato de tempo

Retorne a data analisada da string de tempo usando a sequência de formato fornecida.

 // 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"

⬆ de volta ao topo

String + formato + localidade

Retorne a data analisada da string usando a string e a localidade do formato fornecido.

 // 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"

⬆ de volta ao topo

Obtenha + definido

Milissegundo / segundo / minuto / hora

Obtenha o Millisecond/Second/Minute/Hour da data fornecida.

 // 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

Testes de desempenho

Biblioteca	Tempo
Momento	1500.703ms
Nativo	348.411ms
Datefns	520.670ms
Dayjs	494.234ms
Luxon	1208.368ms
Temporal	-

Defina o Millisecond/Second/Minute/Hour da data fornecida.

 // 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"

Testes de desempenho

Biblioteca	Tempo
Momento	1689.744ms
Nativo	636.741ms
Datefns	714.148ms
Dayjs	2037.603ms
Luxon	2897.571ms
Temporal	-

⬆ de volta ao topo

Data do mês

Recebe ou define o dia do mês.

 // 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"

Testes de desempenho

Biblioteca	Tempo
Momento	1381.669ms
Nativo	397.415ms
Datefns	588.004ms
Dayjs	1218.025ms
Luxon	2705.606ms
Temporal	-

⬆ de volta ao topo

Dia da semana

Recebe ou define o dia da semana.

 // 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"

Biblioteca	Tempo
Momento	1919.404ms
Nativo	543.466ms
Datefns	841.436ms
Dayjs	1229.475ms
Luxon	3936.282ms
Temporal	-

⬆ de volta ao topo

Dia do ano

Recebe ou define o dia do ano.

 // 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"

Biblioteca	Tempo
Momento	5511.172ms
Nativo	530.592ms
Datefns	2079.043ms
Dayjs	-
Luxon	3540.810ms
Temporal	-

⬆ de volta ao topo

Semana do ano

Recebe ou define a semana do ano.

 // 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"

Biblioteca	Tempo
Momento	7147.201ms
Nativo	1371.631ms
Datefns	5834.815ms
Dayjs	-
Luxon	4514.771ms
Temporal	-

⬆ de volta ao topo

Dias em mês

Obtenha o número de dias no mês atual.

 // 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

Biblioteca	Tempo
Momento	4415.065ms
Nativo	186.196ms
Datefns	634.084ms
Dayjs	1922.774ms
Luxon	1403.032ms
Temporal	-

⬆ de volta ao topo

Semanas de ano

Obtém o número de semanas no ano atual, de acordo com a ISO Weeks.

 // 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

Biblioteca	Tempo
Momento	1065.247ms
Nativo	-
Datefns	4954.042ms
Dayjs	-
Luxon	1134.483ms
Temporal	-

⬆ de volta ao topo

Máximo das datas dadas

Retorna o máximo (futuro mais distante) da data fornecida.

 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"

Biblioteca	Tempo
Momento	1780.075ms
Nativo	828.332ms
Datefns	980.938ms
Dayjs	-
Luxon	2694.702ms
Temporal	-

⬆ de volta ao topo

Mínimo das datas dadas

Retorna o mínimo (futuro mais distante) da data fornecida.

 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"

Biblioteca	Tempo
Momento	1744.459ms
Nativo	819.646ms
Datefns	841.249ms
Dayjs	-
Luxon	2720.462ms
Temporal	-

⬆ de volta ao topo

Manipular

Adicionar

Adicione o número especificado de dias à data fornecida.

 // 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"

Biblioteca	Tempo
Momento	1309.485ms
Nativo	259.932ms
Datefns	385.394ms
Dayjs	1911.881ms
Luxon	3919.797ms
Temporal	-

⬆ de volta ao topo

Subtrair

Subtraia o número especificado de dias a partir da data fornecida.

 // 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"

Biblioteca	Tempo
Momento	1278.384ms
Nativo	215.255ms
Datefns	379.057ms
Dayjs	1772.593ms
Luxon	4028.866ms
Temporal	-

⬆ de volta ao topo

Começo de tempo

Retorne o início de uma unidade de tempo para a data fornecida.

 // 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"

Biblioteca	Tempo
Momento	1078.948ms
Nativo	-
Datefns	398.107ms
Dayjs	765.358ms
Luxon	2306.765ms
Temporal	-

⬆ de volta ao topo

Fim de tempo

Retorne o final de uma unidade de tempo para a data fornecida.

 // 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"

Biblioteca	Tempo
Momento	1241.304ms
Nativo	225.519ms
Datefns	319.773ms
Dayjs	914.425ms
Luxon	9920.529ms
Temporal	-

⬆ de volta ao topo

Mostrar

Formatar

Retorne a string de data formatada no formato fornecido.

 // 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"

⬆ de volta ao topo

Tempo a partir de agora

Tempo de retorno a partir de agora.

 // 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"

⬆ de volta ao topo

Tempo de x

Tempo de retorno 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')

⬆ de volta ao topo

Diferença

Obtenha a unidade de tempo entre as datas fornecidas.

 // 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

⬆ de volta ao topo

Consulta

É antes

Verifique se uma data é antes de outra data.

 // 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

⬆ de volta ao topo

É o mesmo

Verifique se uma data é a mesma que outra data.

 // 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

⬆ de volta ao topo

Está depois

Verifique se uma data está após outra data.

 // 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

⬆ de volta ao topo

Está entre

Verifique se uma data está entre duas outras datas.

 // 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

⬆ de volta ao topo

É o ano bisseiro

Verifique se um ano é um ano bissexto.

 // 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

⬆ de volta ao topo

É uma data

Verifique se uma variável é um objeto nativo de data js.

 // 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

⬆ de volta ao topo

Licença

Mit

Expandir