date.js 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591
  1. /**
  2. * DevExtreme (core/utils/date.js)
  3. * Version: 19.1.16
  4. * Build date: Tue Oct 18 2022
  5. *
  6. * Copyright (c) 2012 - 2022 Developer Express Inc. ALL RIGHTS RESERVED
  7. * Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
  8. */
  9. "use strict";
  10. var typeUtils = require("./type");
  11. var adjust = require("./math").adjust;
  12. var each = require("./iterator").each;
  13. var camelize = require("./inflector").camelize;
  14. var isObject = typeUtils.isObject;
  15. var isString = typeUtils.isString;
  16. var isDate = typeUtils.isDate;
  17. var isDefined = typeUtils.isDefined;
  18. var dateUnitIntervals = ["millisecond", "second", "minute", "hour", "day", "week", "month", "quarter", "year"];
  19. var toMilliseconds = function toMilliseconds(value) {
  20. switch (value) {
  21. case "millisecond":
  22. return 1;
  23. case "second":
  24. return 1e3 * toMilliseconds("millisecond");
  25. case "minute":
  26. return 60 * toMilliseconds("second");
  27. case "hour":
  28. return 60 * toMilliseconds("minute");
  29. case "day":
  30. return 24 * toMilliseconds("hour");
  31. case "week":
  32. return 7 * toMilliseconds("day");
  33. case "month":
  34. return 30 * toMilliseconds("day");
  35. case "quarter":
  36. return 3 * toMilliseconds("month");
  37. case "year":
  38. return 365 * toMilliseconds("day");
  39. default:
  40. return 0
  41. }
  42. };
  43. var getDatesInterval = function(startDate, endDate, intervalUnit) {
  44. var delta = endDate.getTime() - startDate.getTime();
  45. var millisecondCount = toMilliseconds(intervalUnit) || 1;
  46. return Math.floor(delta / millisecondCount)
  47. };
  48. var getNextDateUnit = function(unit, withWeeks) {
  49. var interval = getDateUnitInterval(unit);
  50. switch (interval) {
  51. case "millisecond":
  52. return "second";
  53. case "second":
  54. return "minute";
  55. case "minute":
  56. return "hour";
  57. case "hour":
  58. return "day";
  59. case "day":
  60. return withWeeks ? "week" : "month";
  61. case "week":
  62. return "month";
  63. case "month":
  64. return "quarter";
  65. case "quarter":
  66. return "year";
  67. case "year":
  68. return "year";
  69. default:
  70. return 0
  71. }
  72. };
  73. var convertMillisecondsToDateUnits = function(value) {
  74. var dateUnitIntervals = ["millisecond", "second", "minute", "hour", "day", "month", "year"];
  75. var result = {};
  76. for (var i = dateUnitIntervals.length - 1; i >= 0; i--) {
  77. var dateUnitInterval = dateUnitIntervals[i];
  78. var dateUnitCount = Math.floor(value / toMilliseconds(dateUnitInterval));
  79. if (dateUnitCount > 0) {
  80. result[dateUnitInterval + "s"] = dateUnitCount;
  81. value -= convertDateUnitToMilliseconds(dateUnitInterval, dateUnitCount)
  82. }
  83. }
  84. return result
  85. };
  86. var dateToMilliseconds = function(tickInterval) {
  87. var milliseconds = 0;
  88. if (isObject(tickInterval)) {
  89. each(tickInterval, function(key, value) {
  90. milliseconds += convertDateUnitToMilliseconds(key.substr(0, key.length - 1), value)
  91. })
  92. }
  93. if (isString(tickInterval)) {
  94. milliseconds = convertDateUnitToMilliseconds(tickInterval, 1)
  95. }
  96. return milliseconds
  97. };
  98. var convertDateUnitToMilliseconds = function(dateUnit, count) {
  99. return toMilliseconds(dateUnit) * count
  100. };
  101. var getDateUnitInterval = function(tickInterval) {
  102. var maxInterval = -1;
  103. if (isString(tickInterval)) {
  104. return tickInterval
  105. }
  106. if (isObject(tickInterval)) {
  107. each(tickInterval, function(key, value) {
  108. for (var i = 0; i < dateUnitIntervals.length; i++) {
  109. if (value && (key === dateUnitIntervals[i] + "s" || key === dateUnitIntervals[i]) && maxInterval < i) {
  110. maxInterval = i
  111. }
  112. }
  113. });
  114. return dateUnitIntervals[maxInterval]
  115. }
  116. return ""
  117. };
  118. var tickIntervalToFormatMap = {
  119. millisecond: "millisecond",
  120. second: "longtime",
  121. minute: "shorttime",
  122. hour: "shorttime",
  123. day: "day",
  124. week: "day",
  125. month: "month",
  126. quarter: "quarter",
  127. year: "year"
  128. };
  129. function getDateFormatByTickInterval(tickInterval) {
  130. return tickIntervalToFormatMap[getDateUnitInterval(tickInterval)] || ""
  131. }
  132. var getQuarter = function(month) {
  133. return Math.floor(month / 3)
  134. };
  135. var getFirstQuarterMonth = function(month) {
  136. return 3 * getQuarter(month)
  137. };
  138. var correctDateWithUnitBeginning = function(date, dateInterval, withCorrection, firstDayOfWeek) {
  139. date = new Date(date.getTime());
  140. var oldDate = new Date(date.getTime());
  141. var dateUnitInterval = getDateUnitInterval(dateInterval);
  142. switch (dateUnitInterval) {
  143. case "second":
  144. date = new Date(1e3 * Math.floor(oldDate.getTime() / 1e3));
  145. break;
  146. case "minute":
  147. date = new Date(6e4 * Math.floor(oldDate.getTime() / 6e4));
  148. break;
  149. case "hour":
  150. date = new Date(36e5 * Math.floor(oldDate.getTime() / 36e5));
  151. break;
  152. case "year":
  153. date.setMonth(0);
  154. case "month":
  155. date.setDate(1);
  156. case "day":
  157. date.setHours(0, 0, 0, 0);
  158. break;
  159. case "week":
  160. date = getFirstWeekDate(date, firstDayOfWeek || 0);
  161. date.setHours(0, 0, 0, 0);
  162. break;
  163. case "quarter":
  164. var firstQuarterMonth = getFirstQuarterMonth(date.getMonth());
  165. var month = date.getMonth();
  166. date.setDate(1);
  167. date.setHours(0, 0, 0, 0);
  168. if (month !== firstQuarterMonth) {
  169. date.setMonth(firstQuarterMonth)
  170. }
  171. }
  172. if (withCorrection && "hour" !== dateUnitInterval && "minute" !== dateUnitInterval && "second" !== dateUnitInterval) {
  173. fixTimezoneGap(oldDate, date)
  174. }
  175. return date
  176. };
  177. var trimTime = function(date) {
  178. return dateUtils.correctDateWithUnitBeginning(date, "day")
  179. };
  180. var setToDayEnd = function(date) {
  181. var result = dateUtils.trimTime(date);
  182. result.setDate(result.getDate() + 1);
  183. return new Date(result.getTime() - 1)
  184. };
  185. var getDatesDifferences = function(date1, date2) {
  186. var counter = 0;
  187. var differences = {
  188. year: date1.getFullYear() !== date2.getFullYear(),
  189. month: date1.getMonth() !== date2.getMonth(),
  190. day: date1.getDate() !== date2.getDate(),
  191. hour: date1.getHours() !== date2.getHours(),
  192. minute: date1.getMinutes() !== date2.getMinutes(),
  193. second: date1.getSeconds() !== date2.getSeconds(),
  194. millisecond: date1.getMilliseconds() !== date2.getMilliseconds()
  195. };
  196. each(differences, function(key, value) {
  197. if (value) {
  198. counter++
  199. }
  200. });
  201. if (0 === counter && 0 !== getTimezonesDifference(date1, date2)) {
  202. differences.hour = true;
  203. counter++
  204. }
  205. differences.count = counter;
  206. return differences
  207. };
  208. function addDateInterval(value, interval, dir) {
  209. var result = new Date(value.getTime());
  210. var intervalObject = isString(interval) ? getDateIntervalByString(interval.toLowerCase()) : typeUtils.isNumeric(interval) ? convertMillisecondsToDateUnits(interval) : interval;
  211. if (intervalObject.years) {
  212. result.setFullYear(result.getFullYear() + intervalObject.years * dir)
  213. }
  214. if (intervalObject.quarters) {
  215. result.setMonth(result.getMonth() + 3 * intervalObject.quarters * dir)
  216. }
  217. if (intervalObject.months) {
  218. result.setMonth(result.getMonth() + intervalObject.months * dir)
  219. }
  220. if (intervalObject.weeks) {
  221. result.setDate(result.getDate() + 7 * intervalObject.weeks * dir)
  222. }
  223. if (intervalObject.days) {
  224. result.setDate(result.getDate() + intervalObject.days * dir)
  225. }
  226. if (intervalObject.hours) {
  227. result.setTime(result.getTime() + 36e5 * intervalObject.hours * dir)
  228. }
  229. if (intervalObject.minutes) {
  230. result.setTime(result.getTime() + 6e4 * intervalObject.minutes * dir)
  231. }
  232. if (intervalObject.seconds) {
  233. result.setTime(result.getTime() + 1e3 * intervalObject.seconds * dir)
  234. }
  235. if (intervalObject.milliseconds) {
  236. result.setTime(result.getTime() + intervalObject.milliseconds * dir)
  237. }
  238. return result
  239. }
  240. var addInterval = function(value, interval, isNegative) {
  241. var dir = isNegative ? -1 : 1;
  242. return isDate(value) ? addDateInterval(value, interval, dir) : adjust(value + interval * dir, interval)
  243. };
  244. var getSequenceByInterval = function(min, max, interval) {
  245. var intervals = [];
  246. var cur;
  247. intervals.push(isDate(min) ? new Date(min.getTime()) : min);
  248. cur = min;
  249. while (cur < max) {
  250. cur = addInterval(cur, interval);
  251. intervals.push(cur)
  252. }
  253. return intervals
  254. };
  255. var getViewFirstCellDate = function(viewType, date) {
  256. if ("month" === viewType) {
  257. return new Date(date.getFullYear(), date.getMonth(), 1)
  258. }
  259. if ("year" === viewType) {
  260. return new Date(date.getFullYear(), 0, date.getDate())
  261. }
  262. if ("decade" === viewType) {
  263. return new Date(getFirstYearInDecade(date), date.getMonth(), date.getDate())
  264. }
  265. if ("century" === viewType) {
  266. return new Date(getFirstDecadeInCentury(date), date.getMonth(), date.getDate())
  267. }
  268. };
  269. var getViewLastCellDate = function(viewType, date) {
  270. if ("month" === viewType) {
  271. return new Date(date.getFullYear(), date.getMonth(), getLastMonthDay(date))
  272. }
  273. if ("year" === viewType) {
  274. return new Date(date.getFullYear(), 11, date.getDate())
  275. }
  276. if ("decade" === viewType) {
  277. return new Date(getFirstYearInDecade(date) + 9, date.getMonth(), date.getDate())
  278. }
  279. if ("century" === viewType) {
  280. return new Date(getFirstDecadeInCentury(date) + 90, date.getMonth(), date.getDate())
  281. }
  282. };
  283. var getViewMinBoundaryDate = function(viewType, date) {
  284. var resultDate = new Date(date.getFullYear(), date.getMonth(), 1);
  285. if ("month" === viewType) {
  286. return resultDate
  287. }
  288. resultDate.setMonth(0);
  289. if ("year" === viewType) {
  290. return resultDate
  291. }
  292. if ("decade" === viewType) {
  293. resultDate.setFullYear(getFirstYearInDecade(date))
  294. }
  295. if ("century" === viewType) {
  296. resultDate.setFullYear(getFirstDecadeInCentury(date))
  297. }
  298. return resultDate
  299. };
  300. var getViewMaxBoundaryDate = function(viewType, date) {
  301. var resultDate = new Date(date);
  302. resultDate.setDate(getLastMonthDay(date));
  303. if ("month" === viewType) {
  304. return resultDate
  305. }
  306. resultDate.setMonth(11);
  307. resultDate.setDate(getLastMonthDay(resultDate));
  308. if ("year" === viewType) {
  309. return resultDate
  310. }
  311. if ("decade" === viewType) {
  312. resultDate.setFullYear(getFirstYearInDecade(date) + 9)
  313. }
  314. if ("century" === viewType) {
  315. resultDate.setFullYear(getFirstDecadeInCentury(date) + 99)
  316. }
  317. return resultDate
  318. };
  319. var getLastMonthDay = function(date) {
  320. var resultDate = new Date(date.getFullYear(), date.getMonth() + 1, 0);
  321. return resultDate.getDate()
  322. };
  323. var sameView = function(view, date1, date2) {
  324. return dateUtils[camelize("same " + view)](date1, date2)
  325. };
  326. var getViewUp = function(typeView) {
  327. switch (typeView) {
  328. case "month":
  329. return "year";
  330. case "year":
  331. return "decade";
  332. case "decade":
  333. return "century"
  334. }
  335. };
  336. var getViewDown = function(typeView) {
  337. switch (typeView) {
  338. case "century":
  339. return "decade";
  340. case "decade":
  341. return "year";
  342. case "year":
  343. return "month"
  344. }
  345. };
  346. var getDifferenceInMonth = function(typeView) {
  347. var difference = 1;
  348. if ("year" === typeView) {
  349. difference = 12
  350. }
  351. if ("decade" === typeView) {
  352. difference = 120
  353. }
  354. if ("century" === typeView) {
  355. difference = 1200
  356. }
  357. return difference
  358. };
  359. var getDifferenceInMonthForCells = function(typeView) {
  360. var difference = 1;
  361. if ("decade" === typeView) {
  362. difference = 12
  363. }
  364. if ("century" === typeView) {
  365. difference = 120
  366. }
  367. return difference
  368. };
  369. var getDateIntervalByString = function(intervalString) {
  370. var result = {};
  371. switch (intervalString) {
  372. case "year":
  373. result.years = 1;
  374. break;
  375. case "month":
  376. result.months = 1;
  377. break;
  378. case "quarter":
  379. result.months = 3;
  380. break;
  381. case "week":
  382. result.weeks = 1;
  383. break;
  384. case "day":
  385. result.days = 1;
  386. break;
  387. case "hour":
  388. result.hours = 1;
  389. break;
  390. case "minute":
  391. result.minutes = 1;
  392. break;
  393. case "second":
  394. result.seconds = 1;
  395. break;
  396. case "millisecond":
  397. result.milliseconds = 1
  398. }
  399. return result
  400. };
  401. var sameDate = function(date1, date2) {
  402. return sameMonthAndYear(date1, date2) && date1.getDate() === date2.getDate()
  403. };
  404. var sameMonthAndYear = function(date1, date2) {
  405. return sameYear(date1, date2) && date1.getMonth() === date2.getMonth()
  406. };
  407. var sameYear = function(date1, date2) {
  408. return date1 && date2 && date1.getFullYear() === date2.getFullYear()
  409. };
  410. var sameDecade = function(date1, date2) {
  411. if (!isDefined(date1) || !isDefined(date2)) {
  412. return
  413. }
  414. var startDecadeDate1 = date1.getFullYear() - date1.getFullYear() % 10;
  415. var startDecadeDate2 = date2.getFullYear() - date2.getFullYear() % 10;
  416. return date1 && date2 && startDecadeDate1 === startDecadeDate2
  417. };
  418. var sameCentury = function(date1, date2) {
  419. if (!isDefined(date1) || !isDefined(date2)) {
  420. return
  421. }
  422. var startCenturyDate1 = date1.getFullYear() - date1.getFullYear() % 100;
  423. var startCenturyDate2 = date2.getFullYear() - date2.getFullYear() % 100;
  424. return date1 && date2 && startCenturyDate1 === startCenturyDate2
  425. };
  426. var getFirstDecadeInCentury = function(date) {
  427. return date && date.getFullYear() - date.getFullYear() % 100
  428. };
  429. var getFirstYearInDecade = function(date) {
  430. return date && date.getFullYear() - date.getFullYear() % 10
  431. };
  432. var getShortDateFormat = function() {
  433. return "yyyy/MM/dd"
  434. };
  435. var getFirstMonthDate = function(date) {
  436. if (!isDefined(date)) {
  437. return
  438. }
  439. var newDate = new Date(date.getFullYear(), date.getMonth(), 1);
  440. return newDate
  441. };
  442. var getLastMonthDate = function(date) {
  443. if (!isDefined(date)) {
  444. return
  445. }
  446. var newDate = new Date(date.getFullYear(), date.getMonth() + 1, 0);
  447. return newDate
  448. };
  449. var getFirstWeekDate = function(date, firstDayOfWeek) {
  450. var delta = (date.getDay() - firstDayOfWeek + 7) % 7;
  451. var result = new Date(date);
  452. result.setDate(date.getDate() - delta);
  453. return result
  454. };
  455. var normalizeDateByWeek = function(date, currentDate) {
  456. var differenceInDays = dateUtils.getDatesInterval(date, currentDate, "day");
  457. var resultDate = new Date(date);
  458. if (differenceInDays >= 6) {
  459. resultDate = new Date(resultDate.setDate(resultDate.getDate() + 7))
  460. }
  461. return resultDate
  462. };
  463. var dateInRange = function(date, min, max, format) {
  464. if ("date" === format) {
  465. min = min && dateUtils.correctDateWithUnitBeginning(min, "day");
  466. max = max && dateUtils.correctDateWithUnitBeginning(max, "day");
  467. date = date && dateUtils.correctDateWithUnitBeginning(date, "day")
  468. }
  469. return normalizeDate(date, min, max) === date
  470. };
  471. var dateTimeFromDecimal = function(number) {
  472. var hours = Math.floor(number);
  473. var minutes = number % 1 * 60;
  474. return {
  475. hours: hours,
  476. minutes: minutes
  477. }
  478. };
  479. var roundDateByStartDayHour = function(date, startDayHour) {
  480. var startTime = this.dateTimeFromDecimal(startDayHour);
  481. var result = new Date(date);
  482. if (date.getHours() === startTime.hours && date.getMinutes() < startTime.minutes || date.getHours() < startTime.hours) {
  483. result.setHours(startTime.hours, startTime.minutes, 0, 0)
  484. }
  485. return result
  486. };
  487. var normalizeDate = function(date, min, max) {
  488. var normalizedDate = date;
  489. if (!isDefined(date)) {
  490. return date
  491. }
  492. if (isDefined(min) && date < min) {
  493. normalizedDate = min
  494. }
  495. if (isDefined(max) && date > max) {
  496. normalizedDate = max
  497. }
  498. return normalizedDate
  499. };
  500. var fixTimezoneGap = function(oldDate, newDate) {
  501. if (!isDefined(oldDate)) {
  502. return
  503. }
  504. var diff = newDate.getHours() - oldDate.getHours();
  505. if (0 === diff) {
  506. return
  507. }
  508. var sign = 1 === diff || diff === -23 ? -1 : 1;
  509. var trial = new Date(newDate.getTime() + 36e5 * sign);
  510. if (sign > 0 || trial.getDate() === newDate.getDate()) {
  511. newDate.setTime(trial.getTime())
  512. }
  513. };
  514. var roundToHour = function(date) {
  515. date.setHours(date.getHours() + 1);
  516. date.setMinutes(0);
  517. return date
  518. };
  519. var getTimezonesDifference = function(min, max) {
  520. return 60 * (max.getTimezoneOffset() - min.getTimezoneOffset()) * 1e3
  521. };
  522. var makeDate = function(date) {
  523. return new Date(date)
  524. };
  525. var getDatesOfInterval = function(startDate, endDate, step) {
  526. var result = [];
  527. var currentDate = new Date(startDate.getTime());
  528. if (startDate.getTime() === endDate.getTime()) {
  529. result.push(new Date(startDate.getTime()))
  530. }
  531. while (currentDate < endDate) {
  532. result.push(new Date(currentDate.getTime()));
  533. currentDate = this.addInterval(currentDate, step)
  534. }
  535. return result
  536. };
  537. var dateUtils = {
  538. dateUnitIntervals: dateUnitIntervals,
  539. convertMillisecondsToDateUnits: convertMillisecondsToDateUnits,
  540. dateToMilliseconds: dateToMilliseconds,
  541. getNextDateUnit: getNextDateUnit,
  542. convertDateUnitToMilliseconds: convertDateUnitToMilliseconds,
  543. getDateUnitInterval: getDateUnitInterval,
  544. getDateFormatByTickInterval: getDateFormatByTickInterval,
  545. getDatesDifferences: getDatesDifferences,
  546. correctDateWithUnitBeginning: correctDateWithUnitBeginning,
  547. trimTime: trimTime,
  548. setToDayEnd: setToDayEnd,
  549. roundDateByStartDayHour: roundDateByStartDayHour,
  550. dateTimeFromDecimal: dateTimeFromDecimal,
  551. addDateInterval: addDateInterval,
  552. addInterval: addInterval,
  553. getSequenceByInterval: getSequenceByInterval,
  554. getDateIntervalByString: getDateIntervalByString,
  555. sameDate: sameDate,
  556. sameMonthAndYear: sameMonthAndYear,
  557. sameMonth: sameMonthAndYear,
  558. sameYear: sameYear,
  559. sameDecade: sameDecade,
  560. sameCentury: sameCentury,
  561. sameView: sameView,
  562. getDifferenceInMonth: getDifferenceInMonth,
  563. getDifferenceInMonthForCells: getDifferenceInMonthForCells,
  564. getFirstYearInDecade: getFirstYearInDecade,
  565. getFirstDecadeInCentury: getFirstDecadeInCentury,
  566. getShortDateFormat: getShortDateFormat,
  567. getViewFirstCellDate: getViewFirstCellDate,
  568. getViewLastCellDate: getViewLastCellDate,
  569. getViewDown: getViewDown,
  570. getViewUp: getViewUp,
  571. getLastMonthDay: getLastMonthDay,
  572. getLastMonthDate: getLastMonthDate,
  573. getFirstMonthDate: getFirstMonthDate,
  574. getFirstWeekDate: getFirstWeekDate,
  575. normalizeDateByWeek: normalizeDateByWeek,
  576. getQuarter: getQuarter,
  577. getFirstQuarterMonth: getFirstQuarterMonth,
  578. dateInRange: dateInRange,
  579. roundToHour: roundToHour,
  580. normalizeDate: normalizeDate,
  581. getViewMinBoundaryDate: getViewMinBoundaryDate,
  582. getViewMaxBoundaryDate: getViewMaxBoundaryDate,
  583. fixTimezoneGap: fixTimezoneGap,
  584. getTimezonesDifference: getTimezonesDifference,
  585. makeDate: makeDate,
  586. getDatesInterval: getDatesInterval,
  587. getDatesOfInterval: getDatesOfInterval
  588. };
  589. module.exports = dateUtils;