Apple Numbers CURRENCYCONVERT Function: Currency Context and Rate Controls
Convert documented currency inputs with explicit target codes and validate surrounding arithmetic using clearly fictional fixed-rate fixtures.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
CURRENCYCONVERT expresses a currency amount in a target currency using remotely retrieved exchange-rate data from the previous market day’s close. Its result depends on the source denomination, target code, data availability and market date. It is not a fixed-rate arithmetic function with one permanent numeric answer.
Availability and verification
The official CURRENCYCONVERT reference was retrieved October 15, 2026. The original function-introduction release and last functioning version are unknown from the checked sources. Current shared function documentation is not a last-working-build test or evidence of identical behavior on every older Mac, iPad, iPhone and iCloud client.
No native Numbers session was executed. The examples use independent arithmetic or constrained text models, with data-dependent results identified explicitly. Public-source retrieval is separate from native verification.
Syntax and source-currency context
CURRENCYCONVERT(value, currency-code)
value supplies the amount to convert. If it is not already a currency value, Apple uses the default currency associated with the applicable language and region. currency-code identifies the target currency, using an ISO 4217 code such as EUR or USD.
The dedicated page contains a one-argument example even though its argument list describes the target-code argument without an explicit optional/default rule. This guide supplies both arguments and does not infer a universal omitted-target behavior from that example.
Documented formulas with data-dependent results
In Apple’s pound-text example, =CURRENCYCONVERT("£6","EUR") returns the euro value of six pounds at the previous market close. The exact number changes with the retrieved rate; no current exchange quote is asserted here.
Apple also gives =CURRENCYCONVERT(C3,"USD") when C3 contains the currency value ¥5 and the context is Chinese (Simplified, China mainland). That stated context identifies the yuan input. It should not be changed to an arbitrary text string or a different region while retaining the same expected source currency.
Complete fixed-rate control worksheet
Use a separate deterministic fixture to check the arithmetic around a conversion. Assume, solely for this fictional control, 1 GBP = 1.20 EUR. This is not a retrieved market quote.
| Source amount in GBP | Fixed EUR per GBP assumption | Independent EUR target |
|---|---|---|
| 6 | 1.20 | 7.20 |
| 25 | 1.20 | 30 |
| 100 | 1.20 | 120 |
| 250 | 1.20 | 300 |
Put source amounts in A2:A5 and the fixed assumption 1.20 in B1. A plain arithmetic control =A2*$B$1, filled down, produces those targets. It does not invoke CURRENCYCONVERT or claim to override the service’s exchange rate.
If a captured conversion quote were exactly 1.20 EUR per GBP, these would be the corresponding multiplication targets. Retain that conditional wording when comparing a service result with a fixed model.
Advanced: check direction and reciprocal units
With the same fictional quote, converting 120 EUR back to GBP by arithmetic gives 120/1.20 = 100 GBP. Multiplying 120 by 1.20 instead gives 144 and uses the wrong direction for this stated rate.
Record rate units explicitly as “EUR per GBP,” rather than labelling a column merely “rate.” A reverse market quote need not be guaranteed to equal an exact mathematical reciprocal after provider rounding or differing observations; the reciprocal above is only the fixed control’s identity.
Advanced: quantify a rate-assumption difference
For 100 GBP, the fixed assumptions 1.18, 1.20 and 1.22 EUR per GBP produce 118, 120 and 122 EUR. The difference between the first and last scenarios is 4 EUR.
These scenarios help verify a report’s sensitivity without claiming that any of the three rates is current. If an actual result differs, inspect the source currency and the quote’s effective market date before concluding that the multiplication is wrong.
Market-day timing and reproducibility
Previous market close is not necessarily yesterday’s calendar date. Weekends and market holidays can make those descriptions differ. The source does not provide a complete refresh timetable or promise a real-time executable transaction rate.
For a reproducible report, retain the source amount, source currency, target currency, observed converted amount and the date/context of the observation. This guide did not retrieve a native quote or create such a snapshot; it specifies the information needed to audit one.
Errors and troubleshooting
Check the input’s actual currency type and the document’s language/region setting if a plain number converts from the wrong denomination. Formatting an amount with a symbol does not by itself prove that the intended stored currency context was established.
The dedicated page identifies remote internet data but does not supply an exhaustive native error-code matrix for unsupported codes, failed retrieval, malformed text or offline behavior. Do not copy a related function’s exact outage response into this one without evidence.
A displayed conversion is an informational spreadsheet result. It does not include a guaranteed bank quote, fees or a promise that a transaction can be completed at that rate. Verify those separately when they matter to the user’s actual calculation.