datatables.net-datetime 1.0.1 → 1.1.2

package/test/api/dateTime.errorMsg().js

@@ -0,0 +1,52 @@
+describe('dateTime - api - errorMsg()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el;
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.errorMsg).toBe('function');
+		});
+		it('Clearer returns an API instance', function () {
+			expect(el.errorMsg() instanceof DateTime).toBe(true);
+		});
+		it('Setter returns an API instance', function () {
+			expect(el.errorMsg('test') instanceof DateTime).toBe(true);
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.errorMsg('test');
+
+			expect($('.dt-datetime-error').length).toBe(0);
+		});
+		it('... displayed when opened', function () {
+			$('#test').click();
+			expect($('.dt-datetime-error').length).toBe(1);
+			expect($('.dt-datetime-error').text()).toBe('test');
+		});
+		it('... changed when opened', function () {
+			el.errorMsg('unittest');
+			expect($('.dt-datetime-error').length).toBe(1);
+			expect($('.dt-datetime-error').text()).toBe('unittest');
+		});
+		it('... changed when opened', function () {
+			el.errorMsg('this is a long string for testing purposes to see how it looks');
+			expect($('.dt-datetime-error').length).toBe(1);
+			expect($('.dt-datetime-error').text()).toBe('this is a long string for testing purposes to see how it looks');
+		});
+		it('... cleared when opened', function () {
+			el.errorMsg();
+			expect($('.dt-datetime-error').length).toBe(1);
+			expect($('.dt-datetime-error').text()).toBe('');
+		});
+	});
+});

package/test/api/dateTime.hide().js

@@ -0,0 +1,49 @@
+describe('dateTime - api - hide()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el;
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.hide).toBe('function');
+		});
+		it('Returns an API instance', function () {
+			expect(el.hide('test') instanceof DateTime).toBe(true);
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Hide when picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.hide();
+
+			expect($('.dt-datetime').length).toBe(0);
+		});
+		it('... date picker can be opened', function () {
+			$('#test').click();
+			expect($('.dt-datetime').length).toBe(1);
+		});
+
+		dt.html('input');
+		it('Hide when picker open', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			$('#test').click();
+
+			expect($('.dt-datetime').length).toBe(1);
+
+			el.hide();
+
+			expect($('.dt-datetime').length).toBe(0);
+		});
+		it('... date picker can be opened', function () {
+			$('#test').click();
+			expect($('.dt-datetime').length).toBe(1);
+		});
+	});
+});

package/test/api/dateTime.max().js

@@ -0,0 +1,86 @@
+describe('dateTime - api - max()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el;
+
+	function pad(num) {
+		return num < 10 ? '0' + num : num;
+	}
+
+	function getToday() {
+		let d = new Date();
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + pad(d.getDate());
+	}
+
+	function getMidMonth() {
+		let d = new Date();
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + '15';
+	}
+
+	function get20YearsAgo() {
+		let d = new Date();
+		return d.getFullYear() - 20 + '-' + pad(1 + d.getMonth()) + '-' + '15';
+	}
+
+	let thisYear = new Date().getFullYear().toString();
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.max).toBe('function');
+		});
+		it('Setting with a string returns an API instance', function () {
+			expect(el.max(getToday()) instanceof DateTime).toBe(true);
+		});
+		it('Setter returns an API instance', function () {
+			expect(el.max(new Date(getToday())) instanceof DateTime).toBe(true);
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('String - When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.max(getMidMonth());
+			expect($('.dt-datetime-error').length).toBe(0);
+		});
+		it('... applied when opened', function () {
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(26);
+			expect($('select.dt-datetime-year option:last-child').val()).toBe(thisYear);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(false);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+		it('... set when opened', function () {
+			el.max(get20YearsAgo());
+			expect($('select.dt-datetime-year option').length).toBe(6);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+
+		dt.html('input');
+		it('Date - When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.max(new Date(getMidMonth()));
+			expect($('.dt-datetime-error').length).toBe(0);
+		});
+		it('... applied when opened', function () {
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(26);
+			expect($('select.dt-datetime-year option:last-child').val()).toBe(thisYear);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(false);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+		it('... set when opened', function () {
+			el.max(new Date(get20YearsAgo()));
+			expect($('select.dt-datetime-year option').length).toBe(6);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+
+	});
+});

package/test/api/dateTime.min().js

@@ -0,0 +1,85 @@
+describe('dateTime - api - min()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el;
+
+	function pad(num) {
+		return num < 10 ? '0' + num : num;
+	}
+
+	function getToday() {
+		let d = new Date();
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + pad(d.getDate());
+	}
+
+	function getMidMonth() {
+		let d = new Date();
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + '15';
+	}
+
+	function get20YearsAhead() {
+		let d = new Date();
+		return d.getFullYear() + 20 + '-' + pad(1 + d.getMonth()) + '-' + '15';
+	}
+
+	let thisYear = new Date().getFullYear().toString();
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.min).toBe('function');
+		});
+		it('Setting with a string returns an API instance', function () {
+			expect(el.min(getToday()) instanceof DateTime).toBe(true);
+		});
+		it('Setter returns an API instance', function () {
+			expect(el.min(new Date(getToday())) instanceof DateTime).toBe(true);
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('String - When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.min(getMidMonth());
+			expect($('.dt-datetime-error').length).toBe(0);
+		});
+		it('... applied when opened', function () {
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(26);
+			expect($('select.dt-datetime-year option:first-child').val()).toBe(thisYear);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(false);
+		});
+		it('... set when opened', function () {
+			el.min(get20YearsAhead());
+			expect($('select.dt-datetime-year option').length).toBe(6);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+
+		dt.html('input');
+		it('Date - When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {});
+			el.min(new Date(getMidMonth()));
+			expect($('.dt-datetime-error').length).toBe(0);
+		});
+		it('... applied when opened', function () {
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(26);
+			expect($('select.dt-datetime-year option:first-child').val()).toBe(thisYear);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(false);
+		});
+		it('... set when opened', function () {
+			el.min(new Date(get20YearsAhead()));
+			expect($('select.dt-datetime-year option').length).toBe(6);
+			expect($('tbody tr:eq(1) td:eq(0)').hasClass('disabled')).toBe(true);
+			expect($('tbody tr:eq(3) td:eq(0)').hasClass('disabled')).toBe(true);
+		});
+	});
+});

package/test/api/dateTime.owns().js

@@ -0,0 +1,53 @@
+describe('dateTime - api - owns()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el, el2;
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.owns).toBe('function');
+		});
+		it('Returns a boolean', function () {
+			expect(typeof el.owns()).toBe('boolean');
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('When picker closed', function () {
+			el = new DateTime(document.getElementById('test'), {format: 'YYYY-MM-DD HH:mm:ss'});
+			expect(el.owns('')).toBe(false);
+			expect(el.owns($('#test'))).toBe(false);
+		});
+		it('... when opened', function () {
+			$('#test').click();
+			expect(el.owns('')).toBe(false);
+			expect(el.owns($('#test'))).toBe(false);
+			expect(el.owns($('.dt-datetime-month'))).toBe(true);
+			expect(el.owns($('.dt-datetime-minutes'))).toBe(true);
+			expect(el.owns($('.now'))).toBe(true);
+		});
+
+		it('Initialise second element', function () {
+			el2 = new DateTime(document.getElementById('value'));
+
+			expect(el2.owns('')).toBe(false);
+			expect(el2.owns($('#test'))).toBe(false);
+			expect(el2.owns($('.dt-datetime-month'))).toBe(false);
+			expect(el2.owns($('.dt-datetime-minutes'))).toBe(false);
+			expect(el2.owns($('.now'))).toBe(false);
+		});
+		it('... first still owns', function () {
+			expect(el.owns('')).toBe(false);
+			expect(el.owns($('#test'))).toBe(false);
+			expect(el.owns($('.dt-datetime-month'))).toBe(true);
+			expect(el.owns($('.dt-datetime-minutes'))).toBe(true);
+			expect(el.owns($('.now'))).toBe(true);
+		});
+	});
+});

package/test/api/dateTime.val().js

@@ -0,0 +1,70 @@
+describe('dateTime - api - val()', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let el;
+
+	function pad(num) {
+		return num < 10 ? '0' + num : num;
+	}
+
+	// TK COLIN make this a generic function somewhere as repeated
+	function format(d) {
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + pad(d.getDate());
+	}
+
+	let today = format(new Date());
+
+	describe('Check the defaults', function () {
+		dt.html('input');
+		it('Ensure its a function', function () {
+			el = new DateTime(document.getElementById('test'));
+			expect(typeof el.min).toBe('function');
+		});
+		it('Getter returns null if no date set', function () {
+			expect(el.val()).toBe(null);
+		});
+		it('Setter returns an API instance', function () {
+			expect(el.val(today) instanceof DateTime).toBe(true);
+		});
+		it('Getter returns an Date instance', function () {
+			expect(el.val() instanceof Date).toBe(true);
+		});
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Get value when set in element', function () {
+			el = new DateTime(document.getElementById('value'));
+			expect(format(el.val())).toBe('2021-10-20');
+		});
+		it('... applied when opened', function () {
+			$('#value').click();
+			expect(format(el.val())).toBe('2021-10-20');
+		});
+		it('... set when opened', function () {
+			el.val(today);
+			expect(format(el.val())).toBe(today);
+		});
+
+		dt.html('input');
+		it('Set time element', function () {
+			el = new DateTime(document.getElementById('test'), {format: 'HH:mm'});
+			el.val('11:22');
+			expect(el.val().getHours()).toBe(11);
+			expect(el.val().getMinutes()).toBe(22);
+		});
+		it('... set when opened', function () {
+			$('#test').click();
+			el.val('10:33');
+			expect(el.val().getHours()).toBe(10);
+			expect(el.val().getMinutes()).toBe(33);
+		});
+		it('... updates display', function () {
+			expect($('.dt-datetime-hours .selected').text()).toBe('10');
+			expect($('.dt-datetime-minutes .selected').text()).toBe('33');
+		});
+	});
+});

package/test/options/dateTime.YearRange.js

@@ -0,0 +1,51 @@
+describe('dateTime - options - yearRange', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	function pad(num) {
+		return num < 10 ? '0' + num : num;
+	}
+
+	function getToday() {
+		let d = new Date();
+		return d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + pad(d.getDate());
+	}
+
+	describe('Functional tests', function () {
+		let thisYear = new Date().getFullYear();
+
+		dt.html('input');
+		it('Default', function () {
+			new DateTime(document.getElementById('test'), {});
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(51);
+			expect($('select.dt-datetime-year option:first-child').val()).toBe((thisYear - 25).toString());
+			expect($('select.dt-datetime-year option:last-child').val()).toBe((thisYear + 25).toString());
+		});
+
+		dt.html('input');
+		it('Custom number', function () {
+			new DateTime(document.getElementById('test'), {
+				yearRange: 5
+			});
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(11);
+			expect($('select.dt-datetime-year option:first-child').val()).toBe((thisYear - 5).toString());
+			expect($('select.dt-datetime-year option:last-child').val()).toBe((thisYear + 5).toString());
+		});
+
+		dt.html('input');
+		it('When used with maxDate', function () {
+			new DateTime(document.getElementById('test'), {
+				yearRange: 5,
+				maxDate: getToday()
+			});
+			$('#test').click();
+			expect($('select.dt-datetime-year option').length).toBe(6);
+			expect($('select.dt-datetime-year option:first-child').val()).toBe((thisYear - 5).toString());
+			expect($('select.dt-datetime-year option:last-child').val()).toBe(thisYear.toString());
+		});
+	});
+});

package/test/options/dateTime.disableDays.js

@@ -0,0 +1,46 @@
+describe('dateTime - options - disableDays', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	let table;
+
+	function checkDays(expected) {
+		for (i in expected) {
+			expect($('.dt-datetime-date tbody tr:eq(1) td:eq(' + i + ')').hasClass('disabled')).toBe(expected[i]);
+		}
+	}
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Default - all enabled', function () {
+			new DateTime(document.getElementById('value'), {});
+			$('#value').click();
+			checkDays([false, false, false, false, false, false, false]);
+			expect($('.dt-datetime-date tbody td.disabled').length).toBe(0);
+		});
+
+		dt.html('input');
+		it('Array', function () {
+			new DateTime(document.getElementById('value'), {
+				disableDays: [1, 2]
+			});
+			$('#value').click();
+			checkDays([true, true, false, false, false, false, false]);
+			expect($('.dt-datetime-date tbody td.disabled').length).toBeGreaterThan(7);
+		});
+
+		dt.html('input');
+		it('Function', function () {
+			new DateTime(document.getElementById('value'), {
+				disableDays: function (day) {
+					return day.toString().includes('Oct 0')? true : false;
+				}
+			});
+			$('#value').click();
+			checkDays([true, true, true, true, true, true, false]);
+			expect($('.dt-datetime-date tbody td.disabled').length).toBe(9);
+		});
+	});
+});

package/test/options/dateTime.firstDay.js

@@ -0,0 +1,33 @@
+describe('dateTime - options - firstDay', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Default', function () {
+			new DateTime(document.getElementById('test'), {});
+			$('#test').click();
+			expect($('.dt-datetime-date thead th').text()).toBe('MonTueWedThuFriSatSun');
+		});
+
+		dt.html('input');
+		it('Mid-week', function () {
+			new DateTime(document.getElementById('test'), {firstDay: 3});
+
+			expect($('.dt-datetime').length).toBe(0);
+			$('#test').click();
+			expect($('.dt-datetime-date thead th').text()).toBe('WedThuFriSatSunMonTue');
+		});
+
+		dt.html('input');
+		it('end of week', function () {
+			new DateTime(document.getElementById('test'), {firstDay: 6});
+
+			expect($('.dt-datetime').length).toBe(0);
+			$('#test').click();
+			expect($('.dt-datetime-date thead th').text()).toBe('SatSunMonTueWedThuFri');
+		});
+	});
+});

package/test/options/dateTime.format.js

@@ -0,0 +1,85 @@
+describe('dateTime - options - format', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	function pad(num) {
+		return num < 10 ? '0' + num : num;
+	}
+
+	function getToday(rev = false) {
+		let d = new Date();
+		return rev
+			? pad(d.getDate()) + '-' + pad(1 + d.getMonth()) + '-' + d.getFullYear()
+			: d.getFullYear() + '-' + pad(1 + d.getMonth()) + '-' + pad(d.getDate());
+	}
+
+	function getNow() {
+		let d = new Date();
+		return (
+			d.getFullYear() +
+			'-' +
+			pad(1 + d.getMonth()) +
+			'-' +
+			pad(d.getDate()) +
+			' ' +
+			pad(d.getUTCHours()) +
+			':' +
+			pad(d.getUTCMinutes()) +
+			':' +
+			pad(d.getUTCSeconds())
+		);
+	}
+
+	let time1, time2;
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Default - no time', function () {
+			new DateTime(document.getElementById('test'), {});
+			$('#test').click();
+			expect($('.dt-datetime-time').is(':visible')).toBe(false);
+		});
+		it('... confirm setting', function () {
+			$('.now button span').click();
+			expect($('#test').val()).toBe(getToday());
+		});
+
+		dt.html('input');
+		it('Reverse', function () {
+			new DateTime(document.getElementById('test'), {format: 'DD-MM-YYYY'});
+			$('#test').click();
+			$('.now button span').click();
+			expect($('#test').val()).toBe(getToday(true));
+		});
+
+		dt.html('input');
+		it('Only year', function () {
+			new DateTime(document.getElementById('test'), {format: 'YYYY'});
+			$('#test').click();
+			$('.now button span').click();
+			expect($('#test').val()).toBe(new Date().getFullYear().toString());
+		});
+
+		dt.html('input');
+		it('With time', function () {
+			new DateTime(document.getElementById('test'), {format: 'YYYY-MM-DD HH:mm:ss'});
+			time1 = getNow();
+			$('#test').click();
+			expect($('.dt-datetime-time').is(':visible')).toBe(true);
+		});
+		it('... confirm setting', function () {
+			// get two times in case it flips over
+			$('.now button span').click();
+			time2 = getNow();
+			let val = $('#test').val();
+
+			console.log(time1);
+			console.log(time2);
+			console.log(val);
+
+			expect(val == time1 || val == time2).toBe(true);
+		});
+	});
+});

package/test/options/dateTime.i18n.amPm.js

@@ -0,0 +1,35 @@
+describe('dateTime - i18n - amPm', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Default', function () {
+			let el = new DateTime(document.getElementById('test'), {
+				format: 'HH:mm A'
+			});
+
+			$('#test').click();
+
+			expect($('.dt-datetime-hours tbody tr:first-child td:last-child').text()).toBe('am');
+			expect($('.dt-datetime-hours tbody tr:last-child td:last-child').text()).toBe('pm');
+		});
+
+		dt.html('input');
+		it('Change', function () {
+			let el = new DateTime(document.getElementById('test'), {
+				format: 'HH:mm A',
+				i18n: {
+					amPm: ['before', 'after']
+				}
+			});
+
+			$('#test').click();
+
+			expect($('.dt-datetime-hours tbody tr:first-child td:last-child').text()).toBe('before');
+			expect($('.dt-datetime-hours tbody tr:last-child td:last-child').text()).toBe('after');
+		});
+	});
+});

package/test/options/dateTime.i18n.hours.js

@@ -0,0 +1,33 @@
+describe('dateTime - i18n - hours', function () {
+	dt.libs({
+		js: ['jquery', 'datatables', 'moment', 'datetime'],
+		css: ['datatables', 'datetime']
+	});
+
+	describe('Functional tests', function () {
+		dt.html('input');
+		it('Default', function () {
+			let el = new DateTime(document.getElementById('test'), {
+				format: 'HH:mm'
+			});
+
+			$('#test').click();
+
+			expect($('.dt-datetime-hours thead').text()).toBe('Hour');
+		});
+
+		dt.html('input');
+		it('Change', function () {
+			let el = new DateTime(document.getElementById('test'), {
+				format: 'HH:mm',
+				i18n: {
+					hours: 'test'
+				}
+			});
+
+			$('#test').click();
+
+			expect($('.dt-datetime-hours thead').text()).toBe('test');
+		});
+	});
+});