@defra/fcp-sfd-frontend-engine 0.21.0 → 0.22.0

package/dist/index.cjs

@@ -914,6 +914,21 @@ var formatDateInputValues = (payloadDob, changedDob, originalDob) => {
     year: formatDatePart(changedDob == null ? void 0 : changedDob.year, originalDob == null ? void 0 : originalDob.year)
   };
 };
+var formatLongDate = (date) => {
+  if (date === null || date === void 0 || date === "") {
+    return null;
+  }
+  const localDate = new Date(date);
+  if (Number.isNaN(localDate.getTime())) {
+    return null;
+  }
+  return localDate.toLocaleDateString("en-GB", {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+};
 var sortErrorsBySectionOrder = (errors, orderedSectionsToFix, SECTION_FIELD_ORDER) => {
   const sortedErrors = [];
   for (const section of orderedSectionsToFix) {
@@ -1090,6 +1105,7 @@ var presenters = {
   formatBackLink,
   formatNumber,
   formatDateInputValues,
+  formatLongDate,
   formatDisplayAddress,
   formatOriginalAddress,
   formatChangedAddress,

package/dist/index.js

@@ -873,6 +873,21 @@ var formatDateInputValues = (payloadDob, changedDob, originalDob) => {
     year: formatDatePart(changedDob == null ? void 0 : changedDob.year, originalDob == null ? void 0 : originalDob.year)
   };
 };
+var formatLongDate = (date) => {
+  if (date === null || date === void 0 || date === "") {
+    return null;
+  }
+  const localDate = new Date(date);
+  if (Number.isNaN(localDate.getTime())) {
+    return null;
+  }
+  return localDate.toLocaleDateString("en-GB", {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+    timeZone: "UTC"
+  });
+};
 var sortErrorsBySectionOrder = (errors, orderedSectionsToFix, SECTION_FIELD_ORDER) => {
   const sortedErrors = [];
   for (const section of orderedSectionsToFix) {
@@ -1049,6 +1064,7 @@ var presenters = {
   formatBackLink,
   formatNumber,
   formatDateInputValues,
+  formatLongDate,
   formatDisplayAddress,
   formatOriginalAddress,
   formatChangedAddress,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defra/fcp-sfd-frontend-engine",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Shared frontend engine used by both the internal and external frontend applications.",
   "main": "./dist/index.cjs",
   "exports": {

package/src/presenters/base-presenter.js

@@ -69,6 +69,31 @@ export const formatDateInputValues = (payloadDob, changedDob, originalDob) => {
   }
 }
 
+/**
+ * Formats a date as a long-form UK date string, e.g. "5 April 1990".
+ * Accepts a Date object or any value that can be passed to new Date().
+ * Returns null if no date is provided.
+ */
+export const formatLongDate = (date) => {
+  if (date === null || date === undefined || date === '') {
+    return null
+  }
+
+  const localDate = new Date(date)
+
+  // new Date() on an unrecognisable value doesn't throw, it just produces NaN when you call getTime()
+  if (Number.isNaN(localDate.getTime())) {
+    return null
+  }
+
+  return localDate.toLocaleDateString('en-GB', {
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric',
+    timeZone: 'UTC'
+  })
+}
+
 /**
  * Shared helper used by base presenters to sort validation errors so they
  * appear in the same order as the sections and fields shown on a Fix List page.

package/src/presenters/presenters.js

@@ -2,6 +2,7 @@ import {
   formatBackLink,
   formatNumber,
   formatDateInputValues,
+  formatLongDate,
   sortErrorsBySectionOrder
 } from './base-presenter.js'
 
@@ -25,6 +26,7 @@ export const presenters = {
   formatBackLink,
   formatNumber,
   formatDateInputValues,
+  formatLongDate,
   formatDisplayAddress,
   formatOriginalAddress,
   formatChangedAddress,