represents the object obj associated with a particular year.


represents the object obj associated with a date.


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


  • 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.


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:

History plot of the US national debt divide 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,


Wolfram Research (2016), Dated, Wolfram Language function,


Wolfram Language. 2016. "Dated." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2016). Dated. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2023_dated, author="Wolfram Research", title="{Dated}", year="2016", howpublished="\url{}", note=[Accessed: 25-September-2023 ]}


@online{reference.wolfram_2023_dated, organization={Wolfram Research}, title={Dated}, year={2016}, url={}, note=[Accessed: 25-September-2023 ]}