English | Chinese

DayDart #

Time-handling library with day.js API.

Getting Started #

This project is a starting point for a Dart package, a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Install #

Run this command under your project

dart pub add daydart
# or
flutter pub add daydart

API #

The DayDart object is immutable, and all calls will return a new DayDart object.

• Parsing
  • Now Time
  • String
  • DateTime
  • Timestamp
  • Clone
  • Valid
• Get
  • Year
  • Month
  • Quarter
  • Day
  • Week
  • Hour
  • Minute
  • Second
  • Millisecond
• 操作
  • 增加
  • 减少
• 查询
  • 是否之前
  • 是否相同
  • 是否之后
  • 是否相同或之前
  • 是否相同或之后
  • 是否之间
  • 判断是否为 DayDart
  • 是否闰年
• 显示
  • 格式化
  • 转 DateTime 对象
  • 转 List
  • 转 Map
  • 转 IOS 8601 字符串
  • 转字符串

Parsing #

Passing in the supported format in DayDart.

Now Time

不带参数调用 DayDart()将返回一个新的DayDart对象，其中包含当前日期和时间

DayDart now = DayDart()

String

Parses the given string in ISO 8601 format and returns an instance of the DayDart object.

DayDart('2018-04-04')

DateTime

A DateTime object passed in.

DayDart(DateTime.now());

Timestamp

Create DayDart with an integer value of milliseconds

DayDart(1623484401193);

Clone

All DayDart objects are immutable. Dayart#clone can still create a clone of the current object if needed.

DayDart a = DayDart()
DayDart b = a.clone()

Calling DayDart() on the DayDart object also clones it.

DayDart a = DayDart()
DayDart b = DayDart(a)

Valid

Returns a Boolean indicating whether the DayDart object contains an expiration date.

DayDart().isValid()

Get #

Year

Gets or sets the year.

DayDart().year();
DayDart().year(2000);

Month

Gets or sets the month.

Accept numbers from 1 to 12. If it exceeds that range, it will continue until the end of the year.

DayDart().month();
DayDart().month(1);

Quarter

Gets or sets the quarter.

DayDart('2010-04-01').quarter() // 2
DayDart('2010-04-01').quarter(2)

Day

Gets or sets the date of the month.

Accept numbers from 1 to 31. If this range is exceeded, it will last until the day.

DayDart().day()
DayDart().day(1)

Week

For weeks

DayDart().week()

Hour

Gets or sets the hour.

Accept the numbers from 0 to 59. If this range is exceeded, it will last until the day.

DayDart().hour()
DayDart().hour(12)

Minute

Gets or sets the minutes.

Accept the numbers from 0 to 59. If this range is exceeded, it will last until hours

DayDart().minute()
DayDart().minute(12)

Second

Gets or sets the seconds.

Accept the numbers from 0 to 59. If this range is exceeded, it will last up to minutes.

DayDart().second()
DayDart().second(12)

Millisecond

Gets or sets milliseconds.

Accepts numbers from 0 to 999. If this range is exceeded, it will last up to seconds.

DayDart().millisecond()
DayDart().millisecond(12)

Operation #

Once you have a DayDart object, you might want to manipulate it in some way.

DayDart supports method links like this:

DayDart('2019-01-25')..add(1, DayUnits.D)..subtract(1, DayUnits.y)..year(2009)..toString()

List of all available units

Add

Returns a cloned DayDart object, adding the specified time.

DayDart().add(7, DayUnits.D)

Subtract

Returns the cloned 'DayDart' object, subtracting the specified time.

DayDart().subtract(7, DayUnits.D)

Query #

List of all available units

isBefore

This indicates whether the DayDart object is before another supplied date-time.

DayDart().isBefore(DayDart('2011-01-01')) // default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a second argument.

DayDart().isBefore('2011-01-01', DayUnits.y)

isSame

This indicates whether the DayDart object is the same as the date-time provided by another.

DayDart().isSame(DayDart('2011-01-01')) // default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a second argument.

DayDart().isSame('2011-01-01', DayUnits.y)

isAfter

This indicates whether the DayDart object is after another supplied date-time.

DayDart().isAfter(DayDart('2011-01-01')) // default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a second argument.。

DayDart().isAfter('2011-01-01', DayUnits.y)

isSameOrBefore

This indicates whether the DayDart object is the same or before another provided date-time.

DayDart().isSameOrBefore(DayDart('2011-01-01')) // default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a second argument.

DayDart().isSameOrBefore('2011-01-01', DayUnits.y)

isSameOrAfter

This indicates whether the DayDart object is the same or after another supplied date-time.

DayDart().isSameOrAfter(DayDart('2011-01-01')) // default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a second argument.

DayDart().isSameOrAfter('2011-01-01', DayUnits.y)

isBetween

This indicates whether the DayDart object is between the other two supplied date-times.

DayDart('2010-10-20').isBetween('2010-10-19', DayDart('2010-10-25'))// default milliseconds

If you want to limit granularity to units rather than milliseconds, pass it as a third parameter.

DayDart().isBetween('2010-10-19', '2010-10-25', DayUnits.y)

isDayDart

This indicates whether the variable is a DayDart object.

DayDart.isDayDart(DayDart()) // true
DayDart.isDayDart(DateTime.now()) // false

You can also use the is operator:

DayDart() is DayDart // true

isLeapYear

This indicates whether the year of the DayDart object is a leap year.

DayDart('2000-01-01').isLeapYear() // true

Display #

Format

Gets the formatted date based on the passed token string.

To escape characters, enclose them in square brackets (for example, 'MM').

DayDart().format()

DayDart('2019-01-25').format('dd/MM/yyyy') // '25/01/2019'

A list of all available parse tags

To DateTime

To get a copy of the local date object parsed from the 'dayDart' object, use dayDart #toDate.

DayDart('2019-01-25').toDate()

To List

DayDart('2019-01-25').toList() // [ 2019, 0, 25, 0, 0, 0, 0 ]

To Map

Returns Map with date property.

DayDart('2019-01-25').toMap()
/*
{
  years: 2019,
  months: 0,
  date: 25,
  hours: 0,
  minutes: 0,
  seconds: 0,
  milliseconds: 0
}
*/

To IOS 8601 String

Formatted as an ISO 8601 string.

DayDart('2019-01-25').toISOString() // 2019-01-25T00:00:00.000

To String

Returns a string representation of the date.

DayDart('2019-01-25').toString() // 2019-01-25 00:00:00.000