pip-services3-commons-nodex
Version:
Portable abstractions and patterns for Pip.Services in Node.js / ES2017
59 lines • 2.23 kB
JavaScript
;
/** @module convert */
Object.defineProperty(exports, "__esModule", { value: true });
exports.DateTimeConverter = void 0;
/**
* Converts arbitrary values into Date values using extended conversion rules:
* - Strings: converted using ISO time format
* - Numbers: converted using milliseconds since unix epoch
*
* ### Example ###
*
* let value1 = DateTimeConverter.toNullableDateTime("ABC"); // Result: null
* let value2 = DateTimeConverter.toNullableDateTime("2018-01-01T11:30:00.0"); // Result: Date(2018,0,1,11,30)
* let value3 = DateTimeConverter.toNullableDateTime(123); // Result: Date(123)
*/
class DateTimeConverter {
/**
* Converts value into Date or returns null when conversion is not possible.
*
* @param value the value to convert.
* @returns Date value or null when conversion is not supported.
*/
static toNullableDateTime(value) {
if (value == null)
return null;
if (value instanceof Date)
return value;
if (typeof value === "number")
return new Date(value);
let result = Date.parse(value);
return isNaN(result) ? null : new Date(result);
}
/**
* Converts value into Date or returns current date when conversion is not possible.
*
* @param value the value to convert.
* @returns Date value or current date when conversion is not supported.
*
* @see [[toDateTimeWithDefault]]
*/
static toDateTime(value) {
return DateTimeConverter.toDateTimeWithDefault(value, new Date());
}
/**
* Converts value into Date or returns default when conversion is not possible.
*
* @param value the value to convert.
* @param defaultValue the default value.
* @returns Date value or default when conversion is not supported.
*
* @see [[toNullableDateTime]]
*/
static toDateTimeWithDefault(value, defaultValue = null) {
let result = DateTimeConverter.toNullableDateTime(value);
return result != null ? result : defaultValue;
}
}
exports.DateTimeConverter = DateTimeConverter;
//# sourceMappingURL=DateTimeConverter.js.map