SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor · Оновлено 2026-11-20

n8n: часовий пояс і тригер розкладу

Дізнайтеся, чому n8n запускає workflow не в ту годину: Schedule Trigger використовує часовий пояс workflow або інстансу, а GENERIC_TIMEZONE і TZ мають різні ролі.

Чому тригер розкладу n8n спрацьовує не в ту годину

Тригер розкладу n8n спрацьовує не в ту годину, коли визначений для нього часовий пояс відрізняється від потрібного. Тригери розкладу використовують часовий пояс workflow, якщо його задано. Інакше використовується часовий пояс інстансу з GENERIC_TIMEZONE. Встановлення часового поясу workflow може повністю виправити розклад цього workflow. Власна змінна контейнера TZ окремо керує системним часовим поясом контейнера.

Спочатку виправте поширене припущення. Новий self-hosted n8n не планує виконання в UTC (координований всесвітній час). Планування працює як окремий рівень. Згідно з документацією n8n, типовим значенням для GENERIC_TIMEZONE є America/New_York (станом на November 19, 2026). Тому незмінений інстанс запускає свої тригери розкладу за часом Нью-Йорка. Через це зафіксоване зміщення рідко відповідає різниці користувача з UTC. Власник у Берліні, який задає 06:00, отримує запуск о 12:00 за місцевим часом, а протягом тижнів у березні та тижня на межі жовтня і листопада — о 11:00, коли у Сполучених Штатах діє літній час, а в Європі — ні.

Три рівні часового поясу та порядок їхнього пріоритету

TZ — це часовий пояс операційної системи всередині контейнера. Документація n8n описує його як змінну, що встановлює системний часовий пояс і визначає результат команд і скриптів, зокрема date. Він визначає, що повертає date усередині контейнера, а також який часовий пояс використовують локальне форматування дат у JavaScript і shell-скрипти. На час спрацювання Schedule Trigger він не впливає.

GENERIC_TIMEZONE — це часовий пояс інстансу n8n. Документація називає його часовим поясом інстансу n8n і зазначає, що він важливий для вузлів планування, наприклад Cron. Тут Cron означає стандартний синтаксис планування за часом. У n8n він доступний як параметр Custom (Cron) у Schedule Trigger.

Часовий пояс workflow задається окремо для кожного workflow. Відкрийте workflow на canvas, виберіть три крапки у верхньому правому куті, виберіть Settings, а потім змініть значення Timezone. Для цього workflow він має пріоритет над GENERIC_TIMEZONE. Усі налаштування на цій сторінці належать безкоштовній self-hosted збірці. Тому для коректної роботи розкладів paid plan не потрібен, а функції, для яких потрібен license key, становлять окремий перелік.

Для Schedule Trigger порядок фіксований. n8n використовує часовий пояс workflow, якщо його задано. Інакше використовується часовий пояс інстансу зі GENERIC_TIMEZONE. Якщо його також не задано, n8n використовує вбудоване значення за замовчуванням America/New_York. TZ на жодному етапі цього вибору не враховується.

Для дат усередині вузлів результат залежить від того, який час запитує код. Luxon — бібліотека дат, що використовується у виразах n8n, — застосовує часовий пояс n8n. Тому $now і $today використовують такий самий порядок: спочатку workflow, потім instance, як і тригер. Звичайний JavaScript new Date() представляє момент часу. Локальне форматування, наприклад .toString(), використовує системний часовий пояс runtime, а не часовий пояс workflow. Через це тригер може спрацьовувати правильно, а timestamp, відформатований за локальним системним часом, може показувати іншу годину.

Укажіть усі три параметри у Compose-файлі

Розмістіть TZ і GENERIC_TIMEZONE поруч у файлі, щоб ніхто не вказав один параметр і не забув про інший. Наведений нижче фрагмент містить частину робочого сервісу, що стосується часового поясу. Решта файлу, reverse proxy і сертифікат наведені в матеріалі про self-hosted n8n на VPS за HTTPS.

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - GENERIC_TIMEZONE=Europe/Berlin
      - TZ=Europe/Berlin
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Застосуйте зміни за допомогою docker compose up -d, а не docker compose restart. Перезапуск запускає той самий контейнер із середовищем, з яким його було створено, тому зміни у файлі не змінюють середовище запущеного процесу. up -d бачить змінене середовище та повторно створює контейнер. Якщо ви зберігаєте ці значення в env-файлі, а не задаєте їх безпосередньо, застосовується те саме правило повторного створення. У посібнику про env-файл Compose і роботу із секретами описано, звідки читається цей файл.

Укажіть у Region/City назву зони IANA (Internet Assigned Numbers Authority), наприклад Europe/Berlin або America/Sao_Paulo. Такі назви містять правила переходу на літній час для відповідної місцевості, тому зміщення змінюється разом із місцевим часом. Назва з фіксованим зміщенням, наприклад Etc/GMT+5, не змінюється залежно від пори року, а її знак інвертований порівняно з очікуваним. Виконайте LC_ALL=C TZ=Etc/GMT+5 date +%z — команда виведе -0500. Не використовуйте такі назви.

Чому налаштування лише одного параметра виправляє проблему лише частково

Саме налаштування часового поясу workflow повністю виправляє часовий пояс планування цього workflow. Установіть лише GENERIC_TIMEZONE — і Schedule Triggers без перевизначення на рівні workflow використовуватимуть його, тоді як системний часовий пояс залишиться без змін. Вузол Code, який викликає new Date().toString(), використовує локальний системний час, тому ім’я файлу, сформоване з цих локальних полів дати, може перейти на наступну дату в інший момент опівночі.

Установіть лише TZ — і станеться протилежне. docker compose exec n8n date виведе ваш локальний час, що виглядатиме як успішне виправлення, тоді як Schedule Trigger без налаштованого часового поясу workflow або instance усе ще працюватиме за America/New_York. Саме цей варіант забирає найбільше часу, оскільки перевірка, яку більшість користувачів запускає першою, тепер повертає правильний результат.

Установіть часовий пояс workflow, а потім змініть GENERIC_TIMEZONE — і цей workflow проігнорує зміну. Значення workflow має пріоритет і зберігатиме його, доки хтось не відкриє налаштування цього workflow. Якщо один workflow запускається в незвичний час, а сусідні працюють нормально, майже завжди причина саме в цьому.

Перевірте час на годинниках, а не робіть припущень

Порівняйте час на хості та в контейнері безпосередньо.

date
docker compose exec n8n date
docker compose exec n8n printenv TZ GENERIC_TIMEZONE

Перші дві команди мають вивести однаковий локальний час, якщо хост і контейнер використовують один часовий пояс. printenv виводить по одному рядку для кожної наявної змінної. Тому два рядки означають, що обидві змінні задані, а один рядок — що в середовищі контейнера задана лише одна.

Тепер перевірте сам n8n з робочого процесу, оскільки оболонка контейнера не покаже часовий пояс на рівні робочого процесу. Додайте вузол Code до робочого процесу, який працює неправильно, і один раз запустіть його через Execute Workflow.

return [
  {
    json: {
      n8n_time: $now.toISO(),
      n8n_zone: $now.zoneName,
      system_time: new Date().toString(),
    },
  },
];

n8n_zone — це часовий пояс, який використовуватиме Schedule Trigger цього робочого процесу. Він уже визначений за порядком workflow-then-instance, тому безпосередньо відповідає на запитання. system_time показує локальний часовий пояс середовища виконання JavaScript. Якщо вузол Code працює в окремому контейнері task runner, перевірте часовий пояс і цього контейнера. Запустіть перевірку в робочому процесі, який працює неправильно, а не в новому, оскільки налаштування на рівні робочого процесу зберігається разом із ним. Різні часові пояси пояснюють різницю у відображених годинах. Порівняйте кожен із часовим поясом, який ви планували використовувати.

Вирази cron у вузлі Schedule Trigger

Schedule Trigger пропонує фіксовані інтервали від секунд до місяців, а також режим Custom (Cron) для інших варіантів. Вираз cron обчислюється в часовому поясі, визначеному для workflow, тому 0 6 * * * означає 06:00 у цьому поясі, а не 06:00 UTC. П’ять полів із crontab guru можна вставити без змін. n8n також приймає необов’язкове поле секунд, яке в таблиці полів документації розташоване першим: секунда, хвилина, година, день місяця, місяць, день тижня.

Починаючи з n8n 2.45.0, стандартний durable scheduler відраховує інтервали Seconds і Minutes від моменту публікації workflow, а не від меж годинника. Custom (Cron) зберігає прив’язку до часу на годиннику. Збережіть і опублікуйте workflow, щоб його Schedule Trigger почав виконуватися.

Не кодуйте зміщення вручну. Запис 0 4 * * * на екземплярі з UTC для запуску о 06:00 у Берліні буде правильним улітку, але всю зиму запускатиметься на одну годину раніше, оскільки влітку в Берліні діє UTC+2, а взимку — UTC+1. Від останньої неділі березня до останньої неділі жовтня цей вираз спрацьовує о 06:00 за берлінським часом. Решту року він спрацьовує о 05:00; для запуску о 06:00 тоді потрібен лише 0 5 * * *. Виберіть часовий пояс і вкажіть фактичну локальну годину, яка вам потрібна.

Як перехід на літній час впливає на завдання, заплановане на 02:30

Місцевий час на годиннику не гарантує конкретний момент часу. У Berlin двічі на рік одна година зникає, а інша повторюється, тому це впливає на всі завдання, заплановані в ці години. Продемонструвати відсутню годину можна за допомогою GNU date у Linux, без використання n8n.

LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30'
date: invalid date '2027-03-28 02:30'

Це не помилка в команді. 2027-03-28 годинник у Berlin переходить безпосередньо з 02:00 на 03:00, тому місцевого часу 02:30 цього дня не існує, а GNU date відмовляється перетворювати його на конкретний момент часу. BusyBox date не виконує таку саму перевірку: він передає час до mktime і приймає нормалізований результат, якщо перетворення завершується успішно. Поточний durable scheduler n8n зміщує неіснуючий місцевий час cron уперед, а не пропускає його. Сусідні значення часу коректні: date -d '2027-03-28 01:30' визначається як CET, а date -d '2027-03-28 03:30' — як CEST.

Осінній перехід є дзеркальним відображенням весняного. 2027-10-31 годинник у Berlin переводиться з 03:00 назад на 02:00, тому час 02:30 настає двічі.

LC_ALL=C TZ=Europe/Berlin date -d '2027-10-31 02:30 CEST' '+%s'
LC_ALL=C TZ=Europe/Berlin date -d '2027-10-31 02:30 CET' '+%s'
1824942600
1824946200

Це два різні моменти часу, обидва позначені як місцевий час 02:30, з інтервалом 3600 секунд. Поточний durable scheduler n8n запускає завдання для повторюваного місцевого часу cron один раз. Перенесіть розклад за межі цього інтервалу. У більшості європейських і північноамериканських часових зон небезпечний діапазон — від 00:00 до 03:00 за місцевим часом.

Плануйте інфраструктуру в UTC, а користувачам показуйте місцевий час

Стандартний підхід розділяє два завдання часового поясу. Машинам потрібен стабільний інтервал. Людям потрібен час у зрозумілому форматі.

  • Для завдань, за якими ніхто не стежить, задайте для workflow часовий пояс UTC. Сюди належать резервне копіювання, прогрівання кешу, передавання журналів і створення звітів. UTC усуває переходи на літній час із розкладу; календарні розклади, наприклад щомісячні запуски, усе одно мають нерівні інтервали.
  • Для завдань, результати яких читає людина, зберігайте розклад у UTC і конвертуйте час під час відображення. Для цього достатньо одного виразу: {{ $now.setZone('Europe/Berlin').toFormat('yyyy-MM-dd HH:mm') }} вставляє місцевий час у тіло повідомлення, а тригер залишається стабільним.

Такий самий підхід застосовується і за межами n8n. Якщо частина автоматизації працює як сервіс і таймер systemd на VPS, її рядок OnCalendar використовує системний часовий пояс, якщо у виразі не вказано інший. Якщо всі планувальники працюють у UTC, потрібно запам’ятати одне правило замість чотирьох. Це також важливо для всього, що підсумовує певний період, оскільки workflow AI-агента n8n, якому потрібні дані за вчора, непомітно використає інший календарний день залежно від часового поясу, у якому було виконано обчислення.

Режими відмови та вивід, який ви побачите

Усе запускається приблизно на шість годин раніше або пізніше. Якщо часовий пояс не налаштовано для workflow або instance, застосовується вбудоване значення за замовчуванням America/New_York. docker compose exec n8n printenv GENERIC_TIMEZONE нічого не виводить, якщо цю змінну середовища не задано. Задайте її, а потім створіть контейнер заново.

Ви відредагували Compose-файл, але нічого не змінилося. Ви виконали docker compose restart, тому контейнер зберіг початкове середовище. Виконайте docker compose up -d, а потім перевірте результат за допомогою docker compose exec n8n printenv TZ.

Тригер налаштовано правильно, але часові мітки неправильні. Перевірте форматування: $now використовує часовий пояс workflow, а new Date().toString() — системний часовий пояс JavaScript runtime. Задайте TZ для цього runtime і створіть його контейнер заново, якщо потрібно узгодити локальне форматування.

Один workflow ігнорує налаштування instance. Цей workflow має власний часовий пояс у своїх налаштуваннях, і він має пріоритет над GENERIC_TIMEZONE. Відкрийте canvas, натисніть три крапки, виберіть Settings, Timezone.

Щоденне завдання виконалося в іншу локальну годину після переведення годинника. Запланована година припадає на перехід на літній або зимовий час. Поточний durable scheduler переносить неіснуючі локальні cron-часи вперед і виконує повторювані часи лише один раз. Змініть годину або переведіть цей workflow на UTC.

FAQ

Чому мій тригер розкладу n8n спрацьовує не в ту годину?

Workflow використовує інший часовий пояс, ніж ви припускаєте. n8n спочатку бере часовий пояс workflow, якщо його задано, потім часовий пояс інстансу з GENERIC_TIMEZONE, а якщо їх немає — вбудований часовий пояс America/New_York. Self-hosted інстанс без налаштованого часового поясу workflow або інстансу планує виконання за часом New York, а не UTC. Тому зміщення рідко відповідає вашій власній різниці з UTC. Виконайте docker compose exec n8n printenv GENERIC_TIMEZONE. Відсутність виводу означає, що цю змінну середовища не задано. Також перевірте часовий пояс workflow.

У чому різниця між TZ і GENERIC_TIMEZONE у n8n?

TZ — це часовий пояс операційної системи всередині контейнера. Він визначає результат date у контейнері, а також часовий пояс для форматування локальних дат і виконання скриптів. GENERIC_TIMEZONE — це часовий пояс інстансу n8n. Його використовують вузли розкладу та вирази Luxon, як-от $now, якщо часовий пояс workflow не має пріоритету. Самого часового поясу workflow достатньо, щоб повністю виправити роботу Schedule Trigger. Задайте обидві змінні середовища однаковим значенням, якщо потрібно, щоб форматування системного часу також відповідало часовому поясу інстансу за замовчуванням.

Що краще задати: часовий пояс workflow чи GENERIC_TIMEZONE?

Задайте GENERIC_TIMEZONE як часовий пояс за замовчуванням для всього інстансу. Налаштування окремого workflow використовуйте лише тоді, коли конкретний workflow справді належить до іншого часового поясу. Значення workflow має пріоритет над значенням інстансу. Воно також не змінюється після подальших змін у GENERIC_TIMEZONE, тому забутий переопределений часовий пояс workflow може бути складно виявити через кілька місяців.

Що відбувається із завданням, запланованим на 02:30, коли змінюється час?

Цей локальний час або зникає, або настає двічі. У GNU date команда LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30' повертає date: invalid date '2027-03-28 02:30', оскільки того дня годинник у Berlin переходить з 02:00 на 03:00. BusyBox date приймає нормалізацію, якщо mktime завершується успішно, тому така помилка виникає не в усіх Linux. 2027-10-31 те саме показання годинника відповідає двом моментам часу з різницею в одну годину. Поточний надійний планувальник n8n переносить неіснуючий локальний час cron уперед і виконує завдання, що повторюються, один раз. Не плануйте завдання в локальному часовому діапазоні від 00:00 до 03:00. Або задайте для workflow UTC і конвертуйте час у локальний лише там, де його переглядає користувач.

Чи була ця стаття корисною?