date-extended
Advanced tools
Readme
[
]((https://travis-ci.org/doug-martin/date-extended)
date-extended is a Javascript library that can be used standalone or incorporated into extended
var date = require("date-extended");
Or
var myextended = require("extended")
.register(require("date-extended"));
npm install date-extended
Or download the source (minified)
getDaysInMonth
Returns the number of days in the month of a date
date.getDaysInMonth(new Date(2006, 1, 1)); //28
date.getDaysInMonth(new Date(2004, 1, 1)); //29
date.getDaysInMonth(new Date(2006, 2, 1)); //31
date.getDaysInMonth(new Date(2006, 3, 1)); //30
date(new Date(2006, 4, 1)).getDaysInMonth().value(); //31
date(new Date(2006, 5, 1)).getDaysInMonth().value(); //30
date(new Date(2006, 6, 1)).getDaysInMonth(); //31
isLeapYear
Determines if a date is a leap year
date.isLeapYear(new Date(1600, 0, 1)); //true
date.isLeapYear(new Date(2006, 0, 1)); //false
date.isLeapYear(new Date(2004, 0, 1)); //true
date(new Date(1900, 0, 1)).isLeapYear(); //false
date(new Date(2000, 0, 1)).isLeapYear(); //true
date(new Date(1800, 0, 1)).isLeapYear(); //false
isWeekend
Determines if a date is on a weekend
var thursday = new Date(2006, 8, 21);
date.isWeekend(thursday)); //false
var saturday = new Date(2006, 8, 23);
date(saturday).isWeekend(); //true
var sunday = new Date(2006, 8, 24);
date.isWeekend(sunday); //true
var monday = new Date(2006, 8, 25);
date(monday).isWeekend()); //false
getTimezoneName
Get the timezone of a date
compare
Compares two dates
var d1 = new Date();
d1.setHours(0);
date.compare(d1, d1); // 0
var d1 = new Date(), d2 = new Date();
d1.setHours(0);
d2.setFullYear(2005);
d2.setHours(12);
date.compare(d1, d2, "date"); // 1
date(d1).compare(d2, "datetime"); // 1
var d1 = new Date(), d2 = new Date();
d1.setHours(0);
d2.setFullYear(2005);
d2.setHours(12);
date(d2).compare(d1, "date"); // -1
date(d1).compare(d2, "time"); //-1
add
Adds a specified interval and amount to a date
var dtA = new Date(2005, 11, 27);
date.add(dtA, "year", 1); //new Date(2006, 11, 27);
date(dtA).add("years", 1).value(); //new Date(2006, 11, 27);
dtA = new Date(2000, 0, 1);
date.add(dtA, "quarter", 1); //new Date(2000, 3, 1);
date(dtA).add("quarters", 1).value(); //new Date(2000, 3, 1);
dtA = new Date(2000, 0, 1);
date.add(dtA, "month", 1); //new Date(2000, 1, 1);
date(dtA).add("months", 1).value(); //new Date(2000, 1, 1);
dtA = new Date(2000, 0, 31);
date.add(dtA, "month", 1); //new Date(2000, 1, 29);
date(dtA).add("months", 1).value(); //new Date(2000, 1, 29);
dtA = new Date(2000, 0, 1);
date.add(dtA, "week", 1); //new Date(2000, 0, 8);
date(dtA).add("weeks", 1).value(); //new Date(2000, 0, 8);
dtA = new Date(2000, 0, 1);
date(dtA).add("day", 1).value(); //new Date(2000, 0, 2);
dtA = new Date(2000, 0, 1);
date(dtA).add("weekday", 1); //new Date(2000, 0, 3);
dtA = new Date(2000, 0, 1, 11);
date(dtA).add("hour", 1).value(); //new Date(2000, 0, 1, 12);
dtA = new Date(2000, 11, 31, 23, 59);
date.add(dtA, "minute", 1); //new Date(2001, 0, 1, 0, 0);
dtA = new Date(2000, 11, 31, 23, 59, 59);
date.add(dtA, "second", 1); //new Date(2001, 0, 1, 0, 0, 0);
dtA = new Date(2000, 11, 31, 23, 59, 59, 999);
date.add(dtA, "millisecond", 1); //new Date(2001, 0, 1, 0, 0, 0, 0);
difference
Finds the difference between two dates based on the specified interval
var dtA, dtB;
dtA = new Date(2005, 11, 27);
dtB = new Date(2006, 11, 27);
date.difference(dtA, dtB, "year"); //1
dtA = new Date(2000, 1, 29);
dtB = new Date(2001, 2, 1);
date.difference(dtA, dtB, "quarter"); //4
date(dtA).difference(dtB, "month").value(); //13
dtA = new Date(2000, 1, 1);
dtB = new Date(2000, 1, 8);
date.difference(dtA, dtB, "week"); //1
dtA = new Date(2000, 1, 29);
dtB = new Date(2000, 2, 1);
date(dtA).difference(dtB, "day").value(); //1
dtA = new Date(2006, 7, 3);
dtB = new Date(2006, 7, 11);
date.difference(dtA, dtB, "weekday"); //6
dtA = new Date(2000, 11, 31, 23);
dtB = new Date(2001, 0, 1, 0);
date(dtA).difference(dtB, "hour").value(); //1
dtA = new Date(2000, 11, 31, 23, 59);
dtB = new Date(2001, 0, 1, 0, 0);
date.difference(dtA, dtB, "minute"); //1
dtA = new Date(2000, 11, 31, 23, 59, 59);
dtB = new Date(2001, 0, 1, 0, 0, 0);
date(dtA).difference(dtB, "second").value(); //1
dtA = new Date(2000, 11, 31, 23, 59, 59, 999);
dtB = new Date(2001, 0, 1, 0, 0, 0, 0);
date.difference(dtA, dtB, "millisecond"); //1
format
Formats a date to the specified format string
G Era designator Text ADy Year Year 1996; 96M Month in year Month July; Jul; 07w Week in year Number 27W Week in month Number 2D Day in year Number 189d Day in month Number 10E Day in week Text Tuesday; Tuea Am/pm marker Text PMH Hour in day (0-23) Number 0k Hour in day (1-24) Number 24K Hour in am/pm (0-11) Number 0h Hour in am/pm (1-12) Number 12m Minute in hour Number 30s Second in minute Number 55S Millisecond Number 978z Time zone General time zone Pacific Standard Time; PST; GMT-08:00Z Time zone RFC 822 time zone -0800var date = new Date(2006, 7, 11, 0, 55, 12, 345);
date.format(date, "EEEE, MMMM dd, yyyy"); //"Friday, August 11, 2006"
date(date).format("M/dd/yy").value(); //"8/11/06"
date.format(date, "E"); //"6"
date(date).format("h:m a").value(); //"12:55 AM"
date.format(date, 'h:m:s'); //"12:55:12"
date(date).format('h:m:s.SS').value(); //"12:55:12.35"
date.format(date, 'k:m:s.SS'); //"24:55:12.35"
date(date).format('H:m:s.SS').value(); //"0:55:12.35"
date.format(date, "ddMMyyyy"); //"11082006"
parseDate
Parses a date string into a date object
G Era designator Text ADy Year Year 1996; 96M Month in year Month July; Jul; 07w Week in year Number 27W Week in month Number 2D Day in year Number 189d Day in month Number 10E Day in week Text Tuesday; Tuea Am/pm marker Text PMH Hour in day (0-23) Number 0k Hour in day (1-24) Number 24K Hour in am/pm (0-11) Number 0h Hour in am/pm (1-12) Number 12m Minute in hour Number 30s Second in minute Number 55S Millisecond Number 978z Time zone General time zone Pacific Standard Time; PST; GMT-08:00Z Time zone RFC 822 time zone -0800 var aug_11_2006 = new Date(2006, 7, 11, 0);
date.parse("08/11/06", "MM/dd/yy"); //aug_11_2006
date.parse("11Aug2006", 'ddMMMyyyy'); //aug_11_2006
date.parse("Aug2006", 'MMMyyyy'); //new Date(2006, 7, 1)
date.parse("Aug 11, 2006", "MMM dd, yyyy"); //aug_11_2006
date.parse("August 11, 2006", "MMMM dd, yyyy"); //aug_11_2006
date.parse("Friday, August 11, 2006", "EEEE, MMMM dd, yyyy"); //aug_11_2006
FromNow and Ago
The following are convenience methods for adding ad subtracting intervals from the current date.
yearsFromNowyearsAgomonthsFromNowmonthsAgodaysFromNowdaysAgohoursFromNowhoursAgominutesFromNowminutesAgosecondsFromNowsecondsAgo//two years ago
date(2).yearsAgo();
date.yearsAgo(2)
//five hours from now
date(5).hoursFromNow();
date.hoursFromNow(5);
//two seconds ago
date(2).secondsAgo();
date.secondsAgo(2)
FAQs
Additional date extensions with a chainable api
The npm package date-extended receives a total of 76,068 weekly downloads. As such, date-extended popularity was classified as popular.
We found that date-extended demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.