feat: Introduce Inline Time Format for Machine-Readable Dates and Time

packages/format-library/package.json

@@ -39,7 +39,8 @@
 		"@wordpress/icons": "*",
 		"@wordpress/private-apis": "*",
 		"@wordpress/rich-text": "*",
-		"@wordpress/url": "*"
+		"@wordpress/url": "*",
+		"locutus": "2.0.32"
 	},
 	"peerDependencies": {
 		"react": "^18.0.0",

packages/format-library/src/default-formats.js

@@ -9,6 +9,7 @@ import { link } from './link';
 import { strikethrough } from './strikethrough';
 import { underline } from './underline';
 import { textColor } from './text-color';
+import { time } from './time';
 import { subscript } from './subscript';
 import { superscript } from './superscript';
 import { keyboard } from './keyboard';
@@ -25,6 +26,7 @@ export default [
 	strikethrough,
 	underline,
 	textColor,
+	time,
 	subscript,
 	superscript,
 	keyboard,

packages/format-library/src/time/index.js

@@ -0,0 +1,98 @@
+/**
+ * External dependencies
+ */
+import { gmdate, strtotime } from 'locutus/php/datetime';
+
+/**
+ * WordPress dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { toggleFormat } from '@wordpress/rich-text';
+import {
+	RichTextToolbarButton,
+	RichTextShortcut,
+} from '@wordpress/block-editor';
+import { postDate as icon } from '@wordpress/icons';
+
+const name = 'core/time';
+const title = __( 'Time' );
+
+export const time = {
+	name,
+	title,
+	tagName: 'time',
+	className: null,
+	attributes: {
+		datetime: 'datetime',
+	},
+	edit( { isActive, value, onChange, onFocus } ) {
+		function onClick() {
+			const dateDescription = value.text
+				.slice( value.start, value.end )
+				.trim();
+
+			// Exit early if no selection or format is already active
+			if ( ! dateDescription || isActive ) {
+				onChange(
+					toggleFormat( value, {
+						type: name,
+					} )
+				);
+				return;
+			}
+
+			// Clean up the date string
+			const dateCleaned = dateDescription
+				.replace( 'at ', '' ) // Remove "at"
+				.replace( 'UTC', 'GMT' ); // Replace "UTC" with "GMT"
+
+			// Parse the date string using strtotime
+			const timestamp = strtotime( dateCleaned );
+
+			// If parsing fails, toggle format without enhancement
+			if ( ! timestamp ) {
+				onChange(
+					toggleFormat( value, {
+						type: name,
+					} )
+				);
+				return;
+			}
+
+			// Format the datetime attributes using gmdate
+			const datetime = gmdate( 'c', timestamp ); // ISO 8601 format
+			const datetimeISO = gmdate( 'Ymd\\THi', timestamp ); // Compact ISO format
+
+			// Apply the format with parsed datetime attributes
+			onChange(
+				toggleFormat( value, {
+					type: name,
+					attributes: {
+						datetime,
+						'data-iso': datetimeISO,
+						style: 'text-decoration: underline; text-decoration-style: dotted',
+					},
+				} )
+			);
+
+			onFocus();
+		}
+
+		return (
+			<>
+				<RichTextShortcut
+					type="access"
+					character="d"
+					onUse={ onClick }
+				/>
+				<RichTextToolbarButton
+					icon={ icon }
+					title={ title }
+					onClick={ onClick }
+					isActive={ isActive }
+					role="menuitemcheckbox"
+				/>
+			</>
+		);
+	},
+};