# subtracting(_:) Returns a new measurement by subtracting the specified measurement from the receiver. ``` func subtracting(_ measurement: Measurement) -> Measurement ``` ## Parameters `measurement` The measurement to be subtracted. ## Return Value A new measurement with a value equal to the receiver’s value minus the value of the specified measurement converted into the unit of the receiver. ## Discussion This method raises an [`invalidArgumentException`](/documentation/Foundation/NSExceptionName/invalidArgumentException) if the receiver cannot be converted to unit. You can use the [`canBeConverted(to:)`](/documentation/Foundation/NSMeasurement/canBeConverted(to:)) method, passing the unit of the specified measurement, to determine whether a measurement can be converted to a particular unit before calling this method. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)