[items] ItemHistory: Add previousStateTimestamp method

items/item-history.js

@@ -1,7 +1,5 @@
-// const { ZonedDateTime } = require('@js-joda/core');
-const time = require('../time');
+const time = require('@js-joda/core');
 const PersistenceExtensions = Java.type('org.openhab.core.persistence.extensions.PersistenceExtensions');
-const DateTime = Java.type('java.time.ZonedDateTime');
 
 /**
  * Class representing the historic state of an openHAB Item.
@@ -223,7 +221,7 @@ class ItemHistory {
    * @returns {(string | null)} state
    */
   latestState (serviceId) {
-    return this.historicState(DateTime.now(), ...arguments);
+    return this.historicState(time.ZonedDateTime.now(), ...arguments);
   }
 
   /**
@@ -300,6 +298,17 @@ class ItemHistory {
     return this._stateOrNull(PersistenceExtensions.previousState(this.rawItem, ...arguments));
   }
 
+  /**
+   * Returns the time when the previous state of a given Item was persisted.
+   *
+   * @param {boolean} [skipEqual] optional, if true, skips equal state values and searches the first state not equal the current state
+   * @param {string} [serviceId] Optional persistence service ID, if omitted, the default persistence service will be used.
+   * @returns {(time.ZonedDateTime | null)} {@link time.ZonedDateTime} or null
+   */
+  previousStateTimestamp (skipEqual, serviceId) {
+    return this._timestampOrNull(PersistenceExtensions.previousState(this.rawItem, ...arguments));
+  }
+
   /**
    * Gets the sum of the states of a given Item between two certain points in time.
    *
@@ -373,7 +382,14 @@ class ItemHistory {
    * @private
    */
   _stateOrNull (result) {
-    return result === null ? null : result.state.toString();
+    return result === null ? null : result.getState().toString();
+  }
+
+  /**
+   * @private
+   */
+  _timestampOrNull (result) {
+    return result === null ? null : time.ZonedDateTime().parse(result.getTimestamp().toString());
   }
 
   /**

types/items/item-history.d.ts

@@ -213,6 +213,14 @@ declare class ItemHistory {
      * @returns {(string | null)} state or null
      */
     previousState(skipEqual?: boolean, serviceId?: string, ...args: any[]): (string | null);
+    /**
+     * Returns the time when the previous state of a given Item was persisted.
+     *
+     * @param {boolean} [skipEqual] optional, if true, skips equal state values and searches the first state not equal the current state
+     * @param {string} [serviceId] Optional persistence service ID, if omitted, the default persistence service will be used.
+     * @returns {(time.ZonedDateTime | null)} {@link time.ZonedDateTime} or null
+     */
+    previousStateTimestamp(skipEqual?: boolean, serviceId?: string, ...args: any[]): (time.ZonedDateTime | null);
     /**
      * Gets the sum of the states of a given Item between two certain points in time.
      *
@@ -268,6 +276,10 @@ declare class ItemHistory {
      * @private
      */
     private _stateOrNull;
+    /**
+     * @private
+     */
+    private _timestampOrNull;
     /**
      * @private
      */
@@ -277,4 +289,5 @@ declare class ItemHistory {
      */
     private _decimalOrNull;
 }
+import time = require("@js-joda/core");
 //# sourceMappingURL=item-history.d.ts.map