Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Filtrering efter dato

Lektion 10 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Definer søgetidsrummet
  2. Datoparametre
  3. Datoformat
  4. SDK-syntaks
  5. Kombinér datoer og handles
  6. Use cases
  7. Bedste praksis
  8. Vigtige pointer

Definer søgetidsrummet

X Search tilbyder en funktion, som Web Search ikke har: filtrering efter dato. Du kan definere en specifik periode for at begrænse resultaterne til opslag, der er offentliggjort inden for dette tidsrum. Det er et kraftfuldt værktøj til trendanalyse, begivenhedssporing og målrettet overvågning.

Datoparametre

To parametre styrer tidsvinduet:

  • from_date: startdato for søgningen (inklusiv)
  • to_date: slutdato for søgningen (inklusiv)

Begge er valgfrie og uafhængige. Du kan bruge den ene uden den anden:

  • Kun from_date: alle opslag siden denne dato
  • Kun to_date: alle opslag frem til denne dato
  • Begge sammen: opslag inden for det definerede vindue

Datoformat

Datoer følger formatet ISO 8601: YYYY-MM-DD (år-måned-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"
    }]
)

Denne forespørgsel søger kun efter opslag offentliggjort i marts 2026.

SDK-syntaks

xAI SDK (Python)

Python SDK accepterer både strenge og datetime-objekter:

from xai_sdk.tools import x_search
import datetime

# Brug af strenge
tools=[x_search(
    from_date="2026-01-01",
    to_date="2026-04-01"
)]

# Brug af datetime-objekter
tools=[x_search(
    from_date=datetime.datetime(2026, 1, 1),
    to_date=datetime.datetime(2026, 4, 1)
)]

Brug af datetime-objekter foretrækkes i produktion, da det giver dig mulighed for at beregne datoer dynamisk (f.eks. „de sidste 7 dage”).

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-konvention: fromDate og toDate.

Kombinér datoer og handles

Kombination af tidsfiltrering med filtrering på handles er særligt kraftfuld:

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

Denne forespørgsel kombinerer tre filtre: kun opslag fra officielle xAI-konti, og kun i april 2026.

Use cases

Begivenhedsanalyse

Spor reaktioner i realtid under en begivenhed (konference, produktlancering, annoncering):

# Reaktioner under en keynote
tools=[{
    "type": "x_search",
    "from_date": "2026-03-25",
    "to_date": "2026-03-26"
}]

Automatiseret ugentlig overvågning

Opret en automatisk overvågningsrapport for den forgangne uge:

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

Sammenlign diskussioner om et emne på forskellige tidspunkter ved at foretage flere forespørgsler med forskellige tidsvinduer.

Bedste praksis

Erfaring viser, at kortere vinduer fungerer bedst: en periode på én til syv dage giver væsentligt mere præcise resultater end en hel måned, hvor vigtige opslag går tabt i mængden. I produktion må du aldrig hardkode disse datoer – beregn dem med datetime ved hver kørsel. Ellers vil dit „7-dages overvågnings”-vindue altid forespørge den samme uge fra deploymentstidspunktet. Endelig definerer tidsvinduet kun resultatmængden: prompten dikterer, hvad der skal gøres med den. Specificér, hvad du forventer – „trendopsamling”, „mest engagerede opslag”, „vigtige annonceringer” – så vil modellen filtrere resultaterne derefter i stedet for at returnere alt.

Vigtige pointer

  • from_date og to_date i ISO 8601-format (YYYY-MM-DD)
  • Begge parametre er valgfrie og uafhængige
  • Kombinér med filtrering på handles for meget målrettede søgninger
  • Python SDK accepterer både strenge og datetime-objekter
  • Eksklusivt for X Search – Web Search tilbyder ikke tidsfiltrering