jQuery DATETIME Functions – Complete Listing
This is the only Date/Time jQuery functions you will ever need. It works better than any other date/time libraries out there and has minimal overhead, guaranteed speed and accuracy.
Includes functions to: get date, convert date, valid date, string to date, leap year, compare date, format date, timezone and heaps of others!!!
Key Takeaways
- jQuery DATETIME functions are incredibly versatile, offering a complete range of date and time manipulations, including getting the date, converting dates, validating dates, and comparing dates.
- The functions also include capabilities to convert date strings to date objects, determine if a departure and return date are valid, and detect if a year is a leap year.
- The JQUERY4U.DATETIME.js library also includes a comprehensive date formatting function, similar to PHP’s date function, allowing for custom date formats.
- The library is easy to implement, with a minimal overhead ensuring speed and accuracy, making it a preferred choice over other date/time libraries.
jQuery Date/Time Complete Listing
/*___ FILE: "JQUERY4U.datetime.js" ___*/
;(function($)
{
/**
* jQuery Date and time functions - Complete List
*/
var JQUERY4U = JQUERY4U || {};
JQUERY4U.DATETIME =
{
/**
* Name of this class (used for error handling and/or debugging purposes)
* @type String
*/
name: 'JQUERY4U.DATETIME',
init: function()
{
JQUERY4U.UTIL.handleErrors(this);
Date.prototype.JQUERY4UFormat = this.format;
},
/**
* Return today's date in dd/mm/yyyy format
* @returns {String} Date in dd/mm/yyyy format
*/
todaysDate: function()
{
return this.futureDateDays(0);
},
/**
* Return tomorrow's date in dd/mm/yyyy format
* @returns {String} Date in dd/mm/yyyy format
*/
tomorrowsDate: function()
{
return this.futureDateDays(1);
},
/**
* Return date 7 days from now in dd/mm/yyyy format
* @returns {String} Date in dd/mm/yyyy format
*/
weekFromToday: function()
{
return this.futureDateDays(7);
},
/**
* Return the first day of the next month
* @returns {String} Date in dd/mm/yyyy format
*/
firstDayNextMonth: function()
{
var today = new Date();
nextMonth = new Date(today.getFullYear(), today.getMonth() + 1, 1);
nextMonth.getDate() +'/'+ (nextMonth.getMonth() + 1) +'/'+ nextMonth.getFullYear();
return this.leadingZero(nextMonth.getDate()) +'/'+ this.leadingZero(nextMonth.getMonth() + 1) +'/'+ nextMonth.getFullYear();
},
/**
* Returns x number of dates date in the future in dd/mm/yyyy format
* @param {Integer} days Number of days into the future
* @returns {String} Date in dd/mm/yyyy format
*/
futureDateDays: function(days)
{
var futureDate = new Date();
futureDate.setDate(futureDate.getDate() + days);
return this.leadingZero(futureDate.getDate()) +'/'+ this.leadingZero(futureDate.getMonth() + 1) +'/'+ this.leadingZero(futureDate .getFullYear());
},
/**
* Return the current time in HHMM format
* @returns {String} Time in HHMM (e.g. 23:12) format
*/
timeHHMM: function()
{
var today = new Date();
return this.leadingZero(today.getHours()) + this.leadingZero(today.getMinutes());
},
/**
* Return the current time in HHMMSS format
* @returns {String} Time in HHMMSS (e.g. 23:12:33) format
*/
timeHHMMSS: function()
{
var today = new Date();
return this.leadingZero(today.getHours()) +':'+ this.leadingZero(today.getMinutes()) +':'+ this.leadingZero(today.getSeconds());
},
/**
* Takes a date string in Australian format and returns date string in US format
* @param {String} dateStr Date in dd/mm/yyyy format
* @param {String} [separator="-"] separator character in return date string
* @returns {String} date in mm/dd/yyyy format
*/
convertUSFormat: function(dateStr, separator)
{
var separator = (typeof(separator) == 'undefined') ? '-' : separator;
var re = new RegExp('([0-9]{2})/([0-9]{2})/([0-9]{4})', 'm');
var matches = re.exec(dateStr);
return matches[2] + separator + matches[1] + separator + matches[3];
},
/**
* Convert date in mm/dd/yyyy format and return in dd-mm-yyyy format (depending upon separator)
* @param {String} dateStr Date in mm/dd/yyyy format
* @param {String} [separator="-"] Separator character in return date string
* @returns {String} Date in mm-dd-yyyy format (presuming "-" is separator character)
*/
convertUStoAUSDate: function(dateStr, separator)
{
var separator = (typeof(separator) == 'undefined') ? '-' : separator;
var re = new RegExp('([0-9]{2})/([0-9]{2})/([0-9]{4})', 'm');
var matches = re.exec(dateStr);
return matches[2] + separator + matches[1] + separator + matches[3];
},
/**
* Return whether the supplied date components form the expected date
* @param {String} year
* @param {String} month
* @param {String} day
* @returns {Boolean} True if the date components match the date values in Date object
*/
isValidDate: function(year, month, day)
{
var dt = new Date(parseInt(year, 10), parseInt(month, 10)-1, parseInt(day, 10));
if(dt.getDate() != parseInt(day, 10) || dt.getMonth() != (parseInt(month, 10)-1) || dt.getFullYear() != parseInt(year, 10))
{
return false;
}
return true;
},
/**
* Takes a date object and returns in yyyymmdd format
* @param {Date Object} dateObj
* @returns {String} Date in yyyymmdd format
*/
dateToYYYYMMDD: function(dateObj)
{
return (dateObj.getFullYear() + this.leadingZero(dateObj.getMonth() + 1) + this.leadingZero(dateObj.getDate())).toString();
},
/**
* Takes a date object and returns in ddmmyyyy format
* @param {Date Object} dateObj
* @returns {String} Date in ddmmyyyy format
*/
dateToDDMMYYYY: function(dateObj)
{
return (this.leadingZero(dateObj.getDate()) + this.leadingZero(dateObj.getMonth() + 1) + dateObj.getFullYear()).toString();
},
/**
* Takes a date string in dd/mm/yyyy format
* @param {String} dateString Date in dd/mm/yyyy format
* @returns {Date Object} Returns false if date sring is invalid
*/
stringToDate: function(dateString)
{
try
{
var matches = dateString.match(/([0-9]{2})/([0-9]{2})/([0-9]{4})/);
if(this.isValidDate(matches[3], matches[2], matches[1]) === false)
{
return false;
}
return new Date(matches[3], parseInt(matches[2], 10)-1, parseInt(matches[1], 10));
}
catch(e)
{
return false;
}
},
/**
* Adds leading zero if passed value is single digit
* @param {String} val
* @returns {String}
*/
leadingZero: function(val)
{
var str = val.toString();
if(str.length == 1)
{
str = '0' + str;
}
return str;
},
/**
* Checks if return date is equal or after departure date
* @param {String} departureDate
* @param {String} returnDate
* @returns {Boolean}
*/
isDepartureReturnDateValid: function(departureDate, returnDate)
{
var dep = this.stringToDate(departureDate);
var ret = this.stringToDate(returnDate);
if(dep > ret)
{
return false;
}
return true;
},
/**
* Detect whether the year supplied is a leap year
* @param {Integer} year
* @returns {Boolean}
*/
isLeapYear: function(year)
{
year = parseInt(year, 10);
if(year % 4 == 0)
{
if(year % 100 != 0)
{
return true;
}
else
{
if(year % 400 == 0)
{
return true;
}
else
{
return false;
}
}
}
return false;
},
compareDates: function(from, to)
{
var dateResult = to.getTime() - from.getTime();
var dateObj = {};
dateObj.weeks = Math.round(dateResult/(1000 * 60 * 60 * 24 * 7));
dateObj.days = Math.ceil(dateResult/(1000 * 60 * 60 * 24));
dateObj.hours = Math.ceil(dateResult/(1000 * 60 * 60));
dateObj.minutes = Math.ceil(dateResult/(1000 * 60));
dateObj.seconds = Math.ceil(dateResult/(1000));
dateObj.milliseconds = dateResult;
return dateObj;
},
compareDatesDDMMYYYY: function(from, to)
{
from = from.split('/');
from = new Date(from[2], from[1], from[0]);
to = to.split('/');
to = new Date(to[2], to[1], to[0]);
return this.compareDates(from, to);
},
/**
* Allow nice formatting of dates like PHP's Date function
* Derived from code written by Jac Wright at http://jacwright.com/projects/javascript/date_format
* @param {Date} date JavaScript date object
* @param {String} format Date format string
* @returns {String}
*/
format: function()
{
var date,
format,
args = [].slice.call(arguments),
returnStr = '',
curChar = '',
months = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
days = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
methods =
{
// Day
d: function() { return (date.getDate() < 10 ? '0' : '') + date.getDate(); },
D: function() { return days[date.getDay()].substring(0, 3); },
j: function() { return date.getDate(); },
l: function() { return days[date.getDay()]; },
N: function() { return date.getDay() + 1; },
S: function() { return (date.getDate() % 10 == 1 && date.getDate() != 11 ? 'st' : (date.getDate() % 10 == 2 && date.getDate() != 12 ? 'nd' : (date.getDate() % 10 == 3 && date.getDate() != 13 ? 'rd' : 'th'))); },
w: function() { return date.getDay(); },
// Month
F: function() { return months[date.getMonth()]; },
m: function() { return (date.getMonth() < 9 ? '0' : '') + (date.getMonth() + 1); },
M: function() { return months[date.getMonth()].substring(0, 3); },
n: function() { return date.getMonth() + 1; },
Y: function() { return date.getFullYear(); },
y: function() { return ('' + date.getFullYear()).substr(2); },
// Time
a: function() { return date.getHours() < 12 ? 'am' : 'pm'; },
A: function() { return date.getHours() < 12 ? 'AM' : 'PM'; },
g: function() { return date.getHours() % 12 || 12; },
G: function() { return date.getHours(); },
h: function() { return ((date.getHours() % 12 || 12) < 10 ? '0' : '') + (date.getHours() % 12 || 12); },
H: function() { return (date.getHours() < 10 ? '0' : '') + date.getHours(); },
i: function() { return (date.getMinutes() < 10 ? '0' : '') + date.getMinutes(); },
s: function() { return (date.getSeconds() < 10 ? '0' : '') + date.getSeconds(); },
// Timezone
O: function() { return (-date.getTimezoneOffset() < 0 ? '-' : '+') + (Math.abs(date.getTimezoneOffset() / 60) < 10 ? '0' : '') + (Math.abs(date.getTimezoneOffset() / 60)) + '00'; },
P: function() { return (-date.getTimezoneOffset() < 0 ? '-' : '+') + (Math.abs(date.getTimezoneOffset() / 60) < 10 ? '0' : '') + (Math.abs(date.getTimezoneOffset() / 60)) + ':' + (Math.abs(date.getTimezoneOffset() % 60) < 10 ? '0' : '') + (Math.abs(date.getTimezoneOffset() % 60)); },
T: function() { var m = date.getMonth(); date.setMonth(0); var result = date.toTimeString().replace(/^.+ (?([^)]+))?$/, '$1'); date.setMonth(m); return result;},
Z: function() { return -date.getTimezoneOffset() * 60; },
// Full Date/Time
c: function() { return date.format("Y-m-d") + "T" + date.format("H:i:sP"); },
r: function() { return date.toString(); },
U: function() { return date.getTime() / 1000; }
};
if(typeof this.getMonth == 'function')
{
date = this;
format = args[0];
}
else
{
date = args[0];
format = args[1];
}
for(var i = 0; i < format.length; i++)
{
var curChar = format.charAt(i);
if(methods[curChar])
{
returnStr += methods[curChar].call();
}
else
{
returnStr += curChar;
}
}
return returnStr;
}
};
JQUERY4U.DATETIME.init();
})(jQuery);Frequently Asked Questions (FAQs) about JavaScript DateTime Functions
What is the difference between JavaScript Date() and new Date()?
In JavaScript, Date() and new Date() are used to work with dates and times. However, they function differently. When you use Date() as a function without the ‘new’ keyword, it returns the current date and time as a string. On the other hand, when you use new Date(), it returns a new Date object representing the current date and time.
How can I format a date in JavaScript?
JavaScript provides several methods to format a date. The most common method is to use the toDateString() function, which converts a date to a more readable format. You can also use methods like toLocaleDateString() or toISOString() to format the date according to the locale or in ISO standard format respectively.
How can I add or subtract days from a date in JavaScript?
To add or subtract days from a date in JavaScript, you can use the setDate() and getDate() methods. For example, to add 5 days to the current date, you would use the following code:var date = new Date();date.setDate(date.getDate() + 5);
To subtract days, you would do the same but with a negative number.
How can I compare two dates in JavaScript?
In JavaScript, you can compare two dates using the standard comparison operators (==, !=, <, >, <=, >=). However, it’s important to note that these operators compare the date objects, not the actual dates. To compare the dates themselves, you should convert them to a standard format, such as the number of milliseconds since the Unix Epoch (January 1, 1970), using the getTime() method.
How can I get the current time in JavaScript?
To get the current time in JavaScript, you can use the Date object’s methods. The simplest way is to create a new Date object without any arguments, which will represent the current date and time. Then, you can use methods like getHours(), getMinutes(), and getSeconds() to get the current time.
How can I convert a string to a date in JavaScript?
JavaScript’s Date object can parse strings into dates. You can pass the string to the Date constructor, and it will try to parse it. However, it’s important to note that the parsing depends on the format of the string, and it may not work as expected for all formats.
How can I get the day of the week in JavaScript?
JavaScript provides the getDay() method, which returns the day of the week as a number (0 for Sunday, 1 for Monday, and so on). To get the name of the day, you can create an array of names and use the number as an index.
How can I check if a year is a leap year in JavaScript?
To check if a year is a leap year in JavaScript, you can use a simple function that checks if the year is divisible by 4 but not by 100, unless it’s also divisible by 400. This is because leap years are every year that is evenly divisible by 4, except for years that are evenly divisible by 100. However, years that are evenly divisible by 400 are also leap years.
How can I get the difference between two dates in JavaScript?
To get the difference between two dates in JavaScript, you can subtract one date object from another. This will give you the difference in milliseconds. You can then convert this to days, hours, minutes, or seconds as needed.
How can I set a specific date and time in JavaScript?
To set a specific date and time in JavaScript, you can pass the year, month, day, hours, minutes, and seconds as arguments to the Date constructor. Note that the month is zero-based, so January is 0, February is 1, and so on.
Sam Deering has 15+ years of programming and website development experience. He was a website consultant at Console, ABC News, Flight Centre, Sapient Nitro, and the QLD Government and runs a tech blog with over 1 million views per month. Currently, Sam is the Founder of Crypto News, Australia.
