day 1.1.0

A Dart date library inspired by Day.js, with nearly the same API. It is built on top of the powerful DateTime class.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

1.1.0 - 2026-09-22

All locales added or updated in this release were implemented with AI using Unicode CLDR as a reference. If you encounter any issues, feel free to open an issue at any time.

Added

• New locales:
  • German (de)
  • Spanish (es)
  • French (fr)
  • Japanese (ja)
  • Korean (ko)
  • Occitan (oc)
  • Portuguese (pt)
  • Brazilian Portuguese (pt_br)
  • Russian (ru)
  • Traditional Chinese (zh_tw)
• Optional MonthsFormat and MonthsShortFormat locale maps for month names in dates, used by Russian.

Changed

• Simplified Chinese weekday abbreviations now include 周 (for example, 周一). Relative times omit spaces between numbers and units and use 后 for future times (for example, 2分钟后).
• Refined the API, plugin, and i18n documentation, source doc comments, and the package description.

1.0.0 - 2026-07-26

We are finally releasing the 1.0.0 version of Day.dart! This version upgrades the minimum Dart SDK version to 3.0.0 and resolves all existing GitHub issues.

Added

• feat: support adding weeks #45

Changed

• Upgrade the minimum Dart SDK version to 3.0.0

Fixed

• Some documentation errors

0.8.0 - 2022-02-04

Added

• feat: add method addRound to prevent date overflow by @g1eny0ung in https://github.com/dayjs/day.dart/pull/41
• feat: add method subtractRound to prevent date overflow by @g1eny0ung in https://github.com/dayjs/day.dart/pull/42

Changed

• chore!: now .add() and .subtract() return nullable

Removed

• chore!: remove useless .isValid()

0.7.2 - 2022-01-17

• Refactor internal Unit
• Enhance doc comments

0.7.1 - 2021-05-04

• Update docs

0.7.0 - 2021-05-03

• Support null safety

0.7.0-nullsafety.0 - 2020-12-21

• Migrate to null safety

0.6.4

• Lint with pedantic

0.6.3

• Fix some issues

0.6.2

• Add Quarter Of Year plugin

0.6.1

• Add Day Of Year plugin

0.6.0

• Now .diff() method return no abs value
• Fix issues of y and M shorthands in .add() and .substract()
• Add Relative Time plugin

0.5.5

• Now can escape string in .format() method

0.5.4

• Add .toDateTime() method

0.5.3

• Update docs

0.5.2

• Follow health suggestions

0.5.1 - 2019-12-16

• Fix the version of dart

0.5.0 - 2019-12-16

• Breaking change: rewrite plugins system with extension syntax
• Add Is Leap Year plugin
• Update some details
• Update docs

0.4.1 - 2019-11-17

• Follow health suggestions

0.4.0 - 2019-09-03

• Add i18n support

0.3.2 - 2019-07-12

• Update pubspec

0.3.1 - 2019-07-12

• Now Day.dart join into the dayjs organization

0.3.0 - 2019-05-31

• Plugin system supported

0.2.2 - 2019-05-29

• Update docs
• Fix .weekday() method's problem
• Update the type checking

0.2.1 - 2019-05-09

• Add API reference
• Now .timezoneOffset returns Duration

0.2.0 - 2019-05-08

Add .format() method

0.1.2 - 2019-05-03

Update README and example

0.1.1 - 2019-05-03

Fix pub related info

0.1.0 - 2019-05-03

First version