Two types of date ranges can be used in the search:

  • Rolling date ranges (RollingDateRange): Predefined relative date ranges include:

    • RollingDateRange.LAST_ONE_HOURS
    • RollingDateRange.LAST_THREE_HOURS
    • RollingDateRange.LAST_SIX_HOURS
    • RollingDateRange.LAST_NINE_HOURS
    • RollingDateRange.LAST_TWELVE_HOURS
    • RollingDateRange.LAST_TWENTY_FOUR_HOURS
    • RollingDateRange.LAST_FORTY_EIGHT_HOURS
    • RollingDateRange.LAST_SEVEN_DAYS
    • RollingDateRange.LAST_THIRTY_DAYS
    • RollingDateRange.LAST_NINETY_DAYS
    • RollingDateRange.YEAR_TO_DATE
    • RollingDateRange.LAST_YEAR

    Deprecated

    • RollingDateRange.TODAY
    • RollingDateRange.YESTERDAY
    • RollingDateRange.THIS_WEEK
    • RollingDateRange.LAST_WEEK
    from bigdata_client import Bigdata
from bigdata_client.daterange import RollingDateRange
from bigdata_client.query import Entity, Keyword

MICROSOFT = "228D42"

query = Entity(MICROSOFT) | Keyword("tesla")

bigdata = Bigdata()
search = bigdata.search.new(
    query=query,
    date_range=RollingDateRange.LAST_THIRTY_DAYS
)

documents = search.run(2)
print(documents)

  • AbsoluteDateRange: Absolute date range defined by start and end dates. Dates must follow ISO 8601

Examples:

from bigdata_client import Bigdata
from bigdata_client.daterange import AbsoluteDateRange
from bigdata_client.query import Entity, Keyword
from datetime import datetime
import pytz

MICROSOFT = "228D42"

query = Entity(MICROSOFT) | Keyword("tesla")
# The following are equivalent
date_range = AbsoluteDateRange(datetime(2024, 1, 1), datetime(2024, 1, 31))
date_range = AbsoluteDateRange("2024-01-01", "2024-01-31")
date_range = AbsoluteDateRange("2024-01-01T00:00:00", "2024-01-31T00:00:00")
# Or you can set a timezone
end_date =  pytz.timezone("Asia/Tokyo").localize(datetime(2024, 1, 31, 9))
date_range = AbsoluteDateRange("2024-01-01T01:00:00+01:00", end_date)

bigdata = Bigdata()
search = bigdata.search.new(
    query=query,
    date_range=daterange
)

documents = search.run(2)
print(documents)