Date: Mark getSettings as experimental

docs/reference/deprecated.md

@@ -1,5 +1,8 @@
 Gutenberg's deprecation policy is intended to support backwards-compatibility for releases, when possible. The current deprecations are listed below and are grouped by _the version at which they will be removed completely_. If your plugin depends on these behaviors, you must update to the recommended alternative before the noted version.
 
+# 4.4.0
+ - `wp.date.getSettings` has been removed. Please use `wp.date.__experimentalGetSettings` instead.
+
 # 4.3.0
 
 - `isEditorSidebarPanelOpened` selector (`core/edit-post`) has been removed. Please use `isEditorPanelEnabled` instead.
@@ -23,6 +26,7 @@ Gutenberg's deprecation policy is intended to support backwards-compatibility fo
 - `wp.components.CodeEditor` has been removed. Used `wp.codeEditor` directly instead.
 - `wp.blocks.setUnknownTypeHandlerName` has been removed. Please use `setFreeformContentHandlerName` and `setUnregisteredTypeHandlerName` instead.
 - `wp.blocks.getUnknownTypeHandlerName` has been removed. Please use `getFreeformContentHandlerName` and `getUnregisteredTypeHandlerName` instead.
+- `wp.date.getSettings` has been removed. Please use `wp.date.__experimentalGetSettings` instead.
 
 ## 4.1.0
 

packages/block-library/src/latest-posts/edit.js

@@ -18,7 +18,7 @@ import {
 	Toolbar,
 } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
-import { dateI18n, format, getSettings } from '@wordpress/date';
+import { dateI18n, format, __experimentalGetSettings } from '@wordpress/date';
 import { decodeEntities } from '@wordpress/html-entities';
 import {
 	InspectorControls,
@@ -116,7 +116,7 @@ class LatestPostsEdit extends Component {
 			},
 		];
 
-		const dateFormat = getSettings().formats.date;
+		const dateFormat = __experimentalGetSettings().formats.date;
 
 		return (
 			<Fragment>

packages/components/src/date-time/README.md

@@ -8,13 +8,13 @@ Render a DateTimePicker.
 
 ```jsx
 import { DateTimePicker } from '@wordpress/components';
-import { getSettings } from '@wordpress/date';
+import { __experimentalGetSettings } from '@wordpress/date';
 import { withState } from '@wordpress/compose';
 
 const MyDateTimePicker = withState( {
 	date: new Date(),
 } )( ( { date, setState } ) => {
-	const settings = getSettings();
+	const settings = __experimentalGetSettings();
 
 	// To know if the current timezone is a 12 hour time with look for an "a" in the time format.
 	// We also make sure this a is not escaped by a "/".

packages/date/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 2.2.0 (2018-10-24)
+
+### Breaking Change
+
+- Marked getSettings as experimental 
+
 ## 2.1.0 (2018-09-26)
 
 ### New Features

packages/date/src/index.js

@@ -5,6 +5,11 @@ import momentLib from 'moment';
 import 'moment-timezone';
 import 'moment-timezone/moment-timezone-utils';
 
+/**
+ * WordPress dependencies
+ */
+import deprecated from '@wordpress/deprecated';
+
 // Changes made here will likely need to be made in `lib/client-assets.php` as
 // well because it uses the `setSettings()` function to change these settings.
 let settings = {
@@ -85,7 +90,18 @@ export function setSettings( dateSettings ) {
  *
  * @return {Object} Settings, including locale data.
  */
+export function __experimentalGetSettings() {
+	return settings;
+}
+
+// deprecations
 export function getSettings() {
+	deprecated( 'wp.date.getSettings', {
+		version: '4.4',
+		alternative: 'wp.date.__experimentalGetSettings',
+		plugin: 'Gutenberg',
+		hint: 'Unstable APIs are strongly discouraged to be used, and are subject to removal without notice.',
+	} );
 	return settings;
 }
 

packages/editor/src/components/post-schedule/index.js

@@ -1,13 +1,13 @@
 /**
  * WordPress dependencies
  */
-import { getSettings } from '@wordpress/date';
+import { __experimentalGetSettings } from '@wordpress/date';
 import { withSelect, withDispatch } from '@wordpress/data';
 import { compose } from '@wordpress/compose';
 import { DateTimePicker } from '@wordpress/components';
 
 export function PostSchedule( { date, onUpdateDate } ) {
-	const settings = getSettings();
+	const settings = __experimentalGetSettings();
 	// To know if the current timezone is a 12 hour time with look for "a" in the time format
 	// We also make sure this a is not escaped by a "/"
 	const is12HourTime = /a(?!\\)/i.test(

packages/editor/src/components/post-schedule/label.js

@@ -2,11 +2,11 @@
  * WordPress dependencies
  */
 import { __ } from '@wordpress/i18n';
-import { dateI18n, getSettings } from '@wordpress/date';
+import { dateI18n, __experimentalGetSettings } from '@wordpress/date';
 import { withSelect } from '@wordpress/data';
 
 export function PostScheduleLabel( { date, isFloating } ) {
-	const settings = getSettings();
+	const settings = __experimentalGetSettings();
 
 	return date && ! isFloating ?
 		dateI18n( settings.formats.datetimeAbbreviated, date ) :