Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Filtriranje po datumu

Lekcija 10 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Definiranje vremenskog okvira pretraživanja
  2. Parametri datuma
  3. Format datuma
  4. Sintaksa SDK-a
  5. Kombiniranje datuma i korisničkih imena
  6. Slučajevi uporabe
  7. Najbolje prakse
  8. Ključne točke

Definiranje vremenskog okvira pretraživanja

X Search nudi značajku koju Web Search nema: filtriranje po datumu. Možeš definirati određeno razdoblje kako bi ograničio rezultate na objave objavljene unutar tog vremenskog okvira. Ovo je moćan alat za analizu trendova, praćenje događaja i ciljani monitoring.

Parametri datuma

Dva parametra kontroliraju vremenski okvir:

  • from_date: početni datum pretraživanja (uključivo)
  • to_date: završni datum pretraživanja (uključivo)

Oba su opcionalna i neovisna. Možeš koristiti jedno bez drugoga:

  • samo from_date: sve objave od tog datuma nadalje
  • samo to_date: sve objave do tog datuma
  • oba zajedno: objave unutar definiranog prozora

Format datuma

Datumi slijede format ISO 8601: YYYY-MM-DD (godina-mjesec-dan).

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What were the reactions to the Grok 4 launch?",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Ovaj upit pretražuje samo objave objavljene u ožujku 2026.

Sintaksa SDK-a

xAI SDK (Python)

Python SDK prihvaća i nizove znakova (stringove) i objekte datetime:

from xai_sdk.tools import x_search
import datetime

# Korištenje nizova znakova
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Korištenje objekata datetime
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Korištenje objekata datetime poželjno je u proizvodnji jer ti omogućuje dinamičko izračunavanje datuma (na primjer, „posljednjih 7 dana“).

OpenAI SDK (Python)

tools=[{
    "type": "x_search",
    "from_date": "2026-01-01",
    "to_date": "2026-04-01"
}]

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch({
  fromDate: "2026-01-01",
  toDate: "2026-04-01"
})]

Konvencija camelCase: fromDate i toDate.

Kombiniranje datuma i korisničkih imena

Kombiniranje filtriranja po vremenu s filtriranjem po korisničkim imenima posebno je moćno:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Summarize xAI's announcements this month",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"],
        "from_date": "2026-04-01",
        "to_date": "2026-04-30"
    }]
)

Ovaj upit kombinira tri filtra: samo objave sa službenih xAI računa i samo one iz travnja 2026.

Slučajevi uporabe

Analiza događaja

Prati reakcije u stvarnom vremenu tijekom događaja (konferencija, lansiranje proizvoda, najava):

# Reakcije tijekom ključnog govora
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatizirani tjedni monitoring

Izradi automatsko izvješće o monitoringu za protekli tjedan:

from datetime import datetime, timedelta

today = datetime.now()
week_ago = today - timedelta(days=7)

tools=[{
    "type": "x_search",
    "from_date": week_ago.strftime("%Y-%m-%d"),
    "to_date": today.strftime("%Y-%m-%d")
}]

Analiza trendova

Usporedi rasprave o temi u različitim razdobljima slanjem više zahtjeva s različitim vremenskim okvirima.

Najbolje prakse

Iskustvo pokazuje da kraći vremenski okviri daju najbolje rezultate: razdoblje od jednog do sedam dana daje znatno preciznije rezultate od cijelog mjeseca, gdje se važne objave gube u volumenu podataka. U proizvodnji nikada nemoj hardkodirati ove datume – izračunavaj ih pomoću datetime pri svakom pokretanju. Inače će tvoj prozor za „7-dnevni monitoring“ zauvijek upitivati isti tjedan od trenutka implementacije. Naposljetku, vremenski okvir samo definira skup rezultata: upit (prompt) diktira što s njima učiniti. Preciziraj što očekuješ – „sažetak trendova“, „najangažiranije objave“, „glavne najave“ – i model će accordingly filtrirati rezultate umjesto da vraća sve.

Ključne točke

  • from_date i to_date u formatu ISO 8601 (YYYY-MM-DD)
  • Oba parametra su opcionalna i neovisna
  • Kombiniraj s filtriranjem po korisničkim imenima za izrazito ciljane pretrage
  • Python SDK prihvaća i nizove znakova i objekte datetime
  • Ekskluzivno za X Search – Web Search ne nudi filtriranje po vremenu