@@ -105,20 +105,33 @@ zone
105
105
106
106
**type **: ``string `` **default **: ``\DateTimeZone::ALL ``
107
107
108
- The geographical zone in which to validate the timezone identifier.
109
-
110
- Value must be any of the `DateTimeZone `_ class constants values.
108
+ Set this option to any of the following constants to restrict the valid timezone
109
+ identifiers to the ones that belong to that geographical zone:
110
+
111
+ * ``\DateTimeZone::AFRICA ``
112
+ * ``\DateTimeZone::AMERICA ``
113
+ * ``\DateTimeZone::ANTARCTICA ``
114
+ * ``\DateTimeZone::ARCTIC ``
115
+ * ``\DateTimeZone::ASIA ``
116
+ * ``\DateTimeZone::ATLANTIC ``
117
+ * ``\DateTimeZone::AUSTRALIA ``
118
+ * ``\DateTimeZone::EUROPE ``
119
+ * ``\DateTimeZone::INDIAN ``
120
+ * ``\DateTimeZone::PACIFIC ``
121
+
122
+ The special ``\DateTimeZone::ALL `` zone accepts any timezone.
111
123
112
124
countryCode
113
125
~~~~~~~~~~~
114
126
115
127
**type **: ``string `` **default **: ``null ``
116
128
117
- This option must be used only when the ``zone `` option value equals ``\DateTimeZone::PER_COUNTRY ``.
118
-
119
- The `` countryCode `` option enables to validate the timezone identifier is supported by the country code .
129
+ If the ``zone `` option is set to ``\DateTimeZone::PER_COUNTRY ``, this option
130
+ restricts the valid timezone identifiers to the ones that belong to the given
131
+ country.
120
132
121
- Value must be a valid `ISO 3166-1 alpha-2 `_ country code (e.g. ``BE ``).
133
+ The value of this option must be a valid `ISO 3166-1 alpha-2 `_ country code
134
+ (e.g. ``CN `` for China).
122
135
123
136
.. _`DateTimeZone` : https://www.php.net/datetimezone
124
137
.. _`ISO 3166-1 alpha-2` : https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
0 commit comments