Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Filtriranje po datumu

Lekcija 10 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Določitev časovnega okna iskanja
  2. Parametra za datum
  3. Oblika datuma
  4. Skladnja SDK-ja
  5. Kombiniranje datumov in uporabniških imen
  6. Primeri uporabe
  7. Najboljše prakse
  8. Ključne ugotovitve

Določitev časovnega okna iskanja

X Search ponuja funkcijo, ki je Web Search nima: filtriranje po datumu. Določiš lahko specifično obdobje in tako omejiš rezultate na objave, objavljene znotraj tega časovnega okna. To je zmogljivo orodje za analizo trendov, sledenje dogodkom in ciljno spremljanje.

Parametra za datum

Časovno okno nadzirata dva parametra:

  • from_date: začetni datum iskanja (vključno)
  • to_date: končni datum iskanja (vključno)

Oba sta opcijska in neodvisna. Uporabiš lahko enega brez drugega:

  • samo from_date: vse objave od tega datuma naprej
  • samo to_date: vse objave do tega datuma
  • oba skupaj: objave znotraj določenega okna

Oblika datuma

Datumi sledijo formatu ISO 8601: YYYY-MM-DD (leto-mesec-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"
    }]
)

Ta poizvedba išče samo objave, objavljene marca 2026.

Skladnja SDK-ja

xAI SDK (Python)

Python SDK sprejema tako nize kot predmete datetime:

from xai_sdk.tools import x_search
import datetime

# Uporaba nizov
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Uporaba predmetov datetime
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Uporaba predmetov datetime je v proizvodnem okolju prednostna, saj omogoča dinamično izračunavanje datumov (na primer „zadnjih 7 dni”).

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 in toDate.

Kombiniranje datumov in uporabniških imen

Kombiniranje časovnega filtriranja s filtriranjem po uporabniških imenih (handles) je še posebej zmogljivo:

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"
    }]
)

Ta poizvedba združuje tri filtre: samo objave uradnih računov xAI in samo iz aprila 2026.

Primeri uporabe

Analiza dogodkov

Sledi odzivom v realnem času med dogodkom (konferenca, lansiranje izdelka, napoved):

# Odzivi med ključnim govorom
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Avtomatizirano tedensko spremljanje

Ustvari samodejno poročilo o spremljanju za pretekli teden:

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 trendov

Primerjaj razprave o temi v različnih obdobjih z večkratnimi zahtevki z različnimi časovnimi okni.

Najboljše prakse

Izkušnje kažejo, da krajša okna delujejo najbolje: obdobje od enega do sedmih dni prinaša bistveno natančnejše rezultate kot celoten mesec, kjer se pomembne objave izgubijo v množici. V proizvodnem okolju teh datumov nikoli ne vgrajuj trdno (hardcode) – izračunavaj jih s pomočjo datetime ob vsakem zagonu. V nasprotnem primeru bo tvoje okno „7-dnevnega spremljanja” večno poizvedovalo po istem tednu od trenutka namestitve. Nazadnje, časovno okno le določa nabor rezultatov; ukaz (prompt) narekuje, kaj storiti z njim. Natančno določi, kaj pričakuješ – „povzetek trendov”, „najbolj angažirane objave”, „glavna sporočila” – in model bo rezultate ustrezno filtriral, namesto da bi vrnil vse.

Ključne ugotovitve

  • from_date in to_date v formatu ISO 8601 (YYYY-MM-DD)
  • Oba parametra sta opcijska in neodvisna
  • Združi s filtriranjem po uporabniških imenih za izjemno ciljna iskanja
  • Python SDK sprejema tako nize kot predmete datetime
  • Ekskluzivno za X Search – Web Search ne ponuja časovnega filtriranja