Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • Compute Services
  • System Modeler
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

Wolfram Consulting

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Notebook Assistant + LLM Kit
    • Compute Services
    • System Modeler
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
Quantity
  • See Also
    • QuantityArray
    • QuantityUnit
    • QuantityMagnitude
    • UnitConvert
    • CompatibleUnitQ
    • QuantityQ
    • MixedMagnitude
    • MixedUnit
    • QuantityDistribution
    • EntityCopies
    • QuantityVariable
    • QuantityForm
    • Around
    • ChemicalInstance

    • Entity Types
    • PhysicalQuantity

    • Interpreter Types
    • Quantity

    • Menu Items
    • Inline Free-form Input
  • Related Guides
    • Financial Computation
    • Units & Quantities
    • Scientific Data Analysis
    • Engineering Data
    • Physics & Chemistry: Data and Computation
    • Astronomical Computation & Data
    • Maps & Cartography
    • WDF (Wolfram Data Framework)
    • Probability & Statistics with Quantities
    • Scientific Models
    • Database Connectivity
    • Numbers with Uncertainty
    • Angles and Polar Coordinates
    • Knowledge Representation & Access
  • Workflows
    • Calculate with Units
    • Enter Quantities with Units
  • Tech Notes
    • Units Overview
    • See Also
      • QuantityArray
      • QuantityUnit
      • QuantityMagnitude
      • UnitConvert
      • CompatibleUnitQ
      • QuantityQ
      • MixedMagnitude
      • MixedUnit
      • QuantityDistribution
      • EntityCopies
      • QuantityVariable
      • QuantityForm
      • Around
      • ChemicalInstance

      • Entity Types
      • PhysicalQuantity

      • Interpreter Types
      • Quantity

      • Menu Items
      • Inline Free-form Input
    • Related Guides
      • Financial Computation
      • Units & Quantities
      • Scientific Data Analysis
      • Engineering Data
      • Physics & Chemistry: Data and Computation
      • Astronomical Computation & Data
      • Maps & Cartography
      • WDF (Wolfram Data Framework)
      • Probability & Statistics with Quantities
      • Scientific Models
      • Database Connectivity
      • Numbers with Uncertainty
      • Angles and Polar Coordinates
      • Knowledge Representation & Access
    • Workflows
      • Calculate with Units
      • Enter Quantities with Units
    • Tech Notes
      • Units Overview

Quantity[magnitude,unit]

represents a quantity with size magnitude and unit specified by unit.

Quantity[unit]

assumes the magnitude of the specified unit to be 1.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Applications  
Properties & Relations  
Possible Issues  
See Also
Tech Notes
Related Guides
Related Workflows
Related Links
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • QuantityArray
    • QuantityUnit
    • QuantityMagnitude
    • UnitConvert
    • CompatibleUnitQ
    • QuantityQ
    • MixedMagnitude
    • MixedUnit
    • QuantityDistribution
    • EntityCopies
    • QuantityVariable
    • QuantityForm
    • Around
    • ChemicalInstance

    • Entity Types
    • PhysicalQuantity

    • Interpreter Types
    • Quantity

    • Menu Items
    • Inline Free-form Input
  • Related Guides
    • Financial Computation
    • Units & Quantities
    • Scientific Data Analysis
    • Engineering Data
    • Physics & Chemistry: Data and Computation
    • Astronomical Computation & Data
    • Maps & Cartography
    • WDF (Wolfram Data Framework)
    • Probability & Statistics with Quantities
    • Scientific Models
    • Database Connectivity
    • Numbers with Uncertainty
    • Angles and Polar Coordinates
    • Knowledge Representation & Access
  • Workflows
    • Calculate with Units
    • Enter Quantities with Units
  • Tech Notes
    • Units Overview
    • See Also
      • QuantityArray
      • QuantityUnit
      • QuantityMagnitude
      • UnitConvert
      • CompatibleUnitQ
      • QuantityQ
      • MixedMagnitude
      • MixedUnit
      • QuantityDistribution
      • EntityCopies
      • QuantityVariable
      • QuantityForm
      • Around
      • ChemicalInstance

      • Entity Types
      • PhysicalQuantity

      • Interpreter Types
      • Quantity

      • Menu Items
      • Inline Free-form Input
    • Related Guides
      • Financial Computation
      • Units & Quantities
      • Scientific Data Analysis
      • Engineering Data
      • Physics & Chemistry: Data and Computation
      • Astronomical Computation & Data
      • Maps & Cartography
      • WDF (Wolfram Data Framework)
      • Probability & Statistics with Quantities
      • Scientific Models
      • Database Connectivity
      • Numbers with Uncertainty
      • Angles and Polar Coordinates
      • Knowledge Representation & Access
    • Workflows
      • Calculate with Units
      • Enter Quantities with Units
    • Tech Notes
      • Units Overview

Quantity

Quantity[magnitude,unit]

represents a quantity with size magnitude and unit specified by unit.

Quantity[unit]

assumes the magnitude of the specified unit to be 1.

Details

  • In Quantity[m,u], the unit u can be given as a string, such as "Meters", or a product of powers of units, such as "Meters"/"Seconds"^2.
  • Supported units include all those specified by NIST Special Publication 811.
  • Quantity expresses temperatures using units such as "DegreesCelsius" and temperature differences using units such as "DegreesCelsiusDifference". Quantity arithmetic operations systematically distinguish this.
  • Quantity operations systematically distinguish temperatures, expressed using units such as "DegreesCelsius", from temperature differences, expressed using units such as "DegreesCelsiusDifference".
  • Quantity[unit] will produce a canonicalized Quantity with a magnitude of 1.
  • Quantity expressions can be created by using the free-form linguistics interface.
  • Quantity will automatically attempt to parse an unknown unit string to its canonical form.
  • Quantity has attribute HoldRest and preserves the structure of unit.
  • For purely numeric units, such as percents, Normal[expr] converts a Quantity object to an ordinary number.
  • Information of a Quantity may include the following properties:
  • "Magnitude"quantity magnitude
    "Unit"unit associated with the quantity
    "UnitDimensions"physical dimensions of unit
    "SIBaseUnits"SI base units

Examples

open all close all

Basic Examples  (4)

A Quantity represents a value associated with a specific unit:

Use to enter quantities and units:

Compound unit expressions can also be found using :

A unit can be a string or a product of strings:

Valid unit specifications include a number of physical constants:

Quantity will automatically attempt to interpret an unknown unit string:

Scope  (7)

Quantity expressions can be used in comparison functions:

Use MixedMagnitude and MixedUnit specifications to define a mixed Quantity:

Quantity expressions can be used in various list operations:

Many numerical functions also operate on Quantity expressions:

Integer functions also operate on Quantity expressions:

Normal will return the fundamental value for dimensionless Quantity expressions:

N may be used to numericize Quantity expressions:

N will not change the units associated with a Quantity expression, including physical constants:

UnitConvert can be used to find the SI value of physical constants:

Applications  (2)

Use FormulaData with Quantity objects to determine the escape velocity of the Earth and of the Sun:

Use FormulaData with Quantity objects to visualize the spectral radiance of a black body at temperature 5000 kelvins as a function of wavelength:

Properties & Relations  (15)

A unit can be given as a string or product of strings:

IndependentUnit specifications can also be used:

Units accept prefixes that are used to form decimal multiples and submultiples of units:

In its one-argument form, Quantity automatically sets the magnitude to 1:

The first argument of Quantity can also be a Quantity object, in which case units are multiplied:

Additions of Quantity objects with compatible units will heuristically determine the result units:

Products of Quantity objects with compatible units will heuristically determine the result units:

Subtraction of temperatures in non-absolute scales like Celsius or Fahrenheit produces temperature differences:

Addition of a temperature and a temperature difference gives another temperature:

Operations involving products and divisions of temperatures may convert automatically to kelvins:

This result is equivalent to converting the temperature in advance:

Quantity threads its unit specification over lists:

Canonical unit strings are always plural. Unit descriptions will accurately reflect the singular form of a unit:

Since Quantity is HoldRest, it can accept multiple unit strings of the same dimension:

When quantities are multiplied, the resulting unit is not automatically simplified:

Use UnitSimplify to get a simpler form of the unit:

Use UnitConvert to normalize mixed Quantity expressions to non-mixed Quantity expressions:

Use QuantityArray to describe rectangular arrays of Quantity objects of common units:

Normal converts the structured array into an equivalent normal array of Quantity objects:

Possible Issues  (2)

Quantity automatically attempts to interpret unrecognized unit strings as canonical units:

Expressions composed of unrecognized unit strings cannot be interpreted in this way:

Instead, the unit should be specified as a single string:

Some units contain Interval expressions, which can result in comparisons returning unevaluated:

See Also

QuantityArray  QuantityUnit  QuantityMagnitude  UnitConvert  CompatibleUnitQ  QuantityQ  MixedMagnitude  MixedUnit  QuantityDistribution  EntityCopies  QuantityVariable  QuantityForm  Around  ChemicalInstance

Entity Types: PhysicalQuantity

Interpreter Types: Quantity

Menu Items: Inline Free-form Input

Tech Notes

    ▪
  • Units Overview

Related Guides

    ▪
  • Financial Computation
  • ▪
  • Units & Quantities
  • ▪
  • Scientific Data Analysis
  • ▪
  • Engineering Data
  • ▪
  • Physics & Chemistry: Data and Computation
  • ▪
  • Astronomical Computation & Data
  • ▪
  • Maps & Cartography
  • ▪
  • WDF (Wolfram Data Framework)
  • ▪
  • Probability & Statistics with Quantities
  • ▪
  • Scientific Models
  • ▪
  • Database Connectivity
  • ▪
  • Numbers with Uncertainty
  • ▪
  • Angles and Polar Coordinates
  • ▪
  • Knowledge Representation & Access

Related Workflows

    Related Workflows
    ▪
  • Calculate with Units
  • ▪
  • Enter Quantities with Units

Related Links

  • An Elementary Introduction to the Wolfram Language : Units

History

Introduced in 2012 (9.0) | Updated in 2014 (10.0) ▪ 2019 (12.0) ▪ 2022 (13.2)

Wolfram Research (2012), Quantity, Wolfram Language function, https://reference.wolfram.com/language/ref/Quantity.html (updated 2022).

Text

Wolfram Research (2012), Quantity, Wolfram Language function, https://reference.wolfram.com/language/ref/Quantity.html (updated 2022).

CMS

Wolfram Language. 2012. "Quantity." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/Quantity.html.

APA

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

BibTeX

@misc{reference.wolfram_2025_quantity, author="Wolfram Research", title="{Quantity}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/Quantity.html}", note=[Accessed: 01-March-2026]}

BibLaTeX

@online{reference.wolfram_2025_quantity, organization={Wolfram Research}, title={Quantity}, year={2022}, url={https://reference.wolfram.com/language/ref/Quantity.html}, note=[Accessed: 01-March-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English