Dated

Dated[obj,year]

represents the object obj associated with a particular year.

Dated[obj,date]

represents the object obj associated with a date.

Dated[obj,All]

represents the object obj for all dates where information is available about it.

Details

  • In Dated[obj,date], obj can be an Entity object, an EntityProperty object, or a string representing an entity property.
  • In Dated[obj,year], the year can be given as an integer.
  • In Dated[obj,date], date is specified using DateObject.
  • When data is requested using Dated[obj,All], a time series is typically returned.

Examples

open allclose all

Basic Examples  (3)

Represent France in 1985:

Find the population of France in 1985:

Dated can also be used on EntityProperty expressions:

A string property name can also be wrapped in Dated:

Scope  (2)

When Dated is used on an entity, properties without date qualifiers will ignore the date parameter:

When Dated is used on a property without date qualifiers, Missing[…] is returned:

If Dated is used on both the entity and property, the date associated with the property is used:

Generalizations & Extensions  (2)

Get the net income of a company for multiple dates by requesting values for multiple dated properties:

Get the same result by requesting the net income for multiple dated entities:

Get the five largest countries by electricity from wind in 2010:

Applications  (10)

Find the planet currently closest to Earth:

Find the planet closest to Earth on February 2, 2023:

Find Mercury's and Mars's distances from Earth between January and October 2023:

Get US retail sales on January 1, 2022:

Get the US M1 vs. M2 money supply in 2020:

History plot of US real GDP annual growth rate from 1965 to 2000:

Make a history plot of the US national debt divided by the US GDP from 1978:

Make a pie chart of US industrial production by sector in 1995:

Compare Illinois and Wisconsin unemployment rate in March 1996:

Make a history plot of Phoenix, St. Louis, Miami housing prices from 2010:

Make a geo region value plot of US mid-west states GDP per capita in 2020:

Properties & Relations  (1)

Get the population of a country on a given date:

The following is equivalent:

Wolfram Research (2016), Dated, Wolfram Language function, https://reference.wolfram.com/language/ref/Dated.html.

Text

Wolfram Research (2016), Dated, Wolfram Language function, https://reference.wolfram.com/language/ref/Dated.html.

CMS

Wolfram Language. 2016. "Dated." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Dated.html.

APA

Wolfram Language. (2016). Dated. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Dated.html

BibTeX

@misc{reference.wolfram_2025_dated, author="Wolfram Research", title="{Dated}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/Dated.html}", note=[Accessed: 09-May-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_dated, organization={Wolfram Research}, title={Dated}, year={2016}, url={https://reference.wolfram.com/language/ref/Dated.html}, note=[Accessed: 09-May-2025 ]}