WOLFRAM

Wolfram Language & System Documentation Center

DatedUnit[unit,date]

represents the specified unit at a specific date.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Applications  
Possible Issues  
See Also
Related Guides
History
Cite this Page

DatedUnit

DatedUnit[unit,date]

represents the specified unit at a specific date.

Details

  • DatedUnit allows you to associate a specific date directly with a specific unit, for use in functions like InflationAdjust.
  • unit specifications should be a single canonical unit string like "USDollars" or "Euros".
  • date can be specified as year, DateObject, or DateList.

Examples

open all close all

Basic Examples  (2)

Represent the value of 100 yen in 1990:

Wolfram Language code: Quantity[100., DatedUnit["Yen", 1990]]

Account for inflation between 1800 and 1950:

Wolfram Language code: InflationAdjust[Quantity[0.25, DatedUnit["USDollars", 1800]], 1950]

Scope  (2)

DatedUnit specifications can be used in compound unit specifications:

Wolfram Language code: Quantity[3000., DatedUnit["USDollars", 2011] / "Acres"]

If no date is specified, the current year will be assumed:

Wolfram Language code: InflationAdjust[Quantity[100, DatedUnit["USDollars"]], {2025}]

Applications  (1)

Plot the rate of inflation over a period of time:

Wolfram Language code: DateListPlot[Table[{{i}, Quantity[1., DatedUnit["Yen", i]]}, {i, 1960, 2010}]]

Possible Issues  (1)

Because the result can differ depending on the order of operation, DatedUnit expressions should have their date and currency standardized with InflationAdjust before arithmetic is performed:

Wolfram Language code: Fold[InflationAdjust, Quantity[3., DatedUnit["USDollars", 1990]], {1980, DatedUnit["Yen", 1980]}]
Wolfram Language code: Fold[InflationAdjust, Quantity[3., DatedUnit["USDollars", 1990]], {DatedUnit["Yen", 1990], 1980}]
Wolfram Research (2014), DatedUnit, Wolfram Language function, https://reference.wolfram.com/language/ref/DatedUnit.html.

Text

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

CMS

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

APA

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

BibTeX

@misc{reference.wolfram_2026_datedunit, author="Wolfram Research", title="{DatedUnit}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/DatedUnit.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_datedunit, organization={Wolfram Research}, title={DatedUnit}, year={2014}, url={https://reference.wolfram.com/language/ref/DatedUnit.html}, note=[Accessed: 13-June-2026]}