Wolfram Function Repository
Instant-use add-on functions for the Wolfram Language
Function Repository Resource:
Convert a Quantity to a linear string in a customizable way
ResourceFunction["QuantityString"][quantity] converts quantity to a linear string by abbreviating the canonical unit with standard short forms. | |
ResourceFunction["QuantityString"][quantity,"BoxForm"] converts quantity to a linear string that resembles the default typesetting in the front end. | |
ResourceFunction["QuantityString"][quantity, template] formats the output using a StringTemplate. |
Define a Quantity composed of different units:
In[1]:= |
Out[1]= |
Convert it to a simple String, using ^ and / to linearize the different powers:
In[2]:= |
Out[2]= |
Compare this with the InputForm of the QuantityUnit of this Quantity:
In[3]:= |
Out[3]= |
Display the unit in the same way the FrontEnd does:
In[4]:= |
Out[4]= |
In[5]:= |
Out[5]= |
Define your own output format:
In[6]:= |
Out[6]= |
See all the elements that you can access inside of the template:
In[7]:= |
Out[7]= |
Use this to define a more elaborate output:
In[8]:= |
Out[8]= |
Not all types of quantities have only four elements:
In[9]:= |
Out[9]= |
In[10]:= |
Out[10]= |
Most of the elements available in the template come from the box representation of the quantity:
In[11]:= |
Out[11]= |
The "BoxForm" output replaces the superscript primes with apostrophes:
In[12]:= |
Out[12]= |
The canonical form riffles the magnitudes with the canonical unit abbreviations:
In[13]:= |
Out[13]= |
Convert different currencies. Note that the position of the currency sign is respected:
In[14]:= |
Out[14]= |
Dated units are supported:
In[15]:= |
Out[15]= |
In[16]:= |
Out[16]= |
In the canonical form, the date will be typeset in the ISO format:
In[17]:= |
Out[17]= |
There is no guarantee that the strings can be converted back to quantities again:
In[18]:= |
Out[18]= |
In[19]:= |
Out[19]= |
In[20]:= |
Out[20]= |
The canonical unit string always places the unit after the magnitude, which is not always the typical way to typeset a unit:
In[21]:= |
Out[21]= |
Use a template or the BoxForm appearance to typeset the canonical unit differently:
In[22]:= |
Out[22]= |
In[23]:= |
Out[23]= |
Use HoldForm to prevent evaluation of expressions in the first argument of Quantity:
In[24]:= |
Out[24]= |
Compare this to the evaluated form:
In[25]:= |
Out[25]= |
Alternatively you can use Row to typeset this correctly:
In[26]:= |
Out[26]= |
This will also work with the default formatting:
In[27]:= |
Out[27]= |
Wolfram Language 13.0 (December 2021) or above
This work is licensed under a Creative Commons Attribution 4.0 International License