feat: add new isDate() validator

README.md

@@ -173,6 +173,8 @@ Sanitizer | Description
 **trim(input [, chars])** | trim characters (whitespace by default) from both sides of the input.
 **whitelist(input, chars)** | remove characters that do not appear in the whitelist. The characters are used in a RegExp and so you will need to escape some chars, e.g. `whitelist(input, '\\[\\]')`.
 **isSlug** | Check if the string is of type slug. `Options` allow a single hyphen between string. e.g. [`cn-cn`, `cn-c-c`]
+**isDate(input, [, format])** | Check if the input is a valid date. e.g. [`2002-07-15`, new Date()]
+`format` is a string and defaults to 'YYYY/MM/DD'
 
 ### XSS Sanitization
 

es/index.js

@@ -11,6 +11,7 @@ import isMACAddress from './lib/isMACAddress';
 import isIP from './lib/isIP';
 import isIPRange from './lib/isIPRange';
 import isFQDN from './lib/isFQDN';
+import isDate from './lib/isDate';
 import isBoolean from './lib/isBoolean';
 import isLocale from './lib/isLocale';
 import isAlpha, { locales as isAlphaLocales } from './lib/isAlpha';
@@ -176,6 +177,7 @@ var validator = {
  isWhitelisted: isWhitelisted,
  normalizeEmail: normalizeEmail,
  toString: toString,
- isSlug: isSlug
+ isSlug: isSlug,
+ isDate: isDate
 };
 export default validator;

es/lib/isDate.js

@@ -0,0 +1,63 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(Symbol.iterator in Object(arr))) return; var _arr = []; var _n = true; var _d = false; var _e = undefined; try { for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function isValidFormat(format) {
+ return /(^(y{4}|y{2})[\/-](m{1,2})[\/-](d{1,2})$)|(^(m{1,2})[\/-](d{1,2})[\/-]((y{4}|y{2})$))|(^(d{1,2})[\/-](m{1,2})[\/-]((y{4}|y{2})$))/gi.test(format);
+}
+
+function zip(date, format) {
+ var zippedArr = [],
+ len = Math.min(date.length, format.length);
+
+ for (var i = 0; i < len; i++) {
+ zippedArr.push([date[i], format[i]]);
+ }
+
+ return zippedArr;
+}
+
+export default function isDate(input) {
+ var format = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY/MM/DD';
+
+ if (typeof input === 'string' && isValidFormat(format)) {
+ var splitter = /[-/]/,
+ dateAndFormat = zip(input.split(splitter), format.toLowerCase().split(splitter)),
+ dateObj = {};
+
+ var _iterator = _createForOfIteratorHelper(dateAndFormat),
+ _step;
+
+ try {
+ for (_iterator.s(); !(_step = _iterator.n()).done;) {
+ var _step$value = _slicedToArray(_step.value, 2),
+ dateWord = _step$value[0],
+ formatWord = _step$value[1];
+
+ if (dateWord.length !== formatWord.length) {
+ return false;
+ }
+
+ dateObj[formatWord.charAt(0)] = dateWord;
+ }
+ } catch (err) {
+ _iterator.e(err);
+ } finally {
+ _iterator.f();
+ }
+
+ return new Date("".concat(dateObj.m, "/").concat(dateObj.d, "/").concat(dateObj.y)).getDate() === +dateObj.d;
+ }
+
+ return Object.prototype.toString.call(input) === '[object Date]' && isFinite(input);
+}

index.js

@@ -33,6 +33,8 @@ var _isIPRange = _interopRequireDefault(require("./lib/isIPRange"));
 
 var _isFQDN = _interopRequireDefault(require("./lib/isFQDN"));
 
+var _isDate = _interopRequireDefault(require("./lib/isDate"));
+
 var _isBoolean = _interopRequireDefault(require("./lib/isBoolean"));
 
 var _isLocale = _interopRequireDefault(require("./lib/isLocale"));
@@ -276,7 +278,8 @@ var validator = {
  isWhitelisted: _isWhitelisted.default,
  normalizeEmail: _normalizeEmail.default,
  toString: toString,
- isSlug: _isSlug.default
+ isSlug: _isSlug.default,
+ isDate: _isDate.default
 };
 var _default = validator;
 exports.default = _default;

lib/isDate.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+ value: true
+});
+exports.default = isDate;
+
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(Symbol.iterator in Object(arr))) return; var _arr = []; var _n = true; var _d = false; var _e = undefined; try { for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+function _createForOfIteratorHelper(o) { if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { if (Array.isArray(o) || (o = _unsupportedIterableToArray(o))) { var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var it, normalCompletion = true, didErr = false, err; return { s: function s() { it = o[Symbol.iterator](); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function isValidFormat(format) {
+ return /(^(y{4}|y{2})[\/-](m{1,2})[\/-](d{1,2})$)|(^(m{1,2})[\/-](d{1,2})[\/-]((y{4}|y{2})$))|(^(d{1,2})[\/-](m{1,2})[\/-]((y{4}|y{2})$))/gi.test(format);
+}
+
+function zip(date, format) {
+ var zippedArr = [],
+ len = Math.min(date.length, format.length);
+
+ for (var i = 0; i < len; i++) {
+ zippedArr.push([date[i], format[i]]);
+ }
+
+ return zippedArr;
+}
+
+function isDate(input) {
+ var format = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY/MM/DD';
+
+ if (typeof input === 'string' && isValidFormat(format)) {
+ var splitter = /[-/]/,
+ dateAndFormat = zip(input.split(splitter), format.toLowerCase().split(splitter)),
+ dateObj = {};
+
+ var _iterator = _createForOfIteratorHelper(dateAndFormat),
+ _step;
+
+ try {
+ for (_iterator.s(); !(_step = _iterator.n()).done;) {
+ var _step$value = _slicedToArray(_step.value, 2),
+ dateWord = _step$value[0],
+ formatWord = _step$value[1];
+
+ if (dateWord.length !== formatWord.length) {
+ return false;
+ }
+
+ dateObj[formatWord.charAt(0)] = dateWord;
+ }
+ } catch (err) {
+ _iterator.e(err);
+ } finally {
+ _iterator.f();
+ }
+
+ return new Date("".concat(dateObj.m, "/").concat(dateObj.d, "/").concat(dateObj.y)).getDate() === +dateObj.d;
+ }
+
+ return Object.prototype.toString.call(input) === '[object Date]' && isFinite(input);
+}
+
+module.exports = exports.default;
+module.exports.default = exports.default;

src/index.js

@@ -12,6 +12,7 @@ import isMACAddress from './lib/isMACAddress';
 import isIP from './lib/isIP';
 import isIPRange from './lib/isIPRange';
 import isFQDN from './lib/isFQDN';
+import isDate from './lib/isDate';
 
 import isBoolean from './lib/isBoolean';
 import isLocale from './lib/isLocale';
@@ -206,6 +207,7 @@ const validator = {
  normalizeEmail,
  toString,
  isSlug,
+ isDate,
 };
 
 export default validator;

src/lib/isDate.js

@@ -0,0 +1,34 @@
+function isValidFormat(format) {
+ return /(^(y{4}|y{2})[\/-](m{1,2})[\/-](d{1,2})$)|(^(m{1,2})[\/-](d{1,2})[\/-]((y{4}|y{2})$))|(^(d{1,2})[\/-](m{1,2})[\/-]((y{4}|y{2})$))/gi.test(format);
+}
+
+function zip(date, format) {
+ const zippedArr = [],
+ len = Math.min(date.length, format.length);
+
+ for (let i = 0; i < len; i++) {
+ zippedArr.push([date[i], format[i]]);
+ }
+
+ return zippedArr;
+}
+
+export default function isDate(input, format = 'YYYY/MM/DD') {
+ if (typeof input === 'string' && isValidFormat(format)) {
+ const splitter = /[-/]/,
+ dateAndFormat = zip(input.split(splitter), format.toLowerCase().split(splitter)),
+ dateObj = {};
+
+ for (const [dateWord, formatWord] of dateAndFormat) {
+ if (dateWord.length !== formatWord.length) {
+ return false;
+ }
+
+ dateObj[formatWord.charAt(0)] = dateWord;
+ }
+
+ return new Date(`${dateObj.m}/${dateObj.d}/${dateObj.y}`).getDate() === +dateObj.d;
+ }
+
+ return Object.prototype.toString.call(input) === '[object Date]' && isFinite(input);
+}

test/validators.js

@@ -8025,4 +8025,67 @@ describe('Validators', () => {
  ],
  });
  });
+
+ it('should validate date', () => {
+ test({
+ validator: 'isDate',
+ valid: [
+ new Date(),
+ new Date([2014, 2, 15]),
+ new Date('2014-03-15'),
+ '2020/02/29',
+ ],
+ invalid: [
+ '',
+ '15072002',
+ null,
+ undefined,
+ { year: 2002, month: 7, day: 15 },
+ 42,
+ { toString() { return '[object Date]'; } }, // faking
+ '2020-02-30', // invalid date
+ '2019-02-29', // non-leap year
+ '2020-04-31', // invalid date
+ ],
+ });
+ test({
+ validator: 'isDate',
+ args: ['DD/MM/YYYY'],
+ valid: [
+ '15-07-2002',
+ '15/07/2002',
+ ],
+ invalid: [
+ '15/7/2002',
+ '15-7-2002',
+ '15/7/02',
+ '15-7-02',
+ ],
+ });
+ test({
+ validator: 'isDate',
+ args: ['DD/MM/YY'],
+ valid: [
+ '15-07-02',
+ '15/07/02',
+ ],
+ invalid: [
+ '15/7/2002',
+ '15-7-2002',
+ ],
+ });
+ test({
+ validator: 'isDate',
+ args: ['D/M/YY'],
+ valid: [
+ '5-7-02',
+ '5/7/02',
+ ],
+ invalid: [
+ '5/07/02',
+ '15/7/02',
+ '15-7-02',
+ ],
+ });
+ });
 });