lp1691237 release notes for new date fmt settings
authorJason Etheridge <jason@equinoxinitiative.org>
Mon, 12 Jun 2017 19:05:56 +0000 (15:05 -0400)
committerGalen Charlton <gmc@equinoxinitiative.org>
Mon, 19 Jun 2017 16:15:51 +0000 (12:15 -0400)
Signed-off-by: Jason Etheridge <jason@equinoxinitiative.org>
Signed-off-by: Galen Charlton <gmc@equinoxinitiative.org>
docs/RELEASE_NOTES_NEXT/Client/new_webstaff_date_format_settings.adoc [new file with mode: 0644]

diff --git a/docs/RELEASE_NOTES_NEXT/Client/new_webstaff_date_format_settings.adoc b/docs/RELEASE_NOTES_NEXT/Client/new_webstaff_date_format_settings.adoc
new file mode 100644 (file)
index 0000000..e680490
--- /dev/null
@@ -0,0 +1,26 @@
+Date+Time Format Settings for Web Client
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This change deprecates the existing Format Dates and Format Times settings
+and adds two settings for use with the webstaff client:
+
+  * Format Dates with this pattern
+  * Format Date+Time with this pattern
+
+These settings use format strings as documented here:
+
+https://docs.angularjs.org/api/ng/filter/date
+
+There is overlap with how the Dojo formats worked, but also some differences.
+
+The original Format Dates and Format Times settings worked together, but the
+new settings work independently.  Certain field elements will use one, and
+certain field elements will use the other.  These distinctions are hard-coded
+in the various UI templates, with the idea being that timestamp fields in
+which the date component alone is sufficient information (for example, DOB)
+will use the Format Dates setting.  Fields where the time component is
+important (for example, Checkout Time) will use the Format Date+Time setting.
+
+When the settings Format Dates and Format Date+Time are unset, we will default
+to "shortDate" (M/d/yy) and "short" (M/d/yy h:mm a), respectively.
+