Using the Logical Date Operator
The logical_date parameter allows you to filter files by the specific time period the data represents.
-
logical_daterefers to the period the data describes, such as:- January 2025 →
"202501" - April 2024 →
"202404"
- January 2025 →
-
It's different from
drop_date, which refers to when the file was ingested into the platform.
Use logical_date when you want to:
- Download only the files for a specific time period
- Reduce cost by limiting how many files you purchase
- Ensure time-aligned analysis (e.g., month-to-month comparisons)
You can pass logical_date to the get_data_manifest() method using a tuple of:
(logical_date_operator, logical_date_value)
Logical Date Operators
Below is a list of operators and their descriptions
| Operator | Meaning | Example Input | Description |
|---|---|---|---|
"==" | Equal to | logical_date=("==", "202501") | Only return files where the logical date is exactly Jan 2025 |
"<" | Less than | drop_date=("<", "20240601") | Only return files ingested before June 1, 2024 |
"<=" | Less than or equal to | logical_date=("<= ", "202312") | Return files with logical dates up to and including Dec 2023 |
">" | Greater than | drop_date=(">", "20240101") | Only return files ingested after Jan 1, 2024 |
">=" | Greater than or equal to | logical_date=(">=", "202401") | Return files from Jan 2024 onward |