({{, (RefLink[DatedUnit, paclet:ref/DatedUnit])[unit,date] 
represents the specified unit at a specific date.}})

OpenersNotesSection(Spacer1)Details

(RefLink[DatedUnit, paclet:ref/DatedUnit]) allows you to associate a specific date directly with a specific unit, for use in functions like (RefLink[InflationAdjust, paclet:ref/InflationAdjust]).

unit specifications should be a single canonical unit string like "USDollars" or "Euros".

date can be specified as year, (RefLink[DateObject, paclet:ref/DateObject]), or (RefLink[DateList, paclet:ref/DateList]).

OpenersPrimaryExamplesSection(Spacer1)Examples  (4)

OpenersExampleSection0(Spacer1)Basic Examples  (1)

Represent the value of 100 yen in 1990:

Quantity[100.,DatedUnit["Yen",1990]]

Account for inflation between 1800 and 1950:

InflationAdjust[Quantity[0.25,DatedUnit["USDollars",1800]],1950]

OpenersExampleSection1(Spacer1)Scope  (1)

(RefLink[DatedUnit, paclet:ref/DatedUnit]) specifications can be used in compound unit specifications:

Quantity[3000.,DatedUnit["USDollars",2011]/"Acres"]

OpenersExampleSection3(Spacer1)Applications  (1)

Plot the rate of inflation over a period of time:

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

OpenersExampleSection4(Spacer1)Possible Issues  (1)

Arithmetic with (RefLink[DatedUnit, paclet:ref/DatedUnit]) is only performed when the currency and time are identical:

Quantity[3.,DatedUnit["USDollars",1990]]+Quantity[400,DatedUnit["Yen",1980]]

Because the result can differ depending on the order of operation, (RefLink[DatedUnit, paclet:ref/DatedUnit]) expressions should have their date and currency standardized with (RefLink[InflationAdjust, paclet:ref/InflationAdjust]) before arithmetic is performed:

Fold[InflationAdjust,Quantity[3.,DatedUnit["USDollars",1990]],{1980,DatedUnit["Yen",1980]}]

Fold[InflationAdjust,Quantity[3.,DatedUnit["USDollars",1990]],{DatedUnit["Yen",1990],1980}]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[InflationAdjust, paclet:ref/InflationAdjust])  ▪  (RefLink[Quantity, paclet:ref/Quantity])  ▪  (RefLink[CurrencyConvert, paclet:ref/CurrencyConvert])  ▪  (RefLink[Dated, paclet:ref/Dated])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Financial Computation, paclet:guide/Finance])}, {▪(RefLinkPlain[Units & Quantities, paclet:guide/Units])}})}})