Configurable date format per field/form

[ebruchez]

Following #5524/#5621, we should do something similar for date fields.

Here are the aspects of date format we need to be able to control, based on the formats we currently support:

• month first or day first or year first
• separator: /, ., -
• ability to pad the month or day to 2 digits

We currently don't support (I think):

• putting the year first (like for the ISO format)
  • probably desirable
  • 2024-09-04: it works
• setting a padding/rounding of the year
  • might not be desirable

[ebruchez]

• [ ] create IsoDate class/object
• [ ] update fr:date and Date.scala
• [ ] Form Builder UI editor

[avernet]

+1 from customer

[ebruchez]

For fr:time, we use oxf.xforms.xbl.fr.time.output-format, which also translates into form-level and control-level output-format parameters. This looks like [h01]:[m]:[s].

We'd like to introduce oxf.xforms.xbl.fr.date.output-format. Could we, as a first step, just do that? Instead of using:

property('xxf:format.input.date')

use:

(fr:component-param-value('output-format'), property('xxf:format.input.date'))[1]

This would give us configurability by properties/form/control. Currently supported formats (from the doc):

Format	Example	Description
[M]/[D]/[Y]	11/5/2023	also called "North American format"
[D]/[M]/[Y]	5/11/2023	also called "European format"
[D].[M].[Y]	5.11.2023	variation with dot separator
[D]-[M]-[Y]	5-11-2023	variation with dash separator
[M01]/[D01]/[Y]	11/05/2023	force two digits for months and days
[Y]-[M01]-[D01]	2023-11-05	ISO format

It seems that this would work.

[ebruchez]

• [x] introduce oxf.xforms.xbl.fr.date.output-format
• [x] test that this works for properties/form/control
• [x] fr:date must still be usable in plain XForms
  • Is, with, like before, xxf:function-library="org.orbeon.oxf.fr.library.FormRunnerFunctionLibrary"

[ebruchez]

What else do we need to do?

• date format needs to be parsed/serialized, so it can be used for the UI
• handle "magic" dates

[ebruchez]

This should also address #4794.