@tsdotnet/date-time 1.0.33 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/dist/CalendarDate.d.ts +1 -0
  2. package/dist/Calendars/Gregorian.d.ts +30 -37
  3. package/dist/ClockTime.d.ts +20 -20
  4. package/dist/ClockTimeValue.d.ts +1 -0
  5. package/dist/DateTime.d.ts +154 -154
  6. package/dist/DateTimeKind.d.ts +10 -15
  7. package/dist/JsDateConvertible.d.ts +1 -0
  8. package/dist/TimeMeasurement.d.ts +1 -0
  9. package/dist/TimeQuantity.d.ts +50 -50
  10. package/dist/TimeSpan.d.ts +73 -73
  11. package/dist/TimeStamp.d.ts +25 -25
  12. package/dist/TimeStampValue.d.ts +1 -0
  13. package/dist/TimeUnit.d.ts +47 -47
  14. package/dist/TimeUnitValue.d.ts +19 -19
  15. package/dist/cjs/Calendars/Gregorian.js +7 -0
  16. package/dist/cjs/Calendars/Gregorian.js.map +1 -0
  17. package/dist/{ClockTime.js → cjs/ClockTime.js} +69 -67
  18. package/dist/cjs/ClockTime.js.map +1 -0
  19. package/dist/{DateTime.js → cjs/DateTime.js} +306 -305
  20. package/dist/cjs/DateTime.js.map +1 -0
  21. package/dist/cjs/DateTimeKind.js +7 -0
  22. package/dist/cjs/DateTimeKind.js.map +1 -0
  23. package/dist/{TimeQuantity.js → cjs/TimeQuantity.js} +95 -95
  24. package/dist/cjs/TimeQuantity.js.map +1 -0
  25. package/dist/{TimeSpan.js → cjs/TimeSpan.js} +112 -111
  26. package/dist/cjs/TimeSpan.js.map +1 -0
  27. package/dist/{TimeStamp.js → cjs/TimeStamp.js} +46 -45
  28. package/dist/cjs/TimeStamp.js.map +1 -0
  29. package/dist/{TimeUnit.js → cjs/TimeUnit.js} +100 -99
  30. package/dist/cjs/TimeUnit.js.map +1 -0
  31. package/dist/{TimeUnitValue.js → cjs/TimeUnitValue.js} +46 -46
  32. package/dist/cjs/TimeUnitValue.js.map +1 -0
  33. package/dist/{date-time.js → cjs/date-time.js} +24 -28
  34. package/dist/cjs/date-time.js.map +1 -0
  35. package/dist/{howMany.js → cjs/howMany.js} +52 -52
  36. package/dist/cjs/howMany.js.map +1 -0
  37. package/dist/date-time.d.ts +21 -20
  38. package/dist/esm/Calendars/Gregorian.js +6 -0
  39. package/dist/esm/Calendars/Gregorian.js.map +1 -0
  40. package/{dist-esm → dist/esm}/ClockTime.js +70 -62
  41. package/dist/esm/ClockTime.js.map +1 -0
  42. package/{dist-esm → dist/esm}/DateTime.js +305 -301
  43. package/dist/esm/DateTime.js.map +1 -0
  44. package/dist/esm/DateTimeKind.js +6 -0
  45. package/dist/esm/DateTimeKind.js.map +1 -0
  46. package/{dist-esm → dist/esm}/TimeQuantity.js +93 -91
  47. package/dist/esm/TimeQuantity.js.map +1 -0
  48. package/{dist-esm → dist/esm}/TimeSpan.js +132 -106
  49. package/dist/esm/TimeSpan.js.map +1 -0
  50. package/{dist-esm → dist/esm}/TimeStamp.js +49 -40
  51. package/dist/esm/TimeStamp.js.map +1 -0
  52. package/{dist-esm → dist/esm}/TimeUnit.js +97 -96
  53. package/dist/esm/TimeUnit.js.map +1 -0
  54. package/{dist-esm → dist/esm}/TimeUnitValue.js +43 -42
  55. package/dist/esm/TimeUnitValue.js.map +1 -0
  56. package/{dist-esm → dist/esm}/date-time.js +13 -15
  57. package/dist/esm/date-time.js.map +1 -0
  58. package/{dist-esm → dist/esm}/howMany.js +49 -49
  59. package/dist/esm/howMany.js.map +1 -0
  60. package/dist/howMany.d.ts +39 -39
  61. package/dist/umd/Calendars/Gregorian.js +17 -0
  62. package/dist/umd/Calendars/Gregorian.js.map +1 -0
  63. package/dist/umd/ClockTime.js +86 -0
  64. package/dist/umd/ClockTime.js.map +1 -0
  65. package/dist/umd/DateTime.js +320 -0
  66. package/dist/umd/DateTime.js.map +1 -0
  67. package/dist/umd/DateTimeKind.js +17 -0
  68. package/dist/umd/DateTimeKind.js.map +1 -0
  69. package/dist/umd/TimeQuantity.js +108 -0
  70. package/dist/umd/TimeQuantity.js.map +1 -0
  71. package/dist/umd/TimeSpan.js +148 -0
  72. package/dist/umd/TimeSpan.js.map +1 -0
  73. package/dist/umd/TimeStamp.js +65 -0
  74. package/dist/umd/TimeStamp.js.map +1 -0
  75. package/dist/umd/TimeUnit.js +111 -0
  76. package/dist/umd/TimeUnit.js.map +1 -0
  77. package/dist/umd/TimeUnitValue.js +58 -0
  78. package/dist/umd/TimeUnitValue.js.map +1 -0
  79. package/dist/umd/date-time.js +35 -0
  80. package/dist/umd/date-time.js.map +1 -0
  81. package/dist/umd/howMany.js +63 -0
  82. package/dist/umd/howMany.js.map +1 -0
  83. package/eslint.config.mjs +25 -0
  84. package/package.json +97 -81
  85. package/dist/ClockTime.js.map +0 -1
  86. package/dist/DateTime.js.map +0 -1
  87. package/dist/TimeQuantity.js.map +0 -1
  88. package/dist/TimeSpan.js.map +0 -1
  89. package/dist/TimeStamp.js.map +0 -1
  90. package/dist/TimeUnit.js.map +0 -1
  91. package/dist/TimeUnitValue.js.map +0 -1
  92. package/dist/date-time.js.map +0 -1
  93. package/dist/howMany.js.map +0 -1
  94. package/dist-esm/ClockTime.js.map +0 -1
  95. package/dist-esm/DateTime.js.map +0 -1
  96. package/dist-esm/TimeQuantity.js.map +0 -1
  97. package/dist-esm/TimeSpan.js.map +0 -1
  98. package/dist-esm/TimeStamp.js.map +0 -1
  99. package/dist-esm/TimeUnit.js.map +0 -1
  100. package/dist-esm/TimeUnitValue.js.map +0 -1
  101. package/dist-esm/date-time.js.map +0 -1
  102. package/dist-esm/howMany.js.map +0 -1
@@ -1,96 +1,96 @@
1
- "use strict";
2
- /*!
3
- * @author electricessence / https://github.com/electricessence/
4
- * @license MIT
5
- */
6
- Object.defineProperty(exports, "__esModule", { value: true });
7
- const tslib_1 = require("tslib");
8
- const areEqual_1 = tslib_1.__importDefault(require("@tsdotnet/compare/dist/areEqual"));
9
- const compare_1 = tslib_1.__importDefault(require("@tsdotnet/compare/dist/compare"));
10
- const ArgumentNullException_1 = tslib_1.__importDefault(require("@tsdotnet/exceptions/dist/ArgumentNullException"));
11
- const ResettableLazy_1 = tslib_1.__importDefault(require("@tsdotnet/lazy/dist/ResettableLazy"));
12
- const TimeUnit_1 = tslib_1.__importDefault(require("./TimeUnit"));
13
- /**
14
- * This class provides a simple means for storing and calculating time quantities.
15
- */
16
- class TimeQuantity {
17
- constructor(_quantity = 0) {
18
- this._quantity = _quantity;
19
- this._total = ResettableLazy_1.default.create(() => {
20
- const ms = this.getTotalMilliseconds();
21
- return Object.freeze({
22
- ticks: ms * 10000 /* ticks.per.millisecond */,
23
- milliseconds: ms,
24
- seconds: ms / 1000 /* milliseconds.per.second */,
25
- minutes: ms / 60000 /* milliseconds.per.minute */,
26
- hours: ms / 3600000 /* milliseconds.per.hour */,
27
- days: ms / 86400000 /* milliseconds.per.day */
28
- });
29
- });
30
- }
31
- /**
32
- * Combine total values by time unit.
33
- * @param {Partial<TimeMeasurement>} values
34
- * @return {number}
35
- */
36
- static getTotalMillisecondsFrom(values) {
37
- if (!values)
38
- return 0;
39
- return (values.days || 0) * 86400000 /* milliseconds.per.day */ +
40
- (values.hours || 0) * 3600000 /* milliseconds.per.hour */ +
41
- (values.minutes || 0) * 60000 /* milliseconds.per.minute */ +
42
- (values.seconds || 0) * 1000 /* milliseconds.per.second */ +
43
- (values.milliseconds || 0) +
44
- (values.ticks || 0) / 10000 /* ticks.per.millisecond */;
45
- }
46
- /**
47
- * +1, 0, or -1 depending on the time direction.
48
- * @returns {number}
49
- */
50
- get direction() {
51
- return (0, compare_1.default)(this.getTotalMilliseconds(), 0);
52
- }
53
- /**
54
- * Returns an object with all units exposed as totals.
55
- * @returns {TimeMeasurement}
56
- */
57
- get total() {
58
- return this._total.value;
59
- }
60
- // Provides an overridable mechanism for extending this class.
61
- getTotalMilliseconds() {
62
- return this._quantity;
63
- }
64
- /**
65
- * Compares this instance against any other time quantity instance and return true if the amount of time is the same.
66
- * @param other
67
- * @returns {boolean}
68
- */
69
- equals(other) {
70
- if (!other || !other.total)
71
- return false;
72
- return (0, areEqual_1.default)(this.getTotalMilliseconds(), other.total.milliseconds);
73
- }
74
- /**
75
- * Compares this instance against any other time quantity instance.
76
- * @param other
77
- * @returns {number}
78
- */
79
- compareTo(other) {
80
- if (!other)
81
- throw new ArgumentNullException_1.default('other');
82
- if (!other.total)
83
- throw new ArgumentNullException_1.default('other.total');
84
- return (0, compare_1.default)(this.getTotalMilliseconds(), other && other.total && other.total.milliseconds);
85
- }
86
- /**
87
- * Returns the total amount of time measured in the requested TimeUnit.
88
- * @param units
89
- * @returns {number}
90
- */
91
- getTotal(units) {
92
- return TimeUnit_1.default.fromMilliseconds(this.getTotalMilliseconds(), units);
93
- }
94
- }
95
- exports.default = TimeQuantity;
1
+ "use strict";
2
+ /*!
3
+ * @author electricessence / https://github.com/electricessence/
4
+ * @license MIT
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ const tslib_1 = require("tslib");
8
+ const compare_1 = require("@tsdotnet/compare");
9
+ const exceptions_1 = require("@tsdotnet/exceptions");
10
+ const lazy_1 = require("@tsdotnet/lazy");
11
+ const howMany_1 = require("./howMany");
12
+ const TimeUnit_1 = tslib_1.__importDefault(require("./TimeUnit"));
13
+ /**
14
+ * This class provides a simple means for storing and calculating time quantities.
15
+ */
16
+ class TimeQuantity {
17
+ constructor(_quantity = 0) {
18
+ this._quantity = _quantity;
19
+ this._total = lazy_1.ResettableLazy.create(() => {
20
+ const ms = this.getTotalMilliseconds();
21
+ return Object.freeze({
22
+ ticks: ms * howMany_1.ticks.per.millisecond,
23
+ milliseconds: ms,
24
+ seconds: ms / howMany_1.milliseconds.per.second,
25
+ minutes: ms / howMany_1.milliseconds.per.minute,
26
+ hours: ms / howMany_1.milliseconds.per.hour,
27
+ days: ms / howMany_1.milliseconds.per.day
28
+ });
29
+ });
30
+ }
31
+ /**
32
+ * Combine total values by time unit.
33
+ * @param {Partial<TimeMeasurement>} values
34
+ * @return {number}
35
+ */
36
+ static getTotalMillisecondsFrom(values) {
37
+ if (!values)
38
+ return 0;
39
+ return (values.days || 0) * howMany_1.milliseconds.per.day +
40
+ (values.hours || 0) * howMany_1.milliseconds.per.hour +
41
+ (values.minutes || 0) * howMany_1.milliseconds.per.minute +
42
+ (values.seconds || 0) * howMany_1.milliseconds.per.second +
43
+ (values.milliseconds || 0) +
44
+ (values.ticks || 0) / howMany_1.ticks.per.millisecond;
45
+ }
46
+ /**
47
+ * +1, 0, or -1 depending on the time direction.
48
+ * @returns {number}
49
+ */
50
+ get direction() {
51
+ return (0, compare_1.compare)(this.getTotalMilliseconds(), 0);
52
+ }
53
+ /**
54
+ * Returns an object with all units exposed as totals.
55
+ * @returns {TimeMeasurement}
56
+ */
57
+ get total() {
58
+ return this._total.value;
59
+ }
60
+ // Provides an overridable mechanism for extending this class.
61
+ getTotalMilliseconds() {
62
+ return this._quantity;
63
+ }
64
+ /**
65
+ * Compares this instance against any other time quantity instance and return true if the amount of time is the same.
66
+ * @param other
67
+ * @returns {boolean}
68
+ */
69
+ equals(other) {
70
+ if (!other || !other.total)
71
+ return false;
72
+ return (0, compare_1.areEqual)(this.getTotalMilliseconds(), other.total.milliseconds);
73
+ }
74
+ /**
75
+ * Compares this instance against any other time quantity instance.
76
+ * @param other
77
+ * @returns {number}
78
+ */
79
+ compareTo(other) {
80
+ if (!other)
81
+ throw new exceptions_1.ArgumentNullException('other');
82
+ if (!other.total)
83
+ throw new exceptions_1.ArgumentNullException('other.total');
84
+ return (0, compare_1.compare)(this.getTotalMilliseconds(), other && other.total && other.total.milliseconds);
85
+ }
86
+ /**
87
+ * Returns the total amount of time measured in the requested TimeUnit.
88
+ * @param units
89
+ * @returns {number}
90
+ */
91
+ getTotal(units) {
92
+ return TimeUnit_1.default.fromMilliseconds(this.getTotalMilliseconds(), units);
93
+ }
94
+ }
95
+ exports.default = TimeQuantity;
96
96
  //# sourceMappingURL=TimeQuantity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TimeQuantity.js","sourceRoot":"","sources":["../../src/TimeQuantity.ts"],"names":[],"mappings":"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"}
@@ -1,112 +1,113 @@
1
- "use strict";
2
- /*!
3
- * @author electricessence / https://github.com/electricessence/
4
- * Originally based upon .NET source but with many additions and improvements.
5
- * @license MIT
6
- */
7
- Object.defineProperty(exports, "__esModule", { value: true });
8
- exports.TimeSpan = void 0;
9
- const tslib_1 = require("tslib");
10
- const lazy_1 = tslib_1.__importDefault(require("@tsdotnet/lazy"));
11
- const type_1 = tslib_1.__importDefault(require("@tsdotnet/type"));
12
- const ClockTime_1 = tslib_1.__importDefault(require("./ClockTime"));
13
- const TimeQuantity_1 = tslib_1.__importDefault(require("./TimeQuantity"));
14
- const TimeUnit_1 = tslib_1.__importDefault(require("./TimeUnit"));
15
- /**
16
- * TimeSpan expands on TimeQuantity to provide an class that is similar to .NET's TimeSpan including many useful static methods.
17
- */
18
- class TimeSpan extends TimeQuantity_1.default {
19
- // In .NET the default type is Ticks, but for JavaScript, we will use Milliseconds.
20
- constructor(value, units = TimeUnit_1.default.UnitType.Milliseconds) {
21
- if (isNaN(value))
22
- throw Error('Cannot construct a TimeSpan from NaN value.');
23
- const ms = TimeUnit_1.default.toMilliseconds(value, units);
24
- super(ms);
25
- this.ticks = ms * 10000 /* ticks.per.millisecond */;
26
- this.milliseconds = ms;
27
- this.seconds = ms / 1000 /* milliseconds.per.second */;
28
- this.minutes = ms / 60000 /* milliseconds.per.minute */;
29
- this.hours = ms / 3600000 /* milliseconds.per.hour */;
30
- this.days = ms / 86400000 /* milliseconds.per.day */;
31
- this._time = lazy_1.default.create(() => new ClockTime_1.default(this.getTotalMilliseconds()));
32
- Object.freeze(this);
33
- }
34
- static get zero() {
35
- return timeSpanZero || (timeSpanZero = new TimeSpan(0));
36
- }
37
- /**
38
- * Provides an standard interface for acquiring the total time.
39
- * @returns {TimeSpan}
40
- */
41
- get total() {
42
- return this;
43
- }
44
- // Instead of the confusing getTotal versus unit name, expose a 'ClockTime' value which reports the individual components.
45
- /**
46
- * The value of this TimeSpan reduced to the clock and calendar.
47
- * @return {ClockTime}
48
- */
49
- get time() {
50
- return this._time.value;
51
- }
52
- static from(value, units) {
53
- if (!value)
54
- return TimeSpan.zero;
55
- if (typeof value === 'number') {
56
- if (units === undefined)
57
- throw new Error('A numerical value requires a TimeUnit.');
58
- return new TimeSpan(value, units);
59
- }
60
- const ms = TimeQuantity_1.default.getTotalMillisecondsFrom(value);
61
- return ms ? new TimeSpan(ms) : TimeSpan.zero;
62
- }
63
- static fromDays(value) {
64
- return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Days) : TimeSpan.zero;
65
- }
66
- static fromHours(value) {
67
- return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Hours) : TimeSpan.zero;
68
- }
69
- static fromMinutes(value) {
70
- return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Minutes) : TimeSpan.zero;
71
- }
72
- static fromSeconds(value) {
73
- return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Seconds) : TimeSpan.zero;
74
- }
75
- static fromMilliseconds(value) {
76
- return value ? new TimeSpan(value) : TimeSpan.zero;
77
- }
78
- static fromTicks(value) {
79
- return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Ticks) : TimeSpan.zero;
80
- }
81
- /**
82
- * Sum the value of this TimeSpan with another time quantity.
83
- * @param {TimeQuantity | Partial<TimeMeasurement>} other
84
- * @return {TimeSpan}
85
- */
86
- add(other) {
87
- if (!other)
88
- return this;
89
- if (type_1.default.isNumber(other))
90
- throw new Error('Use .addUnit(value:number, units:TimeUnit) to add a numerical value amount. Default units are milliseconds.\n' +
91
- '.add only supports quantifiable time values (TimeQuantity).');
92
- const otherMs = other instanceof TimeQuantity_1.default
93
- ? other.total.milliseconds
94
- : TimeQuantity_1.default.getTotalMillisecondsFrom(other);
95
- return new TimeSpan(this.getTotalMilliseconds() + otherMs);
96
- }
97
- /**
98
- * Sum the value of this TimeSpan with another unit value.
99
- * @param {number} value
100
- * @param {TimeUnit.UnitType} units
101
- * @return {TimeSpan}
102
- */
103
- addUnit(value, units = TimeUnit_1.default.UnitType.Milliseconds) {
104
- return value
105
- ? new TimeSpan(this.getTotalMilliseconds() + TimeUnit_1.default.toMilliseconds(value, units))
106
- : this;
107
- }
108
- }
109
- exports.TimeSpan = TimeSpan;
110
- let timeSpanZero;
111
- exports.default = TimeSpan;
1
+ "use strict";
2
+ /*!
3
+ * @author electricessence / https://github.com/electricessence/
4
+ * Originally based upon .NET source but with many additions and improvements.
5
+ * @license MIT
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.TimeSpan = void 0;
9
+ const tslib_1 = require("tslib");
10
+ const lazy_1 = tslib_1.__importDefault(require("@tsdotnet/lazy"));
11
+ const type_1 = tslib_1.__importDefault(require("@tsdotnet/type"));
12
+ const ClockTime_1 = tslib_1.__importDefault(require("./ClockTime"));
13
+ const howMany_1 = require("./howMany");
14
+ const TimeQuantity_1 = tslib_1.__importDefault(require("./TimeQuantity"));
15
+ const TimeUnit_1 = tslib_1.__importDefault(require("./TimeUnit"));
16
+ /**
17
+ * TimeSpan expands on TimeQuantity to provide an class that is similar to .NET's TimeSpan including many useful static methods.
18
+ */
19
+ class TimeSpan extends TimeQuantity_1.default {
20
+ // In .NET the default type is Ticks, but for JavaScript, we will use Milliseconds.
21
+ constructor(value, units = TimeUnit_1.default.UnitType.Milliseconds) {
22
+ if (isNaN(value))
23
+ throw Error('Cannot construct a TimeSpan from NaN value.');
24
+ const ms = TimeUnit_1.default.toMilliseconds(value, units);
25
+ super(ms);
26
+ this.ticks = ms * howMany_1.ticks.per.millisecond;
27
+ this.milliseconds = ms;
28
+ this.seconds = ms / howMany_1.milliseconds.per.second;
29
+ this.minutes = ms / howMany_1.milliseconds.per.minute;
30
+ this.hours = ms / howMany_1.milliseconds.per.hour;
31
+ this.days = ms / howMany_1.milliseconds.per.day;
32
+ this._time = lazy_1.default.create(() => new ClockTime_1.default(this.getTotalMilliseconds()));
33
+ Object.freeze(this);
34
+ }
35
+ static get zero() {
36
+ return timeSpanZero || (timeSpanZero = new TimeSpan(0));
37
+ }
38
+ /**
39
+ * Provides an standard interface for acquiring the total time.
40
+ * @returns {TimeSpan}
41
+ */
42
+ get total() {
43
+ return this;
44
+ }
45
+ // Instead of the confusing getTotal versus unit name, expose a 'ClockTime' value which reports the individual components.
46
+ /**
47
+ * The value of this TimeSpan reduced to the clock and calendar.
48
+ * @return {ClockTime}
49
+ */
50
+ get time() {
51
+ return this._time.value;
52
+ }
53
+ static from(value, units) {
54
+ if (!value)
55
+ return TimeSpan.zero;
56
+ if (typeof value === 'number') {
57
+ if (units === undefined)
58
+ throw new Error('A numerical value requires a TimeUnit.');
59
+ return new TimeSpan(value, units);
60
+ }
61
+ const ms = TimeQuantity_1.default.getTotalMillisecondsFrom(value);
62
+ return ms ? new TimeSpan(ms) : TimeSpan.zero;
63
+ }
64
+ static fromDays(value) {
65
+ return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Days) : TimeSpan.zero;
66
+ }
67
+ static fromHours(value) {
68
+ return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Hours) : TimeSpan.zero;
69
+ }
70
+ static fromMinutes(value) {
71
+ return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Minutes) : TimeSpan.zero;
72
+ }
73
+ static fromSeconds(value) {
74
+ return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Seconds) : TimeSpan.zero;
75
+ }
76
+ static fromMilliseconds(value) {
77
+ return value ? new TimeSpan(value) : TimeSpan.zero;
78
+ }
79
+ static fromTicks(value) {
80
+ return value ? new TimeSpan(value, TimeUnit_1.default.UnitType.Ticks) : TimeSpan.zero;
81
+ }
82
+ /**
83
+ * Sum the value of this TimeSpan with another time quantity.
84
+ * @param {TimeQuantity | Partial<TimeMeasurement>} other
85
+ * @return {TimeSpan}
86
+ */
87
+ add(other) {
88
+ if (!other)
89
+ return this;
90
+ if (type_1.default.isNumber(other))
91
+ throw new Error('Use .addUnit(value:number, units:TimeUnit) to add a numerical value amount. Default units are milliseconds.\n' +
92
+ '.add only supports quantifiable time values (TimeQuantity).');
93
+ const otherMs = other instanceof TimeQuantity_1.default
94
+ ? other.total.milliseconds
95
+ : TimeQuantity_1.default.getTotalMillisecondsFrom(other);
96
+ return new TimeSpan(this.getTotalMilliseconds() + otherMs);
97
+ }
98
+ /**
99
+ * Sum the value of this TimeSpan with another unit value.
100
+ * @param {number} value
101
+ * @param {TimeUnit.UnitType} units
102
+ * @return {TimeSpan}
103
+ */
104
+ addUnit(value, units = TimeUnit_1.default.UnitType.Milliseconds) {
105
+ return value
106
+ ? new TimeSpan(this.getTotalMilliseconds() + TimeUnit_1.default.toMilliseconds(value, units))
107
+ : this;
108
+ }
109
+ }
110
+ exports.TimeSpan = TimeSpan;
111
+ let timeSpanZero;
112
+ exports.default = TimeSpan;
112
113
  //# sourceMappingURL=TimeSpan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TimeSpan.js","sourceRoot":"","sources":["../../src/TimeSpan.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,kEAAkC;AAClC,kEAAkC;AAClC,oEAAoC;AACpC,uCAA8C;AAE9C,0EAA0C;AAC1C,kEAAkC;AAElC;;GAEG;AACH,MAAa,QACZ,SAAQ,sBAAY;IAiCpB,mFAAmF;IACnF,YAAuB,KAAa,EAAE,QAA2B,kBAAQ,CAAC,QAAQ,CAAC,YAAY;QAE9F,IAAG,KAAK,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC5E,MAAM,EAAE,GAAG,kBAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjD,KAAK,CAAC,EAAE,CAAC,CAAC;QAEV,IAAI,CAAC,KAAK,GAAG,EAAE,GAAC,eAAK,CAAC,GAAG,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,EAAE,GAAC,sBAAY,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,EAAE,GAAC,sBAAY,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,EAAE,GAAC,sBAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,EAAE,GAAC,sBAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QAEpC,IAAI,CAAC,KAAK,GAAG,cAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAS,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;QAE3E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,KAAK,IAAI;QAEd,OAAO,YAAY,IAAI,CAAC,YAAY,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QAER,OAAO,IAAI,CAAC;IACb,CAAC;IAID,0HAA0H;IAE1H;;;OAGG;IACH,IAAI,IAAI;QAEP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IACzB,CAAC;IAMD,MAAM,CAAC,IAAI,CAAE,KAAwC,EAAE,KAAyB;QAE/E,IAAG,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;QAChC,IAAG,OAAO,KAAK,KAAG,QAAQ,EAC1B,CAAC;YACA,IAAG,KAAK,KAAG,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAChF,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,EAAE,GAAG,sBAAY,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,QAAQ,CAAE,KAAa;QAE7B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,kBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,SAAS,CAAE,KAAa;QAE9B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,kBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,WAAW,CAAE,KAAa;QAEhC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,kBAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,WAAW,CAAE,KAAa;QAEhC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,kBAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAE,KAAa;QAErC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,SAAS,CAAE,KAAa;QAE9B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,kBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAE,KAAyD;QAE7D,IAAG,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACvB,IAAG,cAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtB,MAAM,IAAI,KAAK,CACd,gHAAgH;gBAChH,6DAA6D,CAAC,CAAC;QAEjE,MAAM,OAAO,GAAG,KAAK,YAAY,sBAAY;YAC5C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY;YAC1B,CAAC,CAAC,sBAAY,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAEhD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAE,KAAa,EAAE,QAA2B,kBAAQ,CAAC,QAAQ,CAAC,YAAY;QAEhF,OAAO,KAAK;YACX,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,kBAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACnF,CAAC,CAAC,IAAI,CAAC;IACT,CAAC;CACD;AA9JD,4BA8JC;AAGD,IAAI,YAAsB,CAAC;AAE3B,kBAAe,QAAQ,CAAC"}
@@ -1,46 +1,47 @@
1
- "use strict";
2
- /*!
3
- * @author electricessence / https://github.com/electricessence/
4
- * @license MIT
5
- */
6
- Object.defineProperty(exports, "__esModule", { value: true });
7
- exports.TimeStamp = void 0;
8
- const tslib_1 = require("tslib");
9
- const type_1 = tslib_1.__importDefault(require("@tsdotnet/type"));
10
- /**
11
- * An alternative to Date or DateTime. Is a model representing the exact date and time.
12
- */
13
- class TimeStamp {
14
- constructor(year, month, day = 1, hour = 0, minute = 0, second = 0, millisecond = 0, tick = 0) {
15
- // Add validation or properly carry out of range values?
16
- this.year = year;
17
- this.month = month;
18
- this.day = day;
19
- this.hour = hour;
20
- this.minute = minute;
21
- this.second = second;
22
- this.millisecond = millisecond;
23
- this.tick = tick;
24
- Object.freeze(this);
25
- }
26
- static from(d) {
27
- if (!(d instanceof Date) && type_1.default.hasMember(d, 'toJsDate'))
28
- d = d.toJsDate();
29
- if (d instanceof Date) {
30
- return new TimeStamp(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds());
31
- }
32
- else {
33
- throw Error('Invalid date type.');
34
- }
35
- }
36
- static now() {
37
- return TimeStamp.from(new Date());
38
- }
39
- toJsDate() {
40
- const _ = this;
41
- return new Date(_.year, _.month, _.day, _.hour, _.minute, _.second, _.millisecond + _.tick / 10000 /* ticks.per.millisecond */);
42
- }
43
- }
44
- exports.TimeStamp = TimeStamp;
45
- exports.default = TimeStamp;
1
+ "use strict";
2
+ /*!
3
+ * @author electricessence / https://github.com/electricessence/
4
+ * @license MIT
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.TimeStamp = void 0;
8
+ const tslib_1 = require("tslib");
9
+ const type_1 = tslib_1.__importDefault(require("@tsdotnet/type"));
10
+ const howMany_1 = require("./howMany");
11
+ /**
12
+ * An alternative to Date or DateTime. Is a model representing the exact date and time.
13
+ */
14
+ class TimeStamp {
15
+ constructor(year, month, day = 1, hour = 0, minute = 0, second = 0, millisecond = 0, tick = 0) {
16
+ // Add validation or properly carry out of range values?
17
+ this.year = year;
18
+ this.month = month;
19
+ this.day = day;
20
+ this.hour = hour;
21
+ this.minute = minute;
22
+ this.second = second;
23
+ this.millisecond = millisecond;
24
+ this.tick = tick;
25
+ Object.freeze(this);
26
+ }
27
+ static from(d) {
28
+ if (!(d instanceof Date) && type_1.default.hasMember(d, 'toJsDate'))
29
+ d = d.toJsDate();
30
+ if (d instanceof Date) {
31
+ return new TimeStamp(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds());
32
+ }
33
+ else {
34
+ throw Error('Invalid date type.');
35
+ }
36
+ }
37
+ static now() {
38
+ return TimeStamp.from(new Date());
39
+ }
40
+ toJsDate() {
41
+ const _ = this;
42
+ return new Date(_.year, _.month, _.day, _.hour, _.minute, _.second, _.millisecond + _.tick / howMany_1.ticks.per.millisecond);
43
+ }
44
+ }
45
+ exports.TimeStamp = TimeStamp;
46
+ exports.default = TimeStamp;
46
47
  //# sourceMappingURL=TimeStamp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TimeStamp.js","sourceRoot":"","sources":["../../src/TimeStamp.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;AAEH,kEAAkC;AAElC,uCAAgC;AAIhC;;GAEG;AACH,MAAa,SAAS;IAIrB,YACiB,IAAY,EACZ,KAAsB,EACtB,MAAsB,CAAC,EACvB,OAAsB,CAAC,EACvB,SAAsB,CAAC,EACvB,SAAsB,CAAC,EACvB,cAAsB,CAAC,EACvB,OAAsB,CAAC;QAGvC,wDAAwD;QAVxC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAiB;QACtB,QAAG,GAAH,GAAG,CAAoB;QACvB,SAAI,GAAJ,IAAI,CAAmB;QACvB,WAAM,GAAN,MAAM,CAAiB;QACvB,WAAM,GAAN,MAAM,CAAiB;QACvB,gBAAW,GAAX,WAAW,CAAY;QACvB,SAAI,GAAJ,IAAI,CAAmB;QAKvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAE,CAA2B;QAEvC,IAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,cAAI,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC;YACvD,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClB,IAAG,CAAC,YAAY,IAAI,EACpB,CAAC;YACA,OAAO,IAAI,SAAS,CACnB,CAAC,CAAC,WAAW,EAAE,EACf,CAAC,CAAC,QAAQ,EAAE,EACZ,CAAC,CAAC,OAAO,EAAE,EACX,CAAC,CAAC,QAAQ,EAAE,EACZ,CAAC,CAAC,UAAU,EAAE,EACd,CAAC,CAAC,UAAU,EAAE,EACd,CAAC,CAAC,eAAe,EAAE,CACnB,CAAC;QACH,CAAC;aAED,CAAC;YACA,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED,MAAM,CAAC,GAAG;QAET,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ;QAEP,MAAM,CAAC,GAAG,IAAI,CAAC;QACf,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,GAAC,eAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnH,CAAC;CACD;AApDD,8BAoDC;AAED,kBAAe,SAAS,CAAC"}