README-ja.md

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

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 のもとで利用を許諾します。