@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,92 +1,94 @@
1
- /*!
2
- * @author electricessence / https://github.com/electricessence/
3
- * @license MIT
4
- */
5
- import areEqual from '@tsdotnet/compare/dist/areEqual';
6
- import compare from '@tsdotnet/compare/dist/compare';
7
- import ArgumentNullException from '@tsdotnet/exceptions/dist/ArgumentNullException';
8
- import ResettableLazy from '@tsdotnet/lazy/dist/ResettableLazy';
9
- import TimeUnit from './TimeUnit';
10
- /**
11
- * This class provides a simple means for storing and calculating time quantities.
12
- */
13
- export default class TimeQuantity {
14
- constructor(_quantity = 0) {
15
- this._quantity = _quantity;
16
- this._total = ResettableLazy.create(() => {
17
- const ms = this.getTotalMilliseconds();
18
- return Object.freeze({
19
- ticks: ms * 10000 /* ticks.per.millisecond */,
20
- milliseconds: ms,
21
- seconds: ms / 1000 /* milliseconds.per.second */,
22
- minutes: ms / 60000 /* milliseconds.per.minute */,
23
- hours: ms / 3600000 /* milliseconds.per.hour */,
24
- days: ms / 86400000 /* milliseconds.per.day */
25
- });
26
- });
27
- }
28
- /**
29
- * Combine total values by time unit.
30
- * @param {Partial<TimeMeasurement>} values
31
- * @return {number}
32
- */
33
- static getTotalMillisecondsFrom(values) {
34
- if (!values)
35
- return 0;
36
- return (values.days || 0) * 86400000 /* milliseconds.per.day */ +
37
- (values.hours || 0) * 3600000 /* milliseconds.per.hour */ +
38
- (values.minutes || 0) * 60000 /* milliseconds.per.minute */ +
39
- (values.seconds || 0) * 1000 /* milliseconds.per.second */ +
40
- (values.milliseconds || 0) +
41
- (values.ticks || 0) / 10000 /* ticks.per.millisecond */;
42
- }
43
- /**
44
- * +1, 0, or -1 depending on the time direction.
45
- * @returns {number}
46
- */
47
- get direction() {
48
- return compare(this.getTotalMilliseconds(), 0);
49
- }
50
- /**
51
- * Returns an object with all units exposed as totals.
52
- * @returns {TimeMeasurement}
53
- */
54
- get total() {
55
- return this._total.value;
56
- }
57
- // Provides an overridable mechanism for extending this class.
58
- getTotalMilliseconds() {
59
- return this._quantity;
60
- }
61
- /**
62
- * Compares this instance against any other time quantity instance and return true if the amount of time is the same.
63
- * @param other
64
- * @returns {boolean}
65
- */
66
- equals(other) {
67
- if (!other || !other.total)
68
- return false;
69
- return areEqual(this.getTotalMilliseconds(), other.total.milliseconds);
70
- }
71
- /**
72
- * Compares this instance against any other time quantity instance.
73
- * @param other
74
- * @returns {number}
75
- */
76
- compareTo(other) {
77
- if (!other)
78
- throw new ArgumentNullException('other');
79
- if (!other.total)
80
- throw new ArgumentNullException('other.total');
81
- return compare(this.getTotalMilliseconds(), other && other.total && other.total.milliseconds);
82
- }
83
- /**
84
- * Returns the total amount of time measured in the requested TimeUnit.
85
- * @param units
86
- * @returns {number}
87
- */
88
- getTotal(units) {
89
- return TimeUnit.fromMilliseconds(this.getTotalMilliseconds(), units);
90
- }
91
- }
1
+ /*!
2
+ * @author electricessence / https://github.com/electricessence/
3
+ * @license MIT
4
+ */
5
+ import { areEqual, compare } from '@tsdotnet/compare';
6
+ import { ArgumentNullException } from '@tsdotnet/exceptions';
7
+ import { ResettableLazy } from '@tsdotnet/lazy';
8
+ import { milliseconds, ticks } from './howMany';
9
+ import TimeUnit from './TimeUnit';
10
+ /**
11
+ * This class provides a simple means for storing and calculating time quantities.
12
+ */
13
+ export default class TimeQuantity {
14
+ _quantity;
15
+ constructor(_quantity = 0) {
16
+ this._quantity = _quantity;
17
+ this._total = ResettableLazy.create(() => {
18
+ const ms = this.getTotalMilliseconds();
19
+ return Object.freeze({
20
+ ticks: ms * ticks.per.millisecond,
21
+ milliseconds: ms,
22
+ seconds: ms / milliseconds.per.second,
23
+ minutes: ms / milliseconds.per.minute,
24
+ hours: ms / milliseconds.per.hour,
25
+ days: ms / milliseconds.per.day
26
+ });
27
+ });
28
+ }
29
+ /**
30
+ * Combine total values by time unit.
31
+ * @param {Partial<TimeMeasurement>} values
32
+ * @return {number}
33
+ */
34
+ static getTotalMillisecondsFrom(values) {
35
+ if (!values)
36
+ return 0;
37
+ return (values.days || 0) * milliseconds.per.day +
38
+ (values.hours || 0) * milliseconds.per.hour +
39
+ (values.minutes || 0) * milliseconds.per.minute +
40
+ (values.seconds || 0) * milliseconds.per.second +
41
+ (values.milliseconds || 0) +
42
+ (values.ticks || 0) / ticks.per.millisecond;
43
+ }
44
+ /**
45
+ * +1, 0, or -1 depending on the time direction.
46
+ * @returns {number}
47
+ */
48
+ get direction() {
49
+ return compare(this.getTotalMilliseconds(), 0);
50
+ }
51
+ _total;
52
+ /**
53
+ * Returns an object with all units exposed as totals.
54
+ * @returns {TimeMeasurement}
55
+ */
56
+ get total() {
57
+ return this._total.value;
58
+ }
59
+ // Provides an overridable mechanism for extending this class.
60
+ getTotalMilliseconds() {
61
+ return this._quantity;
62
+ }
63
+ /**
64
+ * Compares this instance against any other time quantity instance and return true if the amount of time is the same.
65
+ * @param other
66
+ * @returns {boolean}
67
+ */
68
+ equals(other) {
69
+ if (!other || !other.total)
70
+ return false;
71
+ return areEqual(this.getTotalMilliseconds(), other.total.milliseconds);
72
+ }
73
+ /**
74
+ * Compares this instance against any other time quantity instance.
75
+ * @param other
76
+ * @returns {number}
77
+ */
78
+ compareTo(other) {
79
+ if (!other)
80
+ throw new ArgumentNullException('other');
81
+ if (!other.total)
82
+ throw new ArgumentNullException('other.total');
83
+ return compare(this.getTotalMilliseconds(), other && other.total && other.total.milliseconds);
84
+ }
85
+ /**
86
+ * Returns the total amount of time measured in the requested TimeUnit.
87
+ * @param units
88
+ * @returns {number}
89
+ */
90
+ getTotal(units) {
91
+ return TimeUnit.fromMilliseconds(this.getTotalMilliseconds(), units);
92
+ }
93
+ }
92
94
  //# 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,107 +1,133 @@
1
- /*!
2
- * @author electricessence / https://github.com/electricessence/
3
- * Originally based upon .NET source but with many additions and improvements.
4
- * @license MIT
5
- */
6
- import Lazy from '@tsdotnet/lazy';
7
- import type from '@tsdotnet/type';
8
- import ClockTime from './ClockTime';
9
- import TimeQuantity from './TimeQuantity';
10
- import TimeUnit from './TimeUnit';
11
- /**
12
- * TimeSpan expands on TimeQuantity to provide an class that is similar to .NET's TimeSpan including many useful static methods.
13
- */
14
- export class TimeSpan extends TimeQuantity {
15
- // In .NET the default type is Ticks, but for JavaScript, we will use Milliseconds.
16
- constructor(value, units = TimeUnit.UnitType.Milliseconds) {
17
- if (isNaN(value))
18
- throw Error('Cannot construct a TimeSpan from NaN value.');
19
- const ms = TimeUnit.toMilliseconds(value, units);
20
- super(ms);
21
- this.ticks = ms * 10000 /* ticks.per.millisecond */;
22
- this.milliseconds = ms;
23
- this.seconds = ms / 1000 /* milliseconds.per.second */;
24
- this.minutes = ms / 60000 /* milliseconds.per.minute */;
25
- this.hours = ms / 3600000 /* milliseconds.per.hour */;
26
- this.days = ms / 86400000 /* milliseconds.per.day */;
27
- this._time = Lazy.create(() => new ClockTime(this.getTotalMilliseconds()));
28
- Object.freeze(this);
29
- }
30
- static get zero() {
31
- return timeSpanZero || (timeSpanZero = new TimeSpan(0));
32
- }
33
- /**
34
- * Provides an standard interface for acquiring the total time.
35
- * @returns {TimeSpan}
36
- */
37
- get total() {
38
- return this;
39
- }
40
- // Instead of the confusing getTotal versus unit name, expose a 'ClockTime' value which reports the individual components.
41
- /**
42
- * The value of this TimeSpan reduced to the clock and calendar.
43
- * @return {ClockTime}
44
- */
45
- get time() {
46
- return this._time.value;
47
- }
48
- static from(value, units) {
49
- if (!value)
50
- return TimeSpan.zero;
51
- if (typeof value === 'number') {
52
- if (units === undefined)
53
- throw new Error('A numerical value requires a TimeUnit.');
54
- return new TimeSpan(value, units);
55
- }
56
- const ms = TimeQuantity.getTotalMillisecondsFrom(value);
57
- return ms ? new TimeSpan(ms) : TimeSpan.zero;
58
- }
59
- static fromDays(value) {
60
- return value ? new TimeSpan(value, TimeUnit.UnitType.Days) : TimeSpan.zero;
61
- }
62
- static fromHours(value) {
63
- return value ? new TimeSpan(value, TimeUnit.UnitType.Hours) : TimeSpan.zero;
64
- }
65
- static fromMinutes(value) {
66
- return value ? new TimeSpan(value, TimeUnit.UnitType.Minutes) : TimeSpan.zero;
67
- }
68
- static fromSeconds(value) {
69
- return value ? new TimeSpan(value, TimeUnit.UnitType.Seconds) : TimeSpan.zero;
70
- }
71
- static fromMilliseconds(value) {
72
- return value ? new TimeSpan(value) : TimeSpan.zero;
73
- }
74
- static fromTicks(value) {
75
- return value ? new TimeSpan(value, TimeUnit.UnitType.Ticks) : TimeSpan.zero;
76
- }
77
- /**
78
- * Sum the value of this TimeSpan with another time quantity.
79
- * @param {TimeQuantity | Partial<TimeMeasurement>} other
80
- * @return {TimeSpan}
81
- */
82
- add(other) {
83
- if (!other)
84
- return this;
85
- if (type.isNumber(other))
86
- throw new Error('Use .addUnit(value:number, units:TimeUnit) to add a numerical value amount. Default units are milliseconds.\n' +
87
- '.add only supports quantifiable time values (TimeQuantity).');
88
- const otherMs = other instanceof TimeQuantity
89
- ? other.total.milliseconds
90
- : TimeQuantity.getTotalMillisecondsFrom(other);
91
- return new TimeSpan(this.getTotalMilliseconds() + otherMs);
92
- }
93
- /**
94
- * Sum the value of this TimeSpan with another unit value.
95
- * @param {number} value
96
- * @param {TimeUnit.UnitType} units
97
- * @return {TimeSpan}
98
- */
99
- addUnit(value, units = TimeUnit.UnitType.Milliseconds) {
100
- return value
101
- ? new TimeSpan(this.getTotalMilliseconds() + TimeUnit.toMilliseconds(value, units))
102
- : this;
103
- }
104
- }
105
- let timeSpanZero;
106
- export default TimeSpan;
1
+ /*!
2
+ * @author electricessence / https://github.com/electricessence/
3
+ * Originally based upon .NET source but with many additions and improvements.
4
+ * @license MIT
5
+ */
6
+ import Lazy from '@tsdotnet/lazy';
7
+ import type from '@tsdotnet/type';
8
+ import ClockTime from './ClockTime';
9
+ import { milliseconds, ticks } from './howMany';
10
+ import TimeQuantity from './TimeQuantity';
11
+ import TimeUnit from './TimeUnit';
12
+ /**
13
+ * TimeSpan expands on TimeQuantity to provide an class that is similar to .NET's TimeSpan including many useful static methods.
14
+ */
15
+ export class TimeSpan extends TimeQuantity {
16
+ /**
17
+ * The total number of ticks that represent this amount of time.
18
+ */
19
+ ticks;
20
+ /**
21
+ * The total number of ticks that milliseconds this amount of time.
22
+ */
23
+ milliseconds;
24
+ /**
25
+ * The total number of ticks that seconds this amount of time.
26
+ */
27
+ seconds;
28
+ /**
29
+ * The total number of ticks that minutes this amount of time.
30
+ */
31
+ minutes;
32
+ /**
33
+ * The total number of ticks that hours this amount of time.
34
+ */
35
+ hours;
36
+ /**
37
+ * The total number of ticks that days this amount of time.
38
+ */
39
+ days;
40
+ // In .NET the default type is Ticks, but for JavaScript, we will use Milliseconds.
41
+ constructor(value, units = TimeUnit.UnitType.Milliseconds) {
42
+ if (isNaN(value))
43
+ throw Error('Cannot construct a TimeSpan from NaN value.');
44
+ const ms = TimeUnit.toMilliseconds(value, units);
45
+ super(ms);
46
+ this.ticks = ms * ticks.per.millisecond;
47
+ this.milliseconds = ms;
48
+ this.seconds = ms / milliseconds.per.second;
49
+ this.minutes = ms / milliseconds.per.minute;
50
+ this.hours = ms / milliseconds.per.hour;
51
+ this.days = ms / milliseconds.per.day;
52
+ this._time = Lazy.create(() => new ClockTime(this.getTotalMilliseconds()));
53
+ Object.freeze(this);
54
+ }
55
+ static get zero() {
56
+ return timeSpanZero || (timeSpanZero = new TimeSpan(0));
57
+ }
58
+ /**
59
+ * Provides an standard interface for acquiring the total time.
60
+ * @returns {TimeSpan}
61
+ */
62
+ get total() {
63
+ return this;
64
+ }
65
+ _time;
66
+ // Instead of the confusing getTotal versus unit name, expose a 'ClockTime' value which reports the individual components.
67
+ /**
68
+ * The value of this TimeSpan reduced to the clock and calendar.
69
+ * @return {ClockTime}
70
+ */
71
+ get time() {
72
+ return this._time.value;
73
+ }
74
+ static from(value, units) {
75
+ if (!value)
76
+ return TimeSpan.zero;
77
+ if (typeof value === 'number') {
78
+ if (units === undefined)
79
+ throw new Error('A numerical value requires a TimeUnit.');
80
+ return new TimeSpan(value, units);
81
+ }
82
+ const ms = TimeQuantity.getTotalMillisecondsFrom(value);
83
+ return ms ? new TimeSpan(ms) : TimeSpan.zero;
84
+ }
85
+ static fromDays(value) {
86
+ return value ? new TimeSpan(value, TimeUnit.UnitType.Days) : TimeSpan.zero;
87
+ }
88
+ static fromHours(value) {
89
+ return value ? new TimeSpan(value, TimeUnit.UnitType.Hours) : TimeSpan.zero;
90
+ }
91
+ static fromMinutes(value) {
92
+ return value ? new TimeSpan(value, TimeUnit.UnitType.Minutes) : TimeSpan.zero;
93
+ }
94
+ static fromSeconds(value) {
95
+ return value ? new TimeSpan(value, TimeUnit.UnitType.Seconds) : TimeSpan.zero;
96
+ }
97
+ static fromMilliseconds(value) {
98
+ return value ? new TimeSpan(value) : TimeSpan.zero;
99
+ }
100
+ static fromTicks(value) {
101
+ return value ? new TimeSpan(value, TimeUnit.UnitType.Ticks) : TimeSpan.zero;
102
+ }
103
+ /**
104
+ * Sum the value of this TimeSpan with another time quantity.
105
+ * @param {TimeQuantity | Partial<TimeMeasurement>} other
106
+ * @return {TimeSpan}
107
+ */
108
+ add(other) {
109
+ if (!other)
110
+ return this;
111
+ if (type.isNumber(other))
112
+ throw new Error('Use .addUnit(value:number, units:TimeUnit) to add a numerical value amount. Default units are milliseconds.\n' +
113
+ '.add only supports quantifiable time values (TimeQuantity).');
114
+ const otherMs = other instanceof TimeQuantity
115
+ ? other.total.milliseconds
116
+ : TimeQuantity.getTotalMillisecondsFrom(other);
117
+ return new TimeSpan(this.getTotalMilliseconds() + otherMs);
118
+ }
119
+ /**
120
+ * Sum the value of this TimeSpan with another unit value.
121
+ * @param {number} value
122
+ * @param {TimeUnit.UnitType} units
123
+ * @return {TimeSpan}
124
+ */
125
+ addUnit(value, units = TimeUnit.UnitType.Milliseconds) {
126
+ return value
127
+ ? new TimeSpan(this.getTotalMilliseconds() + TimeUnit.toMilliseconds(value, units))
128
+ : this;
129
+ }
130
+ }
131
+ let timeSpanZero;
132
+ export default TimeSpan;
107
133
  //# sourceMappingURL=TimeSpan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TimeSpan.js","sourceRoot":"","sources":["../../src/TimeSpan.ts"],"names":[],"mappings":"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"}
@@ -1,41 +1,50 @@
1
- /*!
2
- * @author electricessence / https://github.com/electricessence/
3
- * @license MIT
4
- */
5
- import type from '@tsdotnet/type';
6
- /**
7
- * An alternative to Date or DateTime. Is a model representing the exact date and time.
8
- */
9
- export class TimeStamp {
10
- constructor(year, month, day = 1, hour = 0, minute = 0, second = 0, millisecond = 0, tick = 0) {
11
- // Add validation or properly carry out of range values?
12
- this.year = year;
13
- this.month = month;
14
- this.day = day;
15
- this.hour = hour;
16
- this.minute = minute;
17
- this.second = second;
18
- this.millisecond = millisecond;
19
- this.tick = tick;
20
- Object.freeze(this);
21
- }
22
- static from(d) {
23
- if (!(d instanceof Date) && type.hasMember(d, 'toJsDate'))
24
- d = d.toJsDate();
25
- if (d instanceof Date) {
26
- return new TimeStamp(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds());
27
- }
28
- else {
29
- throw Error('Invalid date type.');
30
- }
31
- }
32
- static now() {
33
- return TimeStamp.from(new Date());
34
- }
35
- toJsDate() {
36
- const _ = this;
37
- return new Date(_.year, _.month, _.day, _.hour, _.minute, _.second, _.millisecond + _.tick / 10000 /* ticks.per.millisecond */);
38
- }
39
- }
40
- export default TimeStamp;
1
+ /*!
2
+ * @author electricessence / https://github.com/electricessence/
3
+ * @license MIT
4
+ */
5
+ import type from '@tsdotnet/type';
6
+ import { ticks } from './howMany';
7
+ /**
8
+ * An alternative to Date or DateTime. Is a model representing the exact date and time.
9
+ */
10
+ export class TimeStamp {
11
+ year;
12
+ month;
13
+ day;
14
+ hour;
15
+ minute;
16
+ second;
17
+ millisecond;
18
+ tick;
19
+ constructor(year, month, day = 1, hour = 0, minute = 0, second = 0, millisecond = 0, tick = 0) {
20
+ // Add validation or properly carry out of range values?
21
+ this.year = year;
22
+ this.month = month;
23
+ this.day = day;
24
+ this.hour = hour;
25
+ this.minute = minute;
26
+ this.second = second;
27
+ this.millisecond = millisecond;
28
+ this.tick = tick;
29
+ Object.freeze(this);
30
+ }
31
+ static from(d) {
32
+ if (!(d instanceof Date) && type.hasMember(d, 'toJsDate'))
33
+ d = d.toJsDate();
34
+ if (d instanceof Date) {
35
+ return new TimeStamp(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes(), d.getSeconds(), d.getMilliseconds());
36
+ }
37
+ else {
38
+ throw Error('Invalid date type.');
39
+ }
40
+ }
41
+ static now() {
42
+ return TimeStamp.from(new Date());
43
+ }
44
+ toJsDate() {
45
+ const _ = this;
46
+ return new Date(_.year, _.month, _.day, _.hour, _.minute, _.second, _.millisecond + _.tick / ticks.per.millisecond);
47
+ }
48
+ }
49
+ export default TimeStamp;
41
50
  //# sourceMappingURL=TimeStamp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TimeStamp.js","sourceRoot":"","sources":["../../src/TimeStamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAElC,OAAO,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC;AAIhC;;GAEG;AACH,MAAM,OAAO,SAAS;IAKJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IARjB,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,IAAI,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,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACnH,CAAC;CACD;AAED,eAAe,SAAS,CAAC"}