@brightspace-ui/intl 3.5.1 → 3.7.0

package/README.md

@@ -95,7 +95,7 @@ const date = formatDateTime(
 Options:
 - **format**: pattern to use when rendering the date-time; default is `'short'`.
   - **full**: long weekday, month names and timezone. e.g. `'Wednesday, September 23, 2015 1:25 PM EST'`
-  - **medium**: long month names. e.g. `'September 23, 2015 1:25 PM'`
+  - **medium**: short month names. e.g. `'Sept 23, 2015 1:25 PM'`
   - **short**: abbreviated date format. e.g. `'9/23/2015 1:25 PM'`
 
 To format a **timestamp** as a date and time:
@@ -110,6 +110,30 @@ const dateString = formatDateTimeFromTimestamp(
 Options are the same as for `formatDateTime`; this method converts the timestamp to a `Date` in the user's
 configured time zone, then returns the results of passing this date to `formatDateTime`.
 
+To format a **timestamp** as a date only:
+
+```javascript
+const dateString = formatDateFromTimestamp(
+	1607097863123,
+	[options]
+);
+```
+
+Options are the same as for `formatDate`; this method converts the timestamp to a `Date` in the user's
+configured time zone, then returns the results of passing this date to `formatDate`.
+
+To format a **timestamp** as a time only:
+
+```javascript
+const timeString = formatTimeFromTimestamp(
+	1607097863123,
+	[options]
+);
+```
+
+Options are the same as for `formatTime`; this method converts the timestamp to a `Date` in the user's
+configured time zone, then returns the results of passing this date to `formatTime`.
+
 To format a **date only** (without the time portion), use `formatDate`:
 
 ```javascript
@@ -226,7 +250,7 @@ Contributions are welcome, please submit a pull request!
 
 ## Versioning & Releasing
 
-> TL;DR: Commits prefixed with `fix:` and `feat:` will trigger patch and minor releases when merged to `master`. Read on for more details...
+> TL;DR: Commits prefixed with `fix:` and `feat:` will trigger patch and minor releases when merged to `main`. Read on for more details...
 
 The [sematic-release GitHub Action](https://github.com/BrightspaceUI/actions/tree/master/semantic-release) is called from the `release.yml` GitHub Action workflow to handle version changes and releasing.
 

package/lib/common.js

@@ -121,6 +121,7 @@ class DocumentLocaleSettings {
 			}
 		}
 		this._overrides = val;
+		this._listeners.forEach((cb) => cb());
 	}
 
 	addChangeListener(cb) {
@@ -151,6 +152,7 @@ class DocumentLocaleSettings {
 	}
 
 	_handleObserverChange(mutations) {
+		let localeAttributeChange = false;
 		for (let i = 0; i < mutations.length; i++) {
 			const mutation = mutations[i];
 			if (mutation.attributeName === 'lang') {
@@ -161,10 +163,13 @@ class DocumentLocaleSettings {
 				this.overrides = this._tryParseHtmlElemAttr('data-intl-overrides', {});
 			} else if (mutation.attributeName === 'data-timezone') {
 				this.timezone = this._tryParseHtmlElemAttr('data-timezone', { name: '', identifier: '' });
+				localeAttributeChange = true;
 			} else if (mutation.attributeName === 'data-oslo') {
 				this.oslo = this._tryParseHtmlElemAttr('data-oslo', { batch: null, collection: null, version: null });
+				localeAttributeChange = true;
 			}
 		}
+		if (localeAttributeChange) this._listeners.forEach((cb) => cb());
 	}
 
 	_normalize(langTag) {

package/lib/dateTime.js

@@ -1128,10 +1128,24 @@ export function formatDateTime(date, options) {
 
 }
 
-export function formatDateTimeFromTimestamp(timestamp, options) {
+function parseLocalDateTimeFromTimestamp(timestamp) {
 	const utcDate = new Date(timestamp);
 	const local = convertJsDateToLocalDateTime(utcDate);
-	if (!local) return formatDateTime(utcDate, options);
-	const localDate = new Date(local.year, local.month - 1, local.date, local.hours, local.minutes, local.seconds);
-	return formatDateTime(localDate, options);
+	if (!local) return utcDate;
+	return new Date(local.year, local.month - 1, local.date, local.hours, local.minutes, local.seconds);
+}
+
+export function formatDateTimeFromTimestamp(timestamp, options) {
+	const date = parseLocalDateTimeFromTimestamp(timestamp);
+	return formatDateTime(date, options);
+}
+
+export function formatDateFromTimestamp(timestamp, options) {
+	const date = parseLocalDateTimeFromTimestamp(timestamp);
+	return formatDate(date, options);
+}
+
+export function formatTimeFromTimestamp(timestamp, options) {
+	const date = parseLocalDateTimeFromTimestamp(timestamp);
+	return formatTime(date, options);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspace-ui/intl",
-  "version": "3.5.1",
+  "version": "3.7.0",
   "description": "Internationalization APIs for number, date, time and file size formatting and parsing in D2L Brightspace.",
   "main": "lib/number.js",
   "scripts": {
@@ -40,10 +40,10 @@
     "chai": "^4",
     "concurrently": "^6",
     "eslint": "^7",
-    "eslint-config-brightspace": "^0.14",
+    "eslint-config-brightspace": "^0.16",
     "eslint-plugin-html": "^6",
     "eslint-plugin-sort-class-members": "^1",
-    "http-server": "^0.12",
+    "http-server": "^14.0",
     "mocha": "^9",
     "mocha-headless-chrome": "^3"
   }