Как использовать функцию WP_TIMEZONE_STRING() для получения временной зоны │ WordPress 5.3.0

# WP_TIMEZONE_STRING() │ WP 5.3.0

Функция WP_TIMEZONE_STRING() позволяет получить строку, представляющую временную зону, настроенную на вашем сайте.

## Описание

Функция использует опцию timezone_string, чтобы вернуть корректное название временной зоны, если оно доступно. Если опция не задана, функция возвращает ручной смещение UTC ±.

### Примеры возвращаемых значений:

- 'Europe/Rome'
- 'America/North_Dakota/New_Salem'
- 'UTC'
- '-06:30'
- '+00:00'
- '+08:45'

**Используется в:** wp_timezone()

**Время выполнения:** 
- 1 раз — 0.0030341 сек (очень медленно) 
- 50000 раз — 1.60 сек (быстро)

**Не имеет хуков.**

## Возвращаемое значение

Строка. Название временной зоны в PHP или смещение ±HH:MM.

## Использование

```php
wp_timezone_string();

Примеры

Пример 1

echo wp_timezone_string(); // Asia/Tashkent

Пример 2

// Если опция timezone_string пустая
echo wp_timezone_string(); // +02:00

Изменения

• С версии 5.3.0 — Функция была добавлена.

Код функции

Функция wp_timezone_string() реализована в файле wp-includes/functions.php. Вот ее код:

function wp_timezone_string() {
$timezone_string = get_option('timezone_string');

if ($timezone_string) {
    return $timezone_string;
}

$offset  = (float) get_option('gmt_offset');
$hours   = (int) $offset;
$minutes = ($offset - $hours);

$sign      = ($offset < 0) ? '-' : '+';
$abs_hour  = abs($hours);
$abs_mins  = abs($minutes * 60);
$tz_offset = sprintf('%s%02d:%02d', $sign, $abs_hour, $abs_mins);

return $tz_offset;

}

Связанные функции

В WordPress также есть и другие функции для работы с датами и временем:

• comment_date()
• comment_time()
• current_time()
• date_i18n()
• get_comment_date()
• get_comment_time()
• get_date_from_gmt()
• get_gmt_from_date()
• get_lastpostdate()
• get_lastpostmodified()
• get_post_time()
• get_post_timestamp()
• get_the_date()
• get_the_modified_date()
• get_the_modified_time()
• get_the_time()
• get_weekstartend()
• mysql2date()
• the_date()
• the_time()
• wp_checkdate()
• wp_date()
• wp_maybe_decline_date()
• wp_timezone()
• wp_timezone_choice()