File Exchange

image thumbnail

num2cash

version 1.0.0 (2.47 KB) by Paul Shoemaker
Convert numbers to currency arrays

1 Download

Updated 21 Jul 2018

View License

% Converts numbers to currency unit character arrays
%
% NUM2CASH(AMOUNT) will convert the numeric AMOUNT (array or scalar) into a
% string with dollars and commas (e.g. AMOUNT=2500 is returned as $2,500.00).
%
% The formatting of the returned values can be configured using various
% NAME-VALUE pairs, as described below.
%
% - 'showDecimals' : Boolean flag that determinesif fractional values
% will be shown or if they'll be ROUNDED to the nearest
% whole currency unit. If set to TRUE then two decimal
% places will be shown for all values, including
% integer values. TRUE by default.
%
% - 'showParens' : Many accounting methods use parentheses to denote
% negative currency quantities. This boolean flag
% determines whether parentheses are used to denote
% negative values (e.g. negative $13 shown as ($13))
% or if a negative sign is used (e.g. negative $13
% shown as -$13). TRUE by default.
%
% - 'showSymbol' : Some users may just want to see numbers with comma
% separators and decimals without currency units. This
% boolean flag allows the user to turn currency unit
% display on or off. TRUE (on) by default.
%
% - 'currencySymbol': The user can specify any currency symbol, such as
% dollars ('$'), Euros (char(8364)), Yen or Yuan (char(165)),
% or British Pounds (char(163), as examples. Default
% value is dollars ('$').
%
% Example(s):
%
% numValues = [pi/8 pi -pi 10000*pi];
% strValues = num2cash(numValues,'showDecimals',true);

Cite As

Paul Shoemaker (2020). num2cash (https://www.mathworks.com/matlabcentral/fileexchange/68283-num2cash), MATLAB Central File Exchange. Retrieved .

Comments and Ratings (2)

Thanks, Stephen. I will look into both of those and test them out. I am always on the hunt for faster execution.

Kind regards.

@Paul Shoemaker: neat idea, with lots of options. You might be interested in checking out these submissions too:

<https://www.mathworks.com/matlabcentral/fileexchange/52832-num2sepstr>

<https://www.mathworks.com/matlabcentral/fileexchange/41520-insert-commas-into-numbers>

MATLAB Release Compatibility
Created with R2018a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Tags Add Tags