WOLFRAM

Wolfram Language & System Documentation Center

CurrencyConvert[quantity,target]

attempts to convert the specified currency quantity to the specified target currency.

CurrencyConvert[quantity,target,date]

converts to the target currency for the historical date specification.

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

CurrencyConvert

CurrencyConvert[quantity,target]

attempts to convert the specified currency quantity to the specified target currency.

CurrencyConvert[quantity,target,date]

converts to the target currency for the historical date specification.

Details

  • The target can be a canonical unit or a Quantity expression.
  • When target is a Quantity, the resulting output will have the same unit as target.
  • An internet connection is required for conversion between currency units.
  • CurrencyConvert uses exchange rate information provided by FinancialData for conversion between currency units.
  • CurrencyConvert uses InflationAdjust for historical currency conversions involving DatedUnit.
  • When no exchange rate information is available, a String representing the exchange ratio is returned instead.
  • Date specifications may include a DateObject, DateList, DateString or AbsoluteTime specification.
  • The date specification may also be a range of {start,end} or All, where results are a TimeSeries object.

Examples

open all close all

Basic Examples  (2)

Convert from US dollars to euros:

DatedUnit can be used to specify currency values at a specific point in time:

The third argument may be used to do conversions for a specific historical date:

A range of dates may also be provided:

A date specification of All will return all available historical currency conversion data:

Scope  (1)

CurrencyConvert also operates on lists of Quantity expressions:

Possible Issues  (3)

If a Quantity is specified as the target unit, its magnitude will be ignored:

When no internet connectivity is available, a string representing the exchange ratio is returned in its place:

Some currencies may not have current exchange rate information. In that case, a string representing the exchange ratio is returned in its place:

This ratio can be set using replacement rules:

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

Text

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

CMS

Wolfram Language. 2014. "CurrencyConvert." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/CurrencyConvert.html.

APA

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

BibTeX

@misc{reference.wolfram_2025_currencyconvert, author="Wolfram Research", title="{CurrencyConvert}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/CurrencyConvert.html}", note=[Accessed: 13-August-2025]}

BibLaTeX

@online{reference.wolfram_2025_currencyconvert, organization={Wolfram Research}, title={CurrencyConvert}, year={2019}, url={https://reference.wolfram.com/language/ref/CurrencyConvert.html}, note=[Accessed: 13-August-2025]}