DateTimePicker update

[bdlukaa]

Fixes #306

Pre-launch Checklist

• I have updated CHANGELOG.md with my changes
• I have run "dart format ." on the project
• I have added/updated relevant documentation

[bdlukaa]

The following translations were added

  "hour": "hour",
  "minute": "minute",
  "am": "AM",
  "pm": "PM",
  "month": "month",
  "day": "day",
  "year": "year"

@WinXaito @henry2man @raitonoberu @larsb24 @alexmercerind @zacksleo @dmakwt @xmine64 @patricknicolosi
if you guys could send the translated version of these in your mother language, I'd be so grateful :)

They're basically used as a placeholder when the current selected date is not provided (null)

[alexmercerind]

  "hour": "घंटा",
  "minute": "मिनट",
  "am": "AM",
  "pm": "PM",
  "month": "महीना",
  "day": "दिन",
  "year": "साल"

Thanks!

[patricknicolosi]

"IT"

  "hour": "ore",
  "minute": "minuti",
  "am": "AM",
  "pm": "PM",
  "month": "mese",
  "day": "giorno",
  "year": "anno"

[dmakwt]

"AR"

  "hour": "ساعة",
  "minute": "دقيقة",
  "am": "AM",
  "pm": "PM",
  "month": "شهر",
  "day": "يوم",
  "year": "سنة"

[xmine64]

"FA"

    "hour": "ساعت",
    "minute": "دقیقه",
    "am": "ق.ظ.",
    "pm": "ب.ظ.",
    "month": "ماه",
    "day": "روز",
    "year": "سال"

[henry2man]

Spanish localisation ES:

  "hour": "hora",
  "minute": "minuto",
  "am": "AM",
  "pm": "PM",
  "month": "mes",
  "day": "día",
  "year": "año"

@bdlukaa Relative to hours and minutes, should we use plural literals instead of singular ones?

Just in case, in Latin languages Spanish we just need to add a final s to the literal if needlessly.

[henry2man]

Also, will 24h format be available? In Spanish is not usual to use the AM/PM format, so instead we use 24h one.

[bdlukaa]

@henry2man

Relative to hours and minutes, should we use plural literals instead of singular ones?

Singular ones. The texts will be used here:

Also, will 24h format be available? In Spanish is not usual to use the AM/PM format, so instead we use 24h one.

It has been available since DateTime pickers were implemented.

Check the example app to play with it!

[WinXaito]

FR

  "hour": "heure",
  "minute": "minute",
  "am": "AM",
  "pm": "PM",
  "month": "mois",
  "day": "jour",
  "year": "année"

Note: AM and PM are not used in french, we use 24h format. Translation for AM/PM can be matin/après-midi, but I think it's preferable to keep AM/PM.

And the date in french is in format : DAY / MONTH / YEAR, so Day must be before month ;)

[bdlukaa]

AM and PM are not used in french, we use 24h format

There is already the possibility to use 24h format:

TimePicker(
  hourFormat: HourFormat.H,
),

And the date in french is in format : DAY / MONTH / YEAR, so Day must be before month ;)

This PR adds DatePicker.fieldOrder, which let the dev choose what's the order the fields are displayed. It also adds a new function (getDateOrderFromLocale) that is able to get the date order based on the current locale. It's used by default.

cyan/green/blue - DAY/MONTH/YEAR
yellow - YEAR/MONTH/DAY
red - MONTH/DAY/YEAR

src: https://en.wikipedia.org/wiki/Date_format_by_country

Since most of the world uses the DMY format, it's returned by default!

---

The year and day fields are also formatted based on the locale.