README-pt-br.md

Alternativa veloz ao Moment.js, com 2kB e a mesma API moderna

Day.js é uma biblioteca JavaScript minimalista que analisa, valida, manipula e formata datas e horas para navegadores modernos, usando uma API quase completamente compatível com Moment.js. Se você já usou Moment.js, já sabe usar Day.js.

dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');

• 🕒 API & padrões familiares como os do Moment.js
• 💪 Imutável
• 🔥 Encadeável
• 🌐 Suporta I18n
• 📦 Mini biblioteca de 2kb
• 👫 Suporta todos os navegadores

---

Começando

Instalação

npm install dayjs --save

📚Guia de instalação

API

A API do Day.js facilita muitas operações com datas e horas.

dayjs('2018-08-08') // análise

dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // formatação

dayjs().set('month', 3).month() // get & set

dayjs().add(1, 'year') // manipular

dayjs().isBefore(dayjs()) // verificar

📚Referência da API

I18n

Day.js tem suporte para internacionalização.

As traduções só serão incluídas no seu build quando você usá-las.

import 'dayjs/locale/es' // carregar sob demanda

dayjs.locale('es') // usar locale espanhol globalmente

dayjs('2018-05-05').locale('pt-br').format() // usar locale em português brasileiro em uma instância específica

📚Internacionalização

Plugin

Um plugin é um módulo independente que pode ser adicionado ao Day.js para estendê-lo com mais funcionalidades.

import advancedFormat from 'dayjs/plugin/advancedFormat' // carregar sob demanda

dayjs.extend(advancedFormat) // usar plugin

dayjs().format('Q Do k kk X x') // mais formatos disponíveis pelo plugin

📚Lista de Plugins

Licença

Day.js é licenciado sob a MIT License.