Configuration
=============

To display dates, this bundle uses timezone detectors to get the
current timezone.

Timezone detectors
------------------

User timezone detector
^^^^^^^^^^^^^^^^^^^^^^

If the SonataUserBundle_ is enabled, it returns the timezone from the
``Sonata\UserBundle\Model\User::getTimezone()`` method.

Locale timezone detector
^^^^^^^^^^^^^^^^^^^^^^^^

The timezone is guessed from the current request locale. You can
configure the locale / timezone mapping in the configuration:

.. configuration-block::

    .. code-block:: yaml

        # app/config/config.yml

        sonata_intl:
            timezone:
                locales:
                    fr:    Europe/Paris
                    en_UK: Europe/London

Configure timezone detectors
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

By default, ``user`` then ``locale`` timezone detectors are used. You
can change the order in the configuration:

.. configuration-block::

    .. code-block:: yaml

        # app/config/config.yml

        sonata_intl:
            timezone:
                detectors:
                    - sonata.intl.timezone_detector.user
                    - sonata.intl.timezone_detector.locale

**IMPORTANT** In order to guess the timezone, the detectors will be
called **in the order they are declared**.

Default timezone
^^^^^^^^^^^^^^^^

If no timezone was returned by any detector, a default one will be
returned (from the ``date_default_timezone_get()`` method, configurable
in the ``php.ini`` file).

You can override this default timezone in the configuration:

.. configuration-block::

    .. code-block:: yaml

        # app/config/config.yml

        sonata_intl:
            timezone:
                default: Europe/Paris

.. _SonataUserBundle: https://sonata-project.org/bundles/user/2-2/doc/index.html