Русский | [English](../../README.md) | [简体中文](../zh-cn/README.zh-CN.md) | [日本語](../ja/README-ja.md) | [Português Brasileiro](../pt-br/README-pt-br.md) | [한국어](../ko/README-ko.md) | [Español (España)](../es-es/README-es-es.md)| [עברית](./docs/he/README-he.md)
Быстрая 2kB альтернатива Moment.js с тем же современным API
> Day.js - это миниатюрная JavaScript библиотека, которая парсит, валидирует, управляет, и отображает даты и время для современных браузеров, обладающая большой совместимостью с Moment.js API. Если вы используете Moment.js, вы уже знаете как пользоваться Day.js.
```js
dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');
```
* 🕒 Хорошо знакомые API и паттерны Moment.js
* 💪 Неизменная
* 🔥 Цепная
* 🌐 Поддержка интернационализации (I18n)
* 📦 2kb мини-библиотека
* 👫 Поддерживающаяся всеми браузерами
---
## Начало работы
### Документация
Вы можете найти больше детальной информации, API, и других документов на веб-сайте [day.js.org](https://day.js.org/).
### Установка
```console
npm install dayjs --save
```
📚[Инструкция по установке](https://day.js.org/docs/ru/installation/installation)
### API
API Day.js легко использовать для парсинга, валидации, управления, и отображения дат и времени.
```javascript
dayjs('2018-08-08') // парсинг
dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // отображение
dayjs().set('month', 3).month() // получение и установка
dayjs().add(1, 'year') // управление
dayjs().isBefore(dayjs()) // осведомление
```
📚[Ссылка на API](https://day.js.org/docs/ru/parse/parse)
### I18n
Day.js обладает великолепной поддержкой интернационализации.
Но ни одна из локализаций не будет включена в вашу сборку до тех пор, пока вы не начнёте её использовать.
```javascript
import 'dayjs/locale/es' // загрузка по требованию
dayjs.locale('es') // глобальное использование Испанской локали
dayjs('2018-05-05').locale('zh-cn').format() // использование упрощённой Китайской локали в конкретном случае
```
📚[Интернационализация](https://day.js.org/docs/ru/i18n/i18n)
### Плагин
Плагин - это независимый модуль, который может быть добавлен в Day.js с целью расширения функциональных возможностей или добавления новых особенностей.
```javascript
import advancedFormat from 'dayjs/plugin/advancedFormat' // загрузка по требованию
dayjs.extend(advancedFormat) // использование плагина
dayjs().format('Q Do k kk X x') // больше доступных форматов
```
📚[Список плагинов](https://day.js.org/docs/ru/plugin/plugin)
### Тенденция использования
## Спонсоры
Поддержите этот проект, став спонсором. Ваш логотип будет показан здесь с ссылкой на ваш веб-сайт. [[Стать спонсором](https://opencollective.com/dayjs#sponsor)]
## Контрибьюторы
Этот проект существует благодаря всем людям, кто вносит свой вклад в его развитие.
Пожалуйста поставьте 💖 звездочку 💖, чтобы поддержать нас. Спасибо.
Также выражаю благодарность всем нашим спонсорам! 🙏
## Лицензия
Day.js распространяется под [лицензией MIT](./LICENSE-ru).