Add date/clone method (#39)

* Add clone method

* Update after code review

* Update after code review

Co-authored-by: krystianborucinski <krystian.borucinski@sandstream.pl>

Author: 2 people

README.md

@@ -694,6 +694,29 @@ Runs the given tasks in a sequence.
 ```
 <!-- prettier-ignore-end -->
 
+#### clone
+
+Clones the given Date object.
+
+##### Type signature
+
+<!-- prettier-ignore-start -->
+```typescript
+(date: Date) => Date
+```
+<!-- prettier-ignore-end -->
+
+##### Examples
+
+<!-- prettier-ignore-start -->
+```javascript
+const date = new new Date('2019-04-24T13:54:33.232Z');
+const cloned = clone(date);
+
+cloned !== date && cloned.valueOf() === date.valueOf(); // ⇒ true
+```
+<!-- prettier-ignore-end -->
+
 #### dateDiff
 
 ##### Type signature

date/README.md

@@ -38,6 +38,29 @@
 ```
 <!-- prettier-ignore-end -->
 
+# clone
+
+Clones the given Date object.
+
+## Type signature
+
+<!-- prettier-ignore-start -->
+```typescript
+(date: Date) => Date
+```
+<!-- prettier-ignore-end -->
+
+## Examples
+
+<!-- prettier-ignore-start -->
+```javascript
+const date = new new Date('2019-04-24T13:54:33.232Z');
+const cloned = clone(date);
+
+cloned !== date && cloned.valueOf() === date.valueOf(); // ⇒ true
+```
+<!-- prettier-ignore-end -->
+
 # dateDiff
 
 ## Type signature

date/clone.js

@@ -0,0 +1 @@
+export default date => new Date(+date);

date/clone.json

@@ -0,0 +1,12 @@
+{
+  "name": "clone",
+  "description": "Clones the given Date object.",
+  "signature": "(date: Date) => Date",
+  "examples": [
+    {
+      "language": "javascript",
+      "content": "const date = new new Date('2019-04-24T13:54:33.232Z');\nconst cloned = clone(date);\n\ncloned !== date && cloned.valueOf() === date.valueOf(); // ⇒ true"
+    }
+  ],
+  "questions": ["TODO: List questions that may this function answer."]
+}

date/clone.md

@@ -0,0 +1,22 @@
+# clone
+
+Clones the given Date object.
+
+## Type signature
+
+<!-- prettier-ignore-start -->
+```typescript
+(date: Date) => Date
+```
+<!-- prettier-ignore-end -->
+
+## Examples
+
+<!-- prettier-ignore-start -->
+```javascript
+const date = new new Date('2019-04-24T13:54:33.232Z');
+const cloned = clone(date);
+
+cloned !== date && cloned.valueOf() === date.valueOf(); // ⇒ true
+```
+<!-- prettier-ignore-end -->

date/clone.test.ts

@@ -0,0 +1,13 @@
+/* eslint-env jest */
+// @ts-ignore ambiguous import
+import clone from "./clone.ts";
+
+describe("clone", () => {
+  it("should return cloned date", () => {
+    const date = new Date("2019-04-24T13:54:33.232Z");
+    const cloned = clone(date);
+
+    expect(cloned).not.toBe(date);
+    expect(cloned).toEqual(date);
+  });
+});

date/clone.ts

@@ -0,0 +1 @@
+export default (date: Date) => new Date(+date);

date/index.js

@@ -1,5 +1,6 @@
 import byDateWithFallback from "./byDateWithFallback.js";
 import clamp from "./clamp.js";
+import clone from "./clone.js";
 import dateDiff from "./dateDiff.js";
 import dateInRange from "./dateInRange.js";
 import dayRange from "./dayRange.js";
@@ -39,6 +40,7 @@ import valid from "./valid.js";
 export {
   byDateWithFallback,
   clamp,
+  clone,
   dateDiff,
   dateInRange,
   dayRange,
@@ -79,6 +81,7 @@ export {
 export default {
   byDateWithFallback,
   clamp,
+  clone,
   dateDiff,
   dateInRange,
   dayRange,

date/index.ts

@@ -1,5 +1,6 @@
 import byDateWithFallback from "./byDateWithFallback";
 import clamp from "./clamp";
+import clone from "./clone";
 import dateDiff from "./dateDiff";
 import dateInRange from "./dateInRange";
 import dayRange from "./dayRange";
@@ -39,6 +40,7 @@ import valid from "./valid";
 export {
   byDateWithFallback,
   clamp,
+  clone,
   dateDiff,
   dateInRange,
   dayRange,
@@ -79,6 +81,7 @@ export {
 export default {
   byDateWithFallback,
   clamp,
+  clone,
   dateDiff,
   dateInRange,
   dayRange,