Tarih ve Saat

Mayros, taşıma zaman damgaları için ana bilgisayar yerel saatini ve sistem isteminde yalnızca kullanıcı saat dilimini varsayılan olarak kullanır. Sağlayıcı zaman damgaları korunur, böylece araçlar yerel semantiklerini korur (geçerli saat session_status aracılığıyla kullanılabilir).

Mesaj zarfları (varsayılan olarak yerel)

Gelen mesajlar bir zaman damgası ile sarılır (dakika hassasiyeti):

[Sağlayıcı ... 2026-01-05 16:26 PST] mesaj metni

Bu zarf zaman damgası, sağlayıcı saat diliminden bağımsız olarak varsayılan olarak ana bilgisayar yereldir.

Bu davranışı geçersiz kılabilirsiniz:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA saat dilimi
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" UTC kullanır.
  • envelopeTimezone: "local" ana bilgisayar saat dilimini kullanır.
  • envelopeTimezone: "user" agents.defaults.userTimezone kullanır (ana bilgisayar saat dilimine geri döner).
  • Sabit bir bölge için açık bir IANA saat dilimi kullanın (örn. "America/Chicago").
  • envelopeTimestamp: "off" zarf başlıklarından mutlak zaman damgalarını kaldırır.
  • envelopeElapsed: "off" geçen süre son eklerini kaldırır (+2m stili).

Örnekler

Yerel (varsayılan):

[WhatsApp +1555 2026-01-18 00:19 PST] merhaba

Kullanıcı saat dilimi:

[WhatsApp +1555 2026-01-18 00:19 CST] merhaba

Geçen süre etkin:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] takip

Sistem istemi: Geçerli Tarih ve Saat

Kullanıcı saat dilimi biliniyorsa, sistem istemi istem önbelleğe almayı kararlı tutmak için yalnızca saat dilimi ile (saat/zaman formatı yok) özel bir Geçerli Tarih ve Saat bölümü içerir:

Saat dilimi: America/Chicago

Ajan geçerli zamana ihtiyaç duyduğunda, session_status aracını kullanın; durum kartı bir zaman damgası satırı içerir.

Sistem olay satırları (varsayılan olarak yerel)

Ajan bağlamına eklenen sıraya alınmış sistem olayları, mesaj zarflarıyla aynı saat dilimi seçimini kullanarak bir zaman damgası ile ön eklendirilir (varsayılan: ana bilgisayar yerel).

Sistem: [2026-01-12 12:19:17 PST] Model değiştirildi.

Kullanıcı saat dilimini + formatı yapılandırın

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone istem bağlamı için kullanıcı yerel saat dilimini ayarlar.
  • timeFormat istemde 12s/24s görüntülemeyi kontrol eder. auto işletim sistemi tercihlerini takip eder.

Saat formatı algılama (otomatik)

timeFormat: "auto" olduğunda, Mayros işletim sistemi tercihini (macOS/Windows) inceler ve yerel ayar biçimlendirmesine geri döner. Algılanan değer, tekrarlanan sistem çağrılarını önlemek için işlem başına önbelleğe alınır.

Araç yükleri + bağlayıcılar (ham sağlayıcı zamanı + normalleştirilmiş alanlar)

Kanal araçları sağlayıcıya özgü zaman damgalarını döndürür ve tutarlılık için normalleştirilmiş alanlar ekler:

  • timestampMs: epoch milisaniye (UTC)
  • timestampUtc: ISO 8601 UTC dizesi

Ham sağlayıcı alanları korunur, böylece hiçbir şey kaybolmaz.

  • Slack: API'den epoch benzeri dizeler
  • Discord: UTC ISO zaman damgaları
  • Telegram/WhatsApp: sağlayıcıya özgü sayısal/ISO zaman damgaları

Yerel zamana ihtiyacınız varsa, bilinen saat dilimini kullanarak aşağı akışta dönüştürün.

İlgili dokümanlar