Enable retrieval of historical data for 'target'

qiskit_ibm_runtime/ibm_backend.py

@@ -212,10 +212,14 @@ def __getattr__(self, name: str) -> Any:
                 )
             )
 
-    def _get_properties(self) -> None:
+    def _get_properties(self, datetime: Optional[python_datetime] = None) -> None:
         """Gets backend properties and decodes it"""
+        if datetime:
+            datetime = local_to_utc(datetime)
         if not self._properties:
-            api_properties = self._api_client.backend_properties(self.name)
+            api_properties = self._api_client.backend_properties(
+                self.name, datetime=datetime
+            )
             if api_properties:
                 backend_properties = properties_from_server_data(api_properties)
                 self._properties = backend_properties
@@ -311,6 +315,16 @@ def target(self) -> Target:
         self._convert_to_target()
         return self._target
 
+    def target_history(self, datetime: Optional[python_datetime] = None) -> Target:
+        """A :class:`qiskit.transpiler.Target` object for the backend.
+        Returns:
+            Target with properties found on `datetime`
+        """
+        self._get_properties(datetime=datetime)
+        self._get_defaults()
+        self._convert_to_target()
+        return self._target
+
     def properties(
         self, refresh: bool = False, datetime: Optional[python_datetime] = None
     ) -> Optional[BackendProperties]:

releasenotes/notes/target-history-93e8eca3abf49230.yaml

@@ -0,0 +1,7 @@
+---
+features:
+  - |
+    Added the method :meth:`~qiskit_ibm_runtime.IBMBackend.target_history`. 
+    This method is similar to :meth:`~qiskit_ibm_runtime.IBMBackend.target`.
+    The difference is that the new method enables the user to pass a `datetime` parameter,
+    to retrieve historical data from the backend.