@anglr/datetime 8.1.0 → 9.0.0-beta.20241007050425

package/es2022/moment/src/services/momentDateApi.service.js

@@ -8,24 +8,15 @@ import * as i1 from "@anglr/datetime";
  * Instance of object wrapping TDate, allowing manipulation with it
  */
 export class MomentDateApiObject {
-    //######################### protected fields #########################
-    /**
-     * Original value that is not changed unless 'updateOriginal' is called
-     */
-    _originalValue;
-    /**
-     * Instance of date
-     */
-    _value;
     //######################### public properties - implementation of DateApiObject #########################
     /**
-     * Original value that is not changed unless 'updateOriginal' is called
+     * @inheritdoc
      */
     get originalValue() {
         return this._originalValue;
     }
     /**
-     * Instance of date
+     * @inheritdoc
      */
     get value() {
         return this._value;
@@ -36,21 +27,20 @@ export class MomentDateApiObject {
     }
     //######################### public methods - implementation of DateApiObject #########################
     /**
-     * Gets indication whether provided instance of date is valid
+     * @inheritdoc
      */
     isValid() {
         return this._value.isValid();
     }
     /**
-     * Gets indication whether provided instance of date is weekend day
+     * @inheritdoc
      */
     isWeekend() {
         const weekday = this._value.isoWeekday();
         return weekday == 6 || weekday == 7;
     }
     /**
-     * Formats date value
-     * @param format - Format token used for creating formatted string
+     * @inheritdoc
      */
     format(format) {
         return this._value.format(format.replace(/y/g, 'Y').replace(/d/g, 'D'));
@@ -68,8 +58,13 @@ export class MomentDateApiObject {
         return this._value.unix();
     }
     /**
-     * Updates value to start date and time of current decade
-     * @returns Itself for fluent API
+     * @inheritdoc
+     */
+    timestamp() {
+        return this._value.valueOf();
+    }
+    /**
+     * @inheritdoc
      */
     startOfDecade() {
         const diff = (this._value.year() % 10);
@@ -77,8 +72,7 @@ export class MomentDateApiObject {
         return this;
     }
     /**
-     * Updates value to end date and time of current decade
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfDecade() {
         const diff = 9 - (this._value.year() % 10);
@@ -86,219 +80,179 @@ export class MomentDateApiObject {
         return this;
     }
     /**
-     * Updates value to start date and time of current year
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfYear() {
         this._value = moment(this._value).startOf('year');
         return this;
     }
     /**
-     * Updates value to end date and time of current year
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfYear() {
         this._value = moment(this._value).endOf('year');
         return this;
     }
     /**
-     * Add years, if count not specified adds 1 year
-     * @param count - Number of years count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addYears(count) {
         this._value = moment(this._value).add(count ?? 1, 'years');
         return this;
     }
     /**
-     * Subtract years, if count not specified subtract 1 year
-     * @param count - Number of years count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractYears(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'years');
         return this;
     }
     /**
-     * Updates value to start date and time of current month
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfMonth() {
         this._value = moment(this._value).startOf('month');
         return this;
     }
     /**
-     * Updates value to end date and time of current month
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfMonth() {
         this._value = moment(this._value).endOf('month');
         return this;
     }
     /**
-     * Add months, if count not specified adds 1 month
-     * @param count - Number of months count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addMonths(count) {
         this._value = moment(this._value).add(count ?? 1, 'months');
         return this;
     }
     /**
-     * Subtract months, if count not specified subtract 1 month
-     * @param count - Number of months count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractMonths(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'months');
         return this;
     }
     /**
-     * Updates value to start date and time of current week
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfWeek() {
         this._value = moment(this._value).startOf('week');
         return this;
     }
     /**
-     * Updates value to end date and time of current week
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfWeek() {
         this._value = moment(this._value).endOf('week');
         return this;
     }
     /**
-     * Add weeks, if count not specified adds 1 week
-     * @param count - Number of weeks count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addWeeks(count) {
         this._value = moment(this._value).add(count ?? 1, 'weeks');
         return this;
     }
     /**
-     * Subtract weeks, if count not specified subtract 1 week
-     * @param count - Number of weeks count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractWeeks(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'weeks');
         return this;
     }
     /**
-     * Updates value to start date and time of current day
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfDay() {
         this._value = moment(this._value).startOf('day');
         return this;
     }
     /**
-     * Updates value to end date and time of current day
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfDay() {
         this._value = moment(this._value).endOf('day');
         return this;
     }
     /**
-     * Add days, if count not specified adds 1 day
-     * @param count - Number of days count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addDays(count) {
         this._value = moment(this._value).add(count ?? 1, 'days');
         return this;
     }
     /**
-     * Subtract days, if count not specified subtract 1 day
-     * @param count - Number of days count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractDays(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'days');
         return this;
     }
     /**
-     * Updates value to start date and time of current hour
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfHour() {
         this._value = moment(this._value).startOf('hour');
         return this;
     }
     /**
-     * Updates value to end date and time of current hour
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfHour() {
         this._value = moment(this._value).endOf('hour');
         return this;
     }
     /**
-     * Add hours, if count not specified adds 1 hour
-     * @param count - Number of hours count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addHours(count) {
         this._value = moment(this._value).add(count ?? 1, 'hours');
         return this;
     }
     /**
-     * Subtract hours, if count not specified subtract 1 hour
-     * @param count - Number of hours count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractHours(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'hours');
         return this;
     }
     /**
-     * Updates value to start date and time of current minute
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     startOfMinute() {
         this._value = moment(this._value).startOf('minute');
         return this;
     }
     /**
-     * Updates value to end date and time of current minute
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     endOfMinute() {
         this._value = moment(this._value).endOf('minute');
         return this;
     }
     /**
-     * Add minutes, if count not specified adds 1 minute
-     * @param count - Number of minutes count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     addMinutes(count) {
         this._value = moment(this._value).add(count ?? 1, 'minutes');
         return this;
     }
     /**
-     * Subtract minutes, if count not specified subtract 1 minute
-     * @param count - Number of minutes count
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     subtractMinutes(count) {
         this._value = moment(this._value).subtract(count ?? 1, 'minutes');
         return this;
     }
     /**
-     * Gets number of days in month
+     * @inheritdoc
      */
     daysInMonth() {
         return this._value.daysInMonth();
     }
-    /**
-     * Gets or sets year
-     * @param year - If specified, sets year
-     */
     year(year) {
         if (isPresent(year)) {
             this._value = moment(this._value).year(year);
@@ -306,10 +260,6 @@ export class MomentDateApiObject {
         }
         return this._value.year();
     }
-    /**
-     * Gets or sets month
-     * @param month - If specified, sets month
-     */
     month(month) {
         if (isPresent(month)) {
             this._value = moment(this._value).month(month);
@@ -317,10 +267,6 @@ export class MomentDateApiObject {
         }
         return this._value.month();
     }
-    /**
-     * Gets or sets day of month one based
-     * @param day - If specified, sets day of month
-     */
     dayOfMonth(day) {
         if (isPresent(day)) {
             this._value = moment(this._value).date(day);
@@ -328,10 +274,6 @@ export class MomentDateApiObject {
         }
         return this._value.date();
     }
-    /**
-     * Gets or sets day of week zero based, first is monday
-     * @param day - If specified, sets day of week
-     */
     dayOfWeek(day) {
         if (isPresent(day)) {
             this._value = moment(this._value).weekday(day);
@@ -339,10 +281,6 @@ export class MomentDateApiObject {
         }
         return this._value.weekday();
     }
-    /**
-     * Gets or sets hours zero
-     * @param hour - If specified, sets hour
-     */
     hour(hour) {
         if (isPresent(hour)) {
             this._value = moment(this._value).hours(hour);
@@ -350,10 +288,6 @@ export class MomentDateApiObject {
         }
         return this._value.hours();
     }
-    /**
-     * Gets or sets minutes zero based
-     * @param minute - If specified, sets minutes
-     */
     minute(minute) {
         if (isPresent(minute)) {
             this._value = moment(this._value).minutes(minute);
@@ -362,40 +296,35 @@ export class MomentDateApiObject {
         return this._value.minutes();
     }
     /**
-     * Gets indication whether current value is before 'date'
-     * @param date - Date which is this date compared to
+     * @inheritdoc
      */
     isBefore(date) {
         date = this.getDate(date);
         return this._value.isBefore(date);
     }
     /**
-     * Gets indication whether current value is after 'date'
-     * @param date - Date which is this date compared to
+     * @inheritdoc
      */
     isAfter(date) {
         date = this.getDate(date);
         return this._value.isAfter(date);
     }
     /**
-     * Gets number of days between this and provided date
-     * @param date - Date which is used for computation of diff against
+     * @inheritdoc
      */
     diffDays(date) {
         date = this.getDate(date);
         return moment(this._value).startOf('day').diff(moment(date).startOf('day'), 'days');
     }
     /**
-     * Compares whether this date is same week as provided date
-     * @param date - Date which is used for comparison of same week
+     * @inheritdoc
      */
     isSameWeek(date) {
         date = this.getDate(date);
         return this._value.isSame(date, 'week');
     }
     /**
-     * Compares whether this date is same decade as provided date
-     * @param date - Date which is used for comparison of same decade
+     * @inheritdoc
      */
     isSameDecade(date) {
         date = this.getDate(date);
@@ -405,24 +334,21 @@ export class MomentDateApiObject {
         return date.year() >= start && date.year() < end;
     }
     /**
-     * Compares whether this date is same year as provided date
-     * @param date - Date which is used for comparison of same year
+     * @inheritdoc
      */
     isSameYear(date) {
         date = this.getDate(date);
         return this._value.isSame(date, 'year');
     }
     /**
-     * Compares whether this date is same month as provided date
-     * @param date - Date which is used for comparison of same month
+     * @inheritdoc
      */
     isSameMonth(date) {
         date = this.getDate(date);
         return this._value.isSame(date, 'month');
     }
     /**
-     * Compares whether this date is same day as provided date
-     * @param date - Date which is used for comparison of same day
+     * @inheritdoc
      */
     isSameDay(date) {
         date = this.getDate(date);
@@ -436,21 +362,19 @@ export class MomentDateApiObject {
         return this._value.isSame(date);
     }
     /**
-     * Creates clone of this instance, value and originalValue have same value and are cloned from value
+     * @inheritdoc
      */
     clone() {
         return new MomentDateApiObject(moment(this._value));
     }
     /**
-     * Creates clone of this instance, value and originalValue have same value and are cloned from originalValue
+     * @inheritdoc
      */
     cloneOriginal() {
         return new MomentDateApiObject(moment(this._originalValue));
     }
     /**
-     * Updates originalValue, if value is not provided originalValue is set to value
-     * @param value - Value to be set as original, or null (value will be used as value)
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     updateOriginal(value) {
         if (isBlank(value)) {
@@ -462,8 +386,7 @@ export class MomentDateApiObject {
         return this;
     }
     /**
-     * Changes value to same value as originalValue
-     * @returns Itself for fluent API
+     * @inheritdoc
      */
     resetOriginal() {
         this._value = this._originalValue;
@@ -485,8 +408,6 @@ export class MomentDateApiObject {
  * Date api using MomentJS, used for obtaining DateApi wrapper object
  */
 export class MomentDateApi {
-    _relativeParser;
-    _dateApiObjecType;
     //######################### constructor #########################
     constructor(_relativeParser, _dateApiObjecType) {
         this._relativeParser = _relativeParser;
@@ -494,22 +415,19 @@ export class MomentDateApi {
     }
     //######################### public methods #########################
     /**
-     * Gets wrapping object used for manipulation
-     * @param value - Value to be converted (parsed) and used for manipulation
-     * @param format - Format string used for parsing string value
+     * @inheritdoc
      */
     getValue(value, format) {
         return new this._dateApiObjecType(this._relativeParser.parse(value), format);
     }
     /**
-     * Gets wrapping object used for manipulation instantiated to current date and time
+     * @inheritdoc
      */
     now() {
         return new this._dateApiObjecType(moment());
     }
     /**
-     * Gets format string using pseudo format
-     * @param pseudoFormat - Pseudo format token, used for obtaining 'date' or 'time' format string
+     * @inheritdoc
      */
     getFormat(pseudoFormat) {
         if (/^((LT|LTS|L+|l+)\s*)*$/g.test(pseudoFormat)) {
@@ -518,13 +436,19 @@ export class MomentDateApi {
         return pseudoFormat;
     }
     /**
-     * Gets information
+     * @inheritdoc
      */
     weekStartsOnMonday() {
         return moment.localeData().firstDayOfWeek() === 1;
     }
     /**
-     * Gets array of weekday names in short format, order of days is dependent on locale
+     * @inheritdoc
+     */
+    weekdays(short) {
+        return short ? moment.weekdaysShort(true) : moment.weekdays(true);
+    }
+    /**
+     * @inheritdoc
      */
     weekdaysShort() {
         return moment.weekdaysShort(true);
@@ -535,10 +459,10 @@ export class MomentDateApi {
     isDate(value) {
         return value instanceof moment;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.1.1", ngImport: i0, type: MomentDateApi, deps: [{ token: i1.DateTimeRelativeParser }, { token: DATE_API_OBJECT_TYPE }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.1.1", ngImport: i0, type: MomentDateApi });
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.7", ngImport: i0, type: MomentDateApi, deps: [{ token: i1.DateTimeRelativeParser }, { token: DATE_API_OBJECT_TYPE }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.7", ngImport: i0, type: MomentDateApi }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.1.1", ngImport: i0, type: MomentDateApi, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.7", ngImport: i0, type: MomentDateApi, decorators: [{
             type: Injectable
         }], ctorParameters: () => [{ type: i1.DateTimeRelativeParser }, { type: undefined, decorators: [{
                     type: Inject,