feat: time-value/ensure

README.md

@@ -386,6 +386,18 @@ coerceToTimeValue(Number.MAX_SAFE_INTEGER); // false
 coerceToTimeValue("foo"); // false
 ```
 
+##### `time-value/ensure`
+
+If given argument is a time value coercible value (via [`time-value/coerce`](#time-valuecoerce)) returns result number.
+Otherwise `TypeError` is thrown.
+
+```javascript
+const ensureTimeValue = require("type/time-value/ensure");
+
+ensureTimeValue(12.93); // "12"
+ensureTimeValue(Number.MAX_SAFE_INTEGER); // Thrown TypeError: null is not a natural number
+```
+
 ---
 
 ### Function

test/time-value/ensure.js

@@ -0,0 +1,17 @@
+"use strict";
+
+var assert          = require("chai").assert
+  , ensureTimeValue = require("../../time-value/ensure");
+
+describe("time-value/ensure", function () {
+	it("Should return coerced value", function () { assert.equal(ensureTimeValue("12.23"), 12); });
+	it("Should crash on no value", function () {
+		try {
+			ensureTimeValue("foo");
+			throw new Error("Unexpected");
+		} catch (error) {
+			assert.equal(error.name, "TypeError");
+			assert.equal(error.message, "foo is not a time value");
+		}
+	});
+});

time-value/ensure.js

@@ -0,0 +1,10 @@
+"use strict";
+
+var resolveException = require("../lib/resolve-exception")
+  , coerce           = require("./coerce");
+
+module.exports = function (value/*, options*/) {
+	var coerced = coerce(value);
+	if (coerced !== null) return coerced;
+	return resolveException(value, "%v is not a time value", arguments[1]);
+};