Permalink
ac445c6 May 25, 2018
2 contributors

Users who have contributed to this file

@ohbarye @iamkun
101 lines (68 sloc) 3.72 KB

Day.js

Moment.js と同じ API を備えた 2kB の軽量ライブラリ


Gzip Size NPM Version Build Status Codecov License
Sauce Test Status

Day.js は日付と時刻をパース・検証・操作・表示する最小のモダンブラウザ向け JavaScript ライブラリであり、 Moment.js の API との広い互換性を持ちます。 Moment.js を使ったことがあればすぐにでも Day.js を使い始めることができます。

dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');
  • 🕒 Moment.js と類似した API と使用法
  • 💪 イミュータブル
  • 🔥 メソッドチェーン
  • 🌐 国際化サポート (I18n)
  • 📦 2kb の軽量ライブラリ
  • 👫 全ブラウザをサポート

はじめに

インストール

npm install dayjs --save

📚インストールガイド

API

Day.js API で日付と時刻をパース・検証・操作・表示するのは簡単です。

dayjs('2018-08-08') // パース

dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // 表示

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

dayjs().add(1, 'year') // 操作

dayjs().isBefore(dayjs()) // クエリ

📚API リファレンス

国際化 (I18n)

Day.js は国際化を手厚くサポートしています。

また、使用しないロケールをビルドに含みません。

import 'dayjs/locale/es' // 必要に応じて読み込み

dayjs.locale('es') // スペイン語をグローバルロケールとして適用

dayjs('2018-05-05').locale('zh-cn').format() // 簡体字中国語を特定のインスタンスにのみ適用

📚国際化

プラグイン

プラグインとは、 Day.js の機能を拡張したり、新たな機能を追加するための独立したモジュールのことです。

import advancedFormat from 'dayjs/plugin/advancedFormat' // 必要に応じて読み込み

dayjs.extend(advancedFormat) // プラグインを使用

dayjs().format('Q Do k kk X x') // 多様なフォーマットが利用可能に

📚プラグインリスト

ライセンス

Day.js は MIT License のもとで利用を許諾します。