Skip to content
This repository was archived by the owner on Mar 14, 2018. It is now read-only.

Commit cb765ab

Browse files
bscheshirworksamdark
authored andcommitted
Updated info about setting timezone in the guide (yiisoft#14689) [skip ci]
1 parent 04891af commit cb765ab

File tree

4 files changed

+19
-16
lines changed

4 files changed

+19
-16
lines changed

docs/guide-ru/output-formatting.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,8 @@ Formatter может быть использован двумя различны
3636
[[yii\i18n\Formatter::locale|locale]]. Если оно не было настроено, то в качестве локали будет использован
3737
[[yii\base\Application::language|язык приложения]]. Подробнее смотрите в разделе «[интернационализация](tutorial-i18n.md)».
3838
Компонент форматирования будет выбирать корректный формат для даты и чисел в соответствии с локалью, включая имена
39-
месяцев и дней недели, переведённые на текущий язык. Форматирование дат также зависит от
40-
[[yii\i18n\Formatter::timeZone|часового пояса]], которая
41-
также будет из свойства [[yii\base\Application::timeZone|timeZone]] приложения, если она не была задана явно.
39+
месяцев и дней недели, переведённые на текущий язык.
40+
Форматирование дат также зависит от [[yii\i18n\Formatter::timeZone|часового пояса]], который будет взят из одноимённого свойства [[yii\base\Application::timeZone|timeZone]] приложения, если не был задан явно. В свою очередь [[yii\base\Application::timeZone|timeZone]] устанавливает / читает временную зону PHP.
4241

4342
Например, форматирование даты, вызванное с разной локалью, отобразит разные результаты::
4443

@@ -140,16 +139,14 @@ echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00
140139
echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00
141140
```
142141

143-
Начиная с версии 2.0.1 стало возможно настраивать часовой пояс для предполагаемых timestamp, которые не включают в себя
144-
часовой пояс, как во втором примере в коде выше. Вы можете задать [[yii\i18n\Formatter::defaultTimeZone]] часовым поясом,
145-
который вы используете для хранения данных.
146-
147-
> Note: Поскольку часовые пояса являются субъектом ответственности правительств по всему миру и могут часто меняться,
148-
> это значит, что вы, вероятно, не имеете самую свежую информацию в базе данных часовых поясов, установленной на вашем сервере.
149-
> Вы можете обратиться к [ICU руководству](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data)
150-
> для получения подробностей об обновлении базы данных часовых поясов.
151-
> См. также: [Настройка вашего PHP окружения для интернационализации](tutorial-i18n.md#setup-environment).
142+
Если [[yii\i18n\Formatter::timeZone|часовой пояс форматтера]] не задан явно, используется
143+
[[yii\base\Application::timeZone|часовой пояс приложения]], то есть тот же, что задан в
144+
конфигурации PHP.
152145

146+
> Note: Поскольку правила для часовых поясов принимаются различными правительствами и могут часто меняться,
147+
> вероятно, информация в базе данных часовых поясов на вашем сервере не самая свежая.
148+
> Как обновить базу вы можете узнать из [руководства ICU](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data).
149+
> Смотрите также: [Настройка вашего PHP окружения для интернационализации](tutorial-i18n.md#setup-environment).
153150
154151
Форматирование чисел <span id="numbers"></span>
155152
------------------

docs/guide-ru/runtime-logging.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,9 @@ Yii::trace('начало вычисления среднего дохода', __
4949
return [
5050
// Компонент "log" должен быть загружен на этапе предзагрузки
5151
'bootstrap' => ['log'],
52-
52+
// Компонент "log" обрабатывает сообщения с меткой времени timestamp.
53+
// Задайте временную зону для создания корректных меток времени.
54+
'timeZone' => 'Europe/Moscow',
5355
'components' => [
5456
'log' => [
5557
'targets' => [

docs/guide/output-formatting.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -144,12 +144,15 @@ echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00
144144
echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00
145145
```
146146
147+
If the [[yii\i18n\Formatter::timeZone|time zone]] is not set explicitly on the formatter component, the
148+
[[yii\base\Application::timeZone|time zone configured in the application]] is used, which is the same time zone
149+
as set in the PHP configuration.
150+
147151
> Note: As time zones are subject to rules made by the governments around the world and may change frequently, it is
148152
> likely that you do not have the latest information in the time zone database installed on your system.
149153
> You may refer to the [ICU manual](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data)
150154
> for details on updating the time zone database. Please also read
151-
> [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment).
152-
155+
> [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment).
153156
154157
## Formatting Numbers <span id="numbers"></span>
155158

docs/guide/runtime-logging.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,8 @@ in the application configuration, like the following:
7070
return [
7171
// the "log" component must be loaded during bootstrapping time
7272
'bootstrap' => ['log'],
73-
73+
// the "log" component process messages with timestamp. Set PHP timezone to create correct timestamp
74+
'timeZone' => 'America/Los_Angeles',
7475
'components' => [
7576
'log' => [
7677
'targets' => [

0 commit comments

Comments
 (0)