@@ -23,7 +23,7 @@ Basic Usage
23
23
-----------
24
24
25
25
Suppose you have a ``UserSettings `` class, with a ``timezone `` field that is a
26
- string meant to contain a `PHP timezone identifier `_ (e.g. ``America/New_York ``):
26
+ string which contains any of the `PHP timezone identifiers `_ (e.g. ``America/New_York ``):
27
27
28
28
.. configuration-block ::
29
29
@@ -103,10 +103,15 @@ The value of this option must be a valid `ISO 3166-1 alpha-2`_ country code
103
103
intlCompatible
104
104
~~~~~~~~~~~~~~
105
105
106
- **type **: ``boolean `` **default **: `` false ``
106
+ **type **: ``boolean `` **default **: depends on your application
107
107
108
- If ``true ``, this constraint also considers valid any of the
109
- :ref: `ICU timezones <component-inlt-timezones >` provided by the Intl component.
108
+ If ``false ``, only the `PHP timezone identifiers `_ are considered valid. If
109
+ ``true ``, the :ref: `ICU timezones <component-inlt-timezones >` provided by the
110
+ Intl component are considered valid too.
111
+
112
+ The default value of this option depends on your application. If the
113
+ :doc: `Intl component </components/intl >` is available in the application, the
114
+ default value is ``true ``; otherwise, it's ``false `` by default.
110
115
111
116
message
112
117
~~~~~~~
@@ -152,6 +157,6 @@ In addition, there are some special zone values:
152
157
* ``\DateTimeZone::PER_COUNTRY `` restricts the valid timezones to a certain
153
158
country (which is defined using the ``countryCode `` option).
154
159
155
- .. _`PHP timezone identifier ` : https://www.php.net/manual/en/timezones.php
160
+ .. _`PHP timezone identifiers ` : https://www.php.net/manual/en/timezones.php
156
161
.. _`DateTimeZone` : https://www.php.net/datetimezone
157
162
.. _`ISO 3166-1 alpha-2` : https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
0 commit comments