Skip to content

Date Picker improve reference date documentation #11878

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
brambrink wants to merge 1 commit into
base: development
Choose a base branch
from
Open

Date Picker improve reference date documentation #11878

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 20 additions & 2 deletions content/en/docs/refguide/modeling/pages/input-widgets/date-picker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,10 +64,28 @@ The possible values for date format are shown below:
If you choose **Custom** as the date format (see above), this property determines how the value is formatted. The custom date format is a string that allows for any combination of symbols found in the table below. Any punctuation will be rendered literally.

{{% alert color="info" %}}
When using `yyyy` custom format and typing `yy` in the date picker widget, the century guessing by proximity follows the rule of **50/50**. Specifically, it adjusts dates to be within 50 years before and 50 years after the time the date format instance is created:
When the custom date format uses `yyyy`, the date picker also accepts a two-digit year (`yy`).
{{% /alert %}}

{{% alert color="info" %}}
The date picker uses a reference date for parsing partial date inputs (e.g. `mm/dd` or `yy/mm/dd`) into complete date inputs `yyyy/mm/dd`. The reference date is the date from the value already in the field. If the field is empty, the current date is the reference date.
{{% /alert %}}

{{% alert color="warning" %}}
Starting with Mendix 12, the date picker will always use the current date as the reference date, even if the field already contains a value.
{{% /alert %}}

{{% alert color="info" %}}
For two-digit year input, the date picker chooses the century that places the entered year closest to the reference year. If two years are equally close, it chooses the earlier year.

For example, with `2026` as the reference year:

* `24` {{< icon name="arrow-narrow-right" >}} `2024`
* `75` {{< icon name="arrow-narrow-right" >}} `1975`
* `75` {{< icon name="arrow-narrow-right" >}} `2075`
* `76` {{< icon name="arrow-narrow-right" >}} `1976`
* `97` {{< icon name="arrow-narrow-right" >}} `1997`

If the field previously contained a date in `1970`, entering `24` results in `1924`.
{{% /alert %}}

{{% snippet file="/static/_includes/refguide/custom-date-format-tokens.md" %}}
Expand Down