getTxTimestamp fixed (#237)

Signed-off-by: Kestutis Gudynas <44440041+kemi04@users.noreply.github.com>

Co-authored-by: Matthew B White <mbwhite@users.noreply.github.com>

apis/fabric-shim-api/types/index.d.ts

@@ -60,6 +60,7 @@ declare module 'fabric-shim-api' {
 
         getSignedProposal(): ChaincodeProposal.SignedProposal;
         getTxTimestamp(): Timestamp;
+        getDateTimestamp(): Date;
         getBinding(): string;
 
         getState(key: string): Promise<Uint8Array>;

libraries/fabric-shim/lib/stub.js

@@ -403,11 +403,22 @@ class ChaincodeStub {
 	 * Returns the timestamp when the transaction was created. This
 	 * is taken from the transaction {@link ChannelHeader}, therefore it will indicate the
 	 * client's timestamp, and will have the same value across all endorsers.
+	 * Object returned: { seconds: [Long] { low: [int32], high: [int32], unsigned: [bool] }, nanos: [int32] }
 	 */
     getTxTimestamp() {
         return this.txTimestamp;
     }
 
+    /**
+     * Returns the Date object of when the transaction was created. This
+     * is taken from the transaction {@link ChannelHeader}, therefore it will indicate the
+     * client's date, and will have the same value across all endorsers.
+     */
+    getDateTimestamp() {
+        const date = new Date(this.txTimestamp.seconds * 1e3 + this.txTimestamp.nanos / 1e6);
+        return date;
+    }
+
     /**
 	 * Returns a HEX-encoded string of SHA256 hash of the transaction's nonce, creator and epoch concatenated, as a
 	 * unique representation of the specific transaction. This value can be used to prevent replay attacks in chaincodes

libraries/fabric-shim/test/unit/stub.js

@@ -600,6 +600,17 @@ describe('Stub', () => {
             });
         });
 
+        describe('getDateTimestamp', () => {
+            it ('should return transaction date as Node.js Date object', () => {
+                const stub = new Stub('dummyClient', 'dummyChannelId', 'dummyTxid', {
+                    args: []
+                });
+                stub.txTimestamp = {seconds: 1606233385, nanos: 54000000};
+
+                expect(stub.getDateTimestamp()).to.deep.equal(new Date(1606233385054));
+            });
+        });
+
         describe('getBinding', () => {
             it ('should return binding', () => {
                 const stub = new Stub('dummyClient', 'dummyChannelId', 'dummyTxid', {