From cb765ab09d709482f495c630708aa36be7d0eebd Mon Sep 17 00:00:00 2001 From: bscheshirwork Date: Tue, 19 Dec 2017 22:08:08 +0300 Subject: [PATCH] Updated info about setting timezone in the guide (#14689) [skip ci] --- docs/guide-ru/output-formatting.md | 21 +++++++++------------ docs/guide-ru/runtime-logging.md | 4 +++- docs/guide/output-formatting.md | 7 +++++-- docs/guide/runtime-logging.md | 3 ++- 4 files changed, 19 insertions(+), 16 deletions(-) diff --git a/docs/guide-ru/output-formatting.md b/docs/guide-ru/output-formatting.md index 4afb759acb..395f06fc4c 100644 --- a/docs/guide-ru/output-formatting.md +++ b/docs/guide-ru/output-formatting.md @@ -36,9 +36,8 @@ Formatter может быть использован двумя различны [[yii\i18n\Formatter::locale|locale]]. Если оно не было настроено, то в качестве локали будет использован [[yii\base\Application::language|язык приложения]]. Подробнее смотрите в разделе «[интернационализация](tutorial-i18n.md)». Компонент форматирования будет выбирать корректный формат для даты и чисел в соответствии с локалью, включая имена -месяцев и дней недели, переведённые на текущий язык. Форматирование дат также зависит от -[[yii\i18n\Formatter::timeZone|часового пояса]], которая -также будет из свойства [[yii\base\Application::timeZone|timeZone]] приложения, если она не была задана явно. +месяцев и дней недели, переведённые на текущий язык. +Форматирование дат также зависит от [[yii\i18n\Formatter::timeZone|часового пояса]], который будет взят из одноимённого свойства [[yii\base\Application::timeZone|timeZone]] приложения, если не был задан явно. В свою очередь [[yii\base\Application::timeZone|timeZone]] устанавливает / читает временную зону PHP. Например, форматирование даты, вызванное с разной локалью, отобразит разные результаты:: @@ -140,16 +139,14 @@ echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00 echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00 ``` -Начиная с версии 2.0.1 стало возможно настраивать часовой пояс для предполагаемых timestamp, которые не включают в себя -часовой пояс, как во втором примере в коде выше. Вы можете задать [[yii\i18n\Formatter::defaultTimeZone]] часовым поясом, -который вы используете для хранения данных. - -> Note: Поскольку часовые пояса являются субъектом ответственности правительств по всему миру и могут часто меняться, -> это значит, что вы, вероятно, не имеете самую свежую информацию в базе данных часовых поясов, установленной на вашем сервере. -> Вы можете обратиться к [ICU руководству](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data) -> для получения подробностей об обновлении базы данных часовых поясов. -> См. также: [Настройка вашего PHP окружения для интернационализации](tutorial-i18n.md#setup-environment). +Если [[yii\i18n\Formatter::timeZone|часовой пояс форматтера]] не задан явно, используется +[[yii\base\Application::timeZone|часовой пояс приложения]], то есть тот же, что задан в +конфигурации PHP. +> Note: Поскольку правила для часовых поясов принимаются различными правительствами и могут часто меняться, +> вероятно, информация в базе данных часовых поясов на вашем сервере не самая свежая. +> Как обновить базу вы можете узнать из [руководства ICU](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data). +> Смотрите также: [Настройка вашего PHP окружения для интернационализации](tutorial-i18n.md#setup-environment). Форматирование чисел ------------------ diff --git a/docs/guide-ru/runtime-logging.md b/docs/guide-ru/runtime-logging.md index d9a4059828..cf7bcb1cb0 100644 --- a/docs/guide-ru/runtime-logging.md +++ b/docs/guide-ru/runtime-logging.md @@ -49,7 +49,9 @@ Yii::trace('начало вычисления среднего дохода', __ return [ // Компонент "log" должен быть загружен на этапе предзагрузки 'bootstrap' => ['log'], - + // Компонент "log" обрабатывает сообщения с меткой времени timestamp. + // Задайте временную зону для создания корректных меток времени. + 'timeZone' => 'Europe/Moscow', 'components' => [ 'log' => [ 'targets' => [ diff --git a/docs/guide/output-formatting.md b/docs/guide/output-formatting.md index 58134d617d..2d9291afd8 100644 --- a/docs/guide/output-formatting.md +++ b/docs/guide/output-formatting.md @@ -144,12 +144,15 @@ echo Yii::$app->formatter->asTime('2014-10-06 12:41:00'); // 14:41:00 echo Yii::$app->formatter->asTime('2014-10-06 14:41:00 CEST'); // 14:41:00 ``` +If the [[yii\i18n\Formatter::timeZone|time zone]] is not set explicitly on the formatter component, the +[[yii\base\Application::timeZone|time zone configured in the application]] is used, which is the same time zone +as set in the PHP configuration. + > Note: As time zones are subject to rules made by the governments around the world and may change frequently, it is > likely that you do not have the latest information in the time zone database installed on your system. > You may refer to the [ICU manual](http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data) > for details on updating the time zone database. Please also read -> [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment). - +> [Setting up your PHP environment for internationalization](tutorial-i18n.md#setup-environment). ## Formatting Numbers diff --git a/docs/guide/runtime-logging.md b/docs/guide/runtime-logging.md index b011bd04b4..6b52cff9d5 100644 --- a/docs/guide/runtime-logging.md +++ b/docs/guide/runtime-logging.md @@ -70,7 +70,8 @@ in the application configuration, like the following: return [ // the "log" component must be loaded during bootstrapping time 'bootstrap' => ['log'], - + // the "log" component process messages with timestamp. Set PHP timezone to create correct timestamp + 'timeZone' => 'America/Los_Angeles', 'components' => [ 'log' => [ 'targets' => [