n8n Zamanlama Tetikleyicisi Saat Dilimi Ayarları
n8n zamanlama tetikleyicilerinin neden yanlış saatte çalıştığını ve GENERIC_TIMEZONE ile TZ değişkenlerinin sistem üzerindeki etkilerini bu rehberde öğrenebilirsiniz.
n8n zamanlama tetikleyicinizin neden yanlış saatte çalıştığı
Bir n8n zamanlama tetikleyicisi, çözümlenen saat dilimi amaçladığınızdan farklı olduğunda yanlış saatte çalışır. Zamanlama Tetikleyicileri, eğer ayarlanmışsa iş akışı saat dilimini, aksi takdirde GENERIC_TIMEZONE içindeki örnek saat dilimini kullanır. Yalnızca iş akışı saat dilimini ayarlamak, o iş akışının zamanlamasını tamamen düzeltebilir; container'ın kendi TZ değişkeni, sistem saat dilimini ayrı olarak kontrol eder.
Önce bir varsayımı düzeltin. Yeni kurulmuş bir self-hosted n8n, zamanlamayı UTC (eşgüdümlü evrensel zaman) bazında yapmaz. Zamanlama ayrı bir katmandır ve n8n'in GENERIC_TIMEZONE için belgelenen varsayılan değeri America/New_York'dur (19 Kasım 2026 itibarıyla); bu nedenle dokunulmamış bir örnek, Zamanlama Tetikleyicilerini New York saatine göre çalıştırır. İnsanların bildirdiği sapmanın kendi UTC uzaklıklarıyla nadiren eşleşmesinin nedeni budur. Berlin'de 06:00 isteyen bir kullanıcı yerel saatle 12:00'de, Amerika Birleşik Devletleri'nde yaz saati uygulaması varken ancak Avrupa'da yokken (Mart ayındaki haftalar ile Ekim ve Kasım dönümü haftasında) ise 11:00'de sonuç alır.
Üç saat dilimi katmanı ve hangisinin öncelikli olduğu
TZ, container içindeki işletim sistemi saat dilimidir. n8n belgeleri bunu, date gibi betiklerin ve komutların ne döndüreceğini kontrol etmek için sistem saat dilimini ayarlayan değişken olarak tanımlar. Container içinde date komutunun ne yazdıracağını ve yerel JavaScript tarih biçimlendirmeleri ile shell betiklerinin hangi saat dilimini kullanacağını belirler. Schedule Trigger tetikleyicisinin ne zaman çalışacağı üzerinde hiçbir etkisi yoktur.
GENERIC_TIMEZONE, n8n örneği (instance) saat dilimidir. Belgeler bunu n8n örneği saat dilimi olarak adlandırır ve Cron gibi zamanlama düğümleri için önemli olduğunu belirtir. Buradaki Cron, standart zaman tabanlı zamanlama sözdizimini ifade eder ve n8n bunu Schedule Trigger üzerinde Custom (Cron) seçeneği olarak sunar.
İş akışı (workflow) saat dilimi, her iş akışı için ayrı ayrı ayarlanır. İş akışını tuval üzerinde açın, sağ üst köşedeki üç noktayı seçin, Settings kısmına girin ve ardından Timezone değerini değiştirin. Bu ayar, ilgili iş akışı için GENERIC_TIMEZONE değerini geçersiz kılar. Bu sayfadaki her ayar ücretsiz self-hosted sürüme aittir; dolayısıyla zamanlamaların doğru çalışması hiçbir şekilde ücretli bir plana bağlı değildir ve lisans anahtarı gerektiren özellikler tamamen farklı bir listedir.
Schedule Trigger için öncelik sırası sabittir. n8n, eğer tanımlanmışsa iş akışı saat dilimini, tanımlanmamışsa GENERIC_TIMEZONE üzerinden gelen örnek saat dilimini, o da yoksa America/New_York olan yerleşik varsayılan değeri kullanır. TZ, bu karar sürecinin hiçbir aşamasında dikkate alınmaz.
Düğümleriniz içindeki tarihler için cevap, kodun hangi saati sorguladığına bağlıdır. n8n ifadelerinin arkasındaki tarih kütüphanesi olan Luxon, n8n saat dilimini kullanır; bu nedenle $now ve $today, tetikleyicide olduğu gibi aynı iş akışı-ardından-örnek sırasını izler. Saf JavaScript new Date() bir anı temsil eder; .toString() gibi yerel biçimlendirmeler ise iş akışı saat dilimi yerine çalışma zamanının sistem saat dilimini kullanır. Bu ayrım, bir tetikleyicinin doğru çalışırken sistem yerel saatine göre biçimlendirilmiş bir zaman damgasının neden farklı bir saat gösterdiğini açıklar.
Üçünü de Compose dosyasında ayarlayın
Kimsenin birini ayarlayıp diğerini unutmaması için TZ ve GENERIC_TIMEZONE ifadelerini dosyada yan yana getirin. Aşağıdaki parça, çalışan bir servisin saat dilimi ile ilgili kısmıdır. Dosyanın geri kalanı, reverse proxy ve sertifika, HTTPS arkasındaki bir VPS üzerinde self-hosted n8n rehberinden alınmıştır.
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:Bunu docker compose restart ile değil, docker compose up -d ile uygulayın. Yeniden başlatma (restart), aynı container'ı oluşturulduğu ortam değişkenleriyle tekrar başlatır; bu nedenle dosya değişiklikleri çalışan sürece yansımaz. up -d ise değişen ortamı görür ve container'ı yeniden oluşturur. Eğer bu değerleri satır içi yerine bir env dosyasında tutuyorsanız, aynı yeniden oluşturma kuralı geçerlidir ve Compose env dosyası ve secret yönetimi rehberi, bu dosyanın nereden okunduğunu açıklamaktadır.
Region/City formunda, Europe/Berlin veya America/Sao_Paulo gibi bir IANA (Internet Assigned Numbers Authority) bölge adı kullanın. Bu isimler, ilgili yerin yaz saati uygulaması kurallarını içerir; bu sayede yerel saatler değiştiğinde saat farkı da otomatik güncellenir. Etc/GMT+5 gibi sabit farka sahip isimler mevsimlerle değişmez ve işaretleri tahmin edeceğinizin tersidir. LC_ALL=C TZ=Etc/GMT+5 date +%z komutunu çalıştırdığınızda -0500 çıktısını verir. Bu isimlerden kaçının.
Neden sadece birini ayarlamak sorunu kısmen çözer
Yalnızca iş akışı saat dilimini ayarlamak, o iş akışının zamanlama saat dilimini tamamen düzeltir. Yalnızca GENERIC_TIMEZONE ayarlandığında, iş akışı geçersiz kılma özelliği olmayan Zamanlama Tetikleyicileri (Schedule Triggers) bu değeri kullanır ancak sistem saat dilimi değişmeden kalır. new Date().toString() çağıran bir Kod düğümü (Code node) yerel sistem saatini kullanır; bu nedenle, bu yerel tarih alanlarından oluşturulan bir dosya adı farklı bir gece yarısında değişebilir.
Yalnızca TZ ayarlandığında ise tam tersi gerçekleşir. docker compose exec n8n date yerel saatinizi yazdırır ve bu durum başarılıymış gibi görünür; oysa iş akışı veya örnek saat dilimi yapılandırılmamış bir Zamanlama Tetikleyicisi hala America/New_York değerindedir. En çok zaman kaybettiren sürüm budur, çünkü çoğu kişinin ilk yaptığı kontrol artık başarılı sonuçlanan kontroldür.
Bir iş akışı saat dilimi ayarlayıp daha sonra GENERIC_TIMEZONE değerini değiştirirseniz, iş akışı bu değişikliği yok sayar. İş akışı değeri önceliklidir ve birisi o iş akışının ayarlarını açana kadar öncelikli kalmaya devam eder. Komşuları düzgün çalışırken tuhaf bir saatte çalışan bir iş akışı, neredeyse her zaman bu durumdan kaynaklanır.
Tahmin etmek yerine saatleri kontrol edin
Ana makine ile container'ı doğrudan karşılaştırın.
date
docker compose exec n8n date
docker compose exec n8n printenv TZ GENERIC_TIMEZONEAna makine ve container aynı saat dilimini kullanıyorsa, ilk iki komut aynı duvar saati zamanını yazdırmalıdır. printenv mevcut her değişken için bir satır yazdırır; dolayısıyla iki satırlık çıktı her ikisinin de ayarlandığı, tek satırlık çıktı ise container ortamında yalnızca birinin ayarlandığı anlamına gelir.
Şimdi n8n'e, bir iş akışının içinden doğrudan sorun; çünkü bir container kabuğu size iş akışı düzeyindeki saat diliminin ne olduğunu söyleyemez. Hatalı çalışan iş akışına bir Code düğümü ekleyin ve Execute Workflow ile bir kez çalıştırın.
return [
{
json: {
n8n_time: $now.toISO(),
n8n_zone: $now.zoneName,
system_time: new Date().toString(),
},
},
];n8n_zone, bu iş akışının Schedule Trigger tetikleyicisinin kullanacağı ve iş akışı-ardından-örnek sırasıyla çözümlenmiş olan bölgedir; bu nedenle soruyu doğrudan yanıtlar. system_time, JavaScript çalışma zamanının yerel saat dilimini gösterir; eğer Code düğümü ayrı bir görev çalıştırıcı container'ında çalışıyorsa, o container'ın saat dilimini de kontrol edin. Bunu yeni bir iş akışında değil, hatalı çalışan iş akışında çalıştırın; çünkü iş akışı düzeyi ayarı iş akışı ile birlikte taşınır. Farklı saat dilimleri, görüntülenen farklı saatleri açıklar; her birini hedeflediğiniz saat dilimiyle karşılaştırın.
Schedule Trigger düğümünde Cron ifadeleri
Schedule Trigger, saniyelerden aylara kadar sabit aralıklar ve bunların kapsamadığı durumlar için Özel (Cron) seçeneği sunar. Cron ifadesi, iş akışının çözümlenmiş saat dilimine göre okunur; bu nedenle 0 6 * * *, UTC 06:00 yerine o saat dilimindeki 06:00 anlamına gelir. crontab guru'dan alınan beş alanlı bir ifade olduğu gibi yapıştırılabilir. n8n, dokümantasyonun alan tablosunda ilk sırada yer alan isteğe bağlı bir saniye alanını da kabul eder: saniye, dakika, saat, ayın günü, ay, haftanın günü.
n8n 2.45.0 sürümünden itibaren, varsayılan kalıcı zamanlayıcı (durable scheduler), Saniye ve Dakika aralıklarını saat sınırlarından ziyade iş akışının yayınlanma anından itibaren ölçer. Özel (Cron) seçeneği ise saat tabanlı zamanlamasını korur. Schedule Trigger'ın çalışması için iş akışını kaydedin ve yayınlayın.
Ofset değerini asla manuel olarak kodlamayın. Berlin'de 06:00'ya ulaşmak için UTC tabanlı bir örnekte 0 4 * * * yazmak yazın doğrudur ancak kışın bir saat erken çalışır; çünkü Berlin yazın UTC+2, kışın ise UTC+1 saat dilimindedir. Mart ayının son Pazar gününden Ekim ayının son Pazar gününe kadar bu ifade Berlin saatiyle 06:00'da tetiklenir, yılın geri kalanında ise sadece 0 5 * * * ifadesinin 06:00'ya ulaşabileceği 05:00'te tetiklenir. Saat dilimini ayarlayın ve gerçekten kastettiğiniz yerel saati yazın.
Yaz saati uygulamasının 02:30'a ayarlanan bir iş üzerindeki etkisi
Yerel duvar saati zamanı, garantili bir anı temsil etmez. Berlin'de yılda iki kez bir saat kaybolur ve bir saat tekrarlanır; bu saatler arasına zamanlanan her iş bu durumdan etkilenir. Kaybolan saati, n8n içermeyen bir Linux üzerinde GNU date ile gösterebilirsiniz.
LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30'date: invalid date '2027-03-28 02:30'Bu komutta bir yazım hatası yoktur. 2027-03-28 tarihinde Berlin saati doğrudan 02:00'den 03:00'e atlar, bu nedenle o gün 02:30 yerel saati mevcut değildir ve GNU date bunu bir ana dönüştürmeyi reddeder. BusyBox date aynı reddetme denetimini gerçekleştirmez: zamanı mktime üzerinden geçirir ve dönüştürme başarılı olursa normalleştirilmiş bir sonucu kabul eder. n8n'in mevcut dayanıklı zamanlayıcısı, mevcut olmayan bir yerel cron zamanını atlamak yerine ileriye kaydırır. Komşu zamanlarda sorun yoktur: date -d '2027-03-28 01:30' CET olarak, date -d '2027-03-28 03:30' ise CEST olarak çözümlenir.
Sonbahar geçişi bunun ayna görüntüsüdür. 2027-10-31 tarihinde Berlin saati 03:00'ten 02:00'ye geri alınır, bu nedenle 02:30 iki kez yaşanır.
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
1824946200Her ikisi de yerel olarak 02:30 olarak adlandırılan ve aralarında 3600 saniye bulunan iki farklı an. n8n'in mevcut dayanıklı zamanlayıcısı, tekrarlanan bir yerel cron zamanını bir kez tetikler. Zamanlamayı bu pencerenin dışına taşıyın. Çoğu Avrupa ve Kuzey Amerika bölgesinde riskli aralık yerel saatle 00:00 ile 03:00 arasındadır.
Altyapıyı UTC zaman diliminde planlayın ve yerel saati kullanıcılara gösterin
Standart yaklaşım, bir zaman diliminin üstlendiği iki görevi birbirinden ayırır. Makineler kararlı bir zaman aralığına ihtiyaç duyar. İnsanlar ise okunabilir bir saate ihtiyaç duyar.
- Kimsenin izlemediği işlemler için iş akışı zaman dilimini UTC olarak ayarlayın. Yedeklemeler, önbellek ısıtma, log aktarımı ve rapor oluşturma bu kategoriye girer. UTC, gün ışığından yararlanma saati değişikliklerini zamanlama dışına çıkarır; ancak aylık çalıştırmalar gibi takvim bazlı zamanlamalar yine de eşit olmayan aralıklara sahip olabilir.
- Bir insanın okuyacağı işler için zamanlamayı UTC'de tutun ve görüntüleme anında dönüştürün. Tek bir ifade bunu sağlar:
{{ $now.setZone('Europe/Berlin').toFormat('yyyy-MM-dd HH:mm') }}, tetikleyici kararlı kalırken mesaj gövdesine yerel saati ekler.
Aynı ayrım n8n dışındaki yapılar için de geçerlidir. Otomasyonunuzun bir parçası bir VPS üzerinde systemd servisi ve zamanlayıcısı olarak çalıştığında, OnCalendar satırı, ifade içerisinde başka bir bölge belirtilmediği sürece sistemin zaman dilimini kullanır. Tüm zamanlayıcıları UTC'de tutmak, dört farklı kural yerine hatırlamanız gereken tek bir kural bırakır. Bu durum, bir dönemi özetleyen her türlü işlem için de önemlidir; çünkü bir n8n yapay zeka ajanı iş akışı, dünün verilerini istediğinde, çözümlemenin yapıldığı zaman dilimine bağlı olarak sessizce farklı bir takvim gününü baz alacaktır.
Hata modları ve karşılaşacağınız çıktılar
Her şey altı saatlik bir sapmayla tetikleniyor. Eğer herhangi bir iş akışı veya örnek saat dilimi yapılandırılmamışsa, yerleşik varsayılan America/New_York uygulanır. docker compose exec n8n printenv GENERIC_TIMEZONE, bu ortam değişkeni ayarlanmadığında hiçbir çıktı vermez. Değişkeni ayarlayın ve ardından container'ı yeniden oluşturun.
Compose dosyasını düzenlediniz ancak hiçbir şey değişmedi. docker compose restart komutunu çalıştırdınız, bu nedenle container orijinal ortamını korudu. docker compose up -d komutunu çalıştırın ve ardından docker compose exec n8n printenv TZ ile doğrulayın.
Tetikleyici doğru ancak zaman damgaları hatalı. Biçimlendirmeyi kontrol edin: $now iş akışı saat dilimini kullanırken, new Date().toString() JavaScript çalışma zamanının sistem saat dilimini kullanır. Yerel biçimlendirmenin eşleşmesini istiyorsanız, ilgili çalışma zamanı için TZ değerini ayarlayın ve container'ını yeniden oluşturun.
Bir iş akışı örnek ayarını yok sayıyor. Söz konusu iş akışı, ayarlarında kendi saat dilimini barındırır ve bu ayar GENERIC_TIMEZONE değerine göre önceliklidir. Tuvali açın, üç noktaya tıklayın, Ayarlar ve Saat Dilimi yolunu izleyin.
Günlük bir görev, saatler değiştiğinde farklı bir yerel saatte çalıştı. Zamanlanmış saati, gün ışığından yararlanma geçişinin içinde kalıyor. Mevcut dayanıklı zamanlayıcı, var olmayan yerel cron zamanlarını ileri kaydırır ve tekrarlananları bir kez çalıştırır. Saati değiştirin veya ilgili iş akışını UTC zaman dilimine taşıyın.
FAQ
n8n zamanlanmış tetikleyicim neden yanlış saatte çalışıyor?
İş akışı, varsaydığınızdan farklı bir saat dilimi kullanıyordur. n8n, eğer tanımlıysa iş akışı saat dilimini, tanımlı değilse GENERIC_TIMEZONE üzerinden tanımlanan sunucu saat dilimini, o da tanımlı değilse yerleşik varsayılanı olan America/New_York değerini kullanır. İş akışı veya sunucu saat dilimi yapılandırılmamış bir self-hosted kurulum, zamanlamaları UTC yerine New York saatine göre yapar; bu nedenle saat farkı, bulunduğunuz konumun UTC'ye olan uzaklığıyla nadiren eşleşir. docker compose exec n8n printenv GENERIC_TIMEZONE komutunu çalıştırın. Çıktı boşsa bu ortam değişkeni ayarlanmamıştır; iş akışı saat dilimini de kontrol edin.
n8n içindeki TZ ve GENERIC_TIMEZONE arasındaki fark nedir?
TZ, container içindeki işletim sistemi saat dilimidir. Container içinde date komutunun ne döndüreceğini ve yerel tarih biçimlendirmeleri ile betiklerin hangi saat dilimini kullanacağını belirler. GENERIC_TIMEZONE ise n8n sunucu saat dilimidir; iş akışı saat dilimi tarafından geçersiz kılınmadığı sürece zamanlama düğümleri ve $now gibi Luxon ifadeleri tarafından kullanılır. Yalnızca iş akışı saat dilimini ayarlamak, Zamanlanmış Tetikleyici (Schedule Trigger) sorununu tamamen çözebilir. Sistem saati biçimlendirmesinin sunucu varsayılanıyla eşleşmesini istediğiniz durumlarda her iki ortam değişkenini de aynı değere ayarlayın.
İş akışı saat dilimini mi yoksa GENERIC_TIMEZONE değerini mi ayarlamalıyım?
Tüm sunucu için varsayılan olarak GENERIC_TIMEZONE değerini ayarlayın. İş akışı bazlı ayarı ise yalnızca bir iş akışının gerçekten başka bir saat dilimine ait olduğu durumlarda kullanın. İş akışı değeri, sunucu değerini geçersiz kılar ve GENERIC_TIMEZONE üzerinde daha sonra yapılan değişikliklerden etkilenmez; bu nedenle unutulmuş bir iş akışı bazlı geçersiz kılma ayarının aylar sonra tespit edilmesi zordur.
Saatler değiştiğinde 02:30'a zamanlanmış bir işe ne olur?
O yerel saat ya kaybolur ya da iki kez gerçekleşir. GNU date ile LC_ALL=C TZ=Europe/Berlin date -d '2027-03-28 02:30', Berlin saati o gün 02:00'den 03:00'e atladığı için date: invalid date '2027-03-28 02:30' döndürür. BusyBox date, mktime başarılı olursa normalleştirmeyi kabul eder; dolayısıyla bu hata tüm Linux dağıtımlarında görülmez. 2027-10-31 tarihinde aynı duvar saati değeri, aralarında bir saat fark olan iki farklı ana karşılık gelir. n8n'in mevcut dayanıklı zamanlayıcısı, var olmayan yerel cron zamanlarını ileriye taşır ve tekrarlanan zamanları bir kez çalıştırır. Zamanlanmış işlerinizi 00:00 ile 03:00 arasındaki yerel saat diliminin dışında tutun veya iş akışını UTC'ye ayarlayıp yalnızca bir insan tarafından okunacağı durumlarda yerel saate dönüştürün.