Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Datumfiltering

Les 10 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Het zoektijdsvenster definiëren
  2. Datumparameters
  3. Datumnotatie
  4. SDK-syntax
  5. Datums en handles combineren
  6. Use cases
  7. Best practices
  8. Belangrijkste punten

Het zoektijdsvenster definiëren

X Search biedt een functie die Web Search niet heeft: datumfiltering. U kunt een specifieke periode definiëren om de resultaten te beperken tot berichten die binnen dat tijdsvenster zijn gepubliceerd. Dit is een krachtig instrument voor trendanalyse, evenementtracking en gerichte monitoring.

Datumparameters

Twee parameters sturen het tijdsvenster aan:

  • from_date: startdatum van de zoekopdracht (inclusief)
  • to_date: einddatum van de zoekopdracht (inclusief)

Beide zijn optioneel en onafhankelijk van elkaar. U kunt er één gebruiken zonder de andere:

  • Alleen from_date: alle berichten sinds deze datum
  • Alleen to_date: alle berichten tot en met deze datum
  • Beide samen: berichten binnen het gedefinieerde venster

Datumnotatie

Datums volgen de ISO 8601-notatie: YYYY-MM-DD (jaar-maand-dag).

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

Deze query zoekt alleen naar berichten die in maart 2026 zijn gepubliceerd.

SDK-syntax

xAI SDK (Python)

De Python-SDK accepteert zowel strings als datetime-objecten:

from xai_sdk.tools import x_search
import datetime

# Gebruik van strings
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Gebruik van datetime-objecten
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Het gebruik van datetime-objecten heeft de voorkeur in productieomgevingen, omdat u hiermee datums dynamisch kunt berekenen (bijvoorbeeld “de laatste 7 dagen”).

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

camelCase-conventie: fromDate en toDate.

Datums en handles combineren

Het combineren van tijdfiltering met handle-filtering is bijzonder krachtig:

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

Deze query combineert drie filters: alleen berichten van officiële xAI-accounts, en alleen in april 2026.

Use cases

Evenementanalyse

Volg reacties in realtime tijdens een evenement (conferentie, productlancering, aankondiging):

# Reacties tijdens een keynote
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Geautomatiseerde wekelijkse monitoring

Maak een automatisch monitoringrapport voor de afgelopen week:

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

Trendanalyse

Vergelijk discussies over een onderwerp in verschillende perioden door meerdere verzoeken met verschillende tijdsvensters te doen.

Best practices

Ervaring leert dat kortere vensters het beste werken: een periode van één tot zeven dagen levert aanzienlijk nauwkeurigere resultaten op dan een hele maand, waarbij belangrijke berichten verloren gaan in de hoeveelheid data. Hardcode deze datums in productie nooit; bereken ze bij elke uitvoering met datetime. Anders zal uw “7-daagse monitoring”-venster bij elke implementatie voor altijd dezelfde week bevragen. Tot slot definieert het tijdsvenster alleen de resultatenset: de prompt bepaalt wat ermee gebeurt. Specificeer wat u verwacht—“trendoverzicht”, “berichten met de meeste interactie”, “belangrijke aankondigingen”—en het model zal de resultaten dienovereenkomstig filteren in plaats van alles terug te geven.

Belangrijkste punten

  • from_date en to_date in ISO 8601-notatie (YYYY-MM-DD)
  • Beide parameters zijn optioneel en onafhankelijk
  • Combineer met handle-filtering voor zeer gerichte zoekopdrachten
  • Python-SDK accepteert zowel strings als datetime-objecten
  • Exclusief voor X Search—Web Search biedt geen tijdfiltering