Português Brasileiro | [English](../../README.md) | [简体中文](../zh-cn/README.zh-CN.md) | [日本語](../ja/README-ja.md) | [한국어](../ko/README-ko.md) | [Español (España)](../es-es/README-es-es.md) | [Русский](../ru/README-ru.md)| [עברית](./docs/he/README-he.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.
```js
dayjs()
.startOf('month')
.add(1, 'day')
.set('year', 2018)
.format('YYYY-MM-DD HH:mm:ss')
```
- 🕒 API & padrões familiares aos do Moment.js
- 💪 Imutável
- 🔥 Encadeável
- 🌐 Suporta I18n
- 📦 Mini biblioteca de 2kb
- 👫 Suporta todos os navegadores
---
## Começando
### Documentação
Você pode encontrar mais detalhes sobre a API e também a documentação completa em [day.js.org](https://day.js.org/).
### Instalação
```console
npm install dayjs --save
```
📚[Guia de instalação](https://day.js.org/docs/en/installation/installation)
### API
É fácil utilizar a API do Day.js para converter, validar, manipular, e exibir datas e horas.
```javascript
dayjs('2018-08-08') // converte
dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // formata
dayjs()
.set('month', 3)
.month() // get & set
dayjs().add(1, 'year') // manipula
dayjs().isBefore(dayjs()) // verifica
```
📚[Referência da API](https://day.js.org/docs/en/parse/parse)
### I18n
Day.js tem suporte para internacionalização.
Porém nenhuma estará inclusa no seu _build_ a menos que você utilize-a.
```javascript
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](https://day.js.org/docs/en/i18n/i18n)
### Plugin
Um plugin é um módulo independente que pode ser adicionado ao Day.js para estender funcionalidades e adicionar novos recursos.
```javascript
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](https://day.js.org/docs/en/plugin/plugin)
### Tendência de Uso
## Patrocinadores
Ajude este projeto se tornando um patrocinador. O seu logo será exibido aqui, com um link para o seu site. [[Tornar-se um Patrocinador](https://opencollective.com/dayjs#sponsor)].
## Contribuidores
Este projeto existe graças a todas as pessoas que contribuem.
Por favor, nos dê uma 💖 estrela 💖 para suportar-nos. Obrigado.
E obrigado a todos os nossos apoiadores! 🙏
## Licença
Day.js é licenciado sob a [MIT License](../../LICENSE).