Merge 4f895f7 into 63db6b8

chance.js

@@ -7294,6 +7294,13 @@
         return this.pick(this.get("emotions"));
     };
 
+    Chance.prototype.mongo_objectid = function() {
+        const timestamp = (new Date().getTime() / 1000 | 0).toString(16);
+        return timestamp + 'xxxxxxxxxxxxxxxx'.replace(/[x]/g, function() {
+            return (Math.random() * 16 | 0).toString(16);
+        }).toLowerCase();
+    };
+
     // -- End Miscellaneous --
 
     Chance.prototype.mersenne_twister = function (seed) {

docs/README.md

@@ -123,5 +123,6 @@
   * [tv](miscellaneous/tv.md)
   * [unique](miscellaneous/unique.md)
   * [weighted](miscellaneous/weighted.md)
+  * [mongo_objectid](miscellaneous/mongo_objectid.md)
 
 <script type="text/javascript" src="chance.js"></script>

docs/chance.js

@@ -2492,7 +2492,7 @@
     };
 
     var data = {
-     
+
 
 
         firstNames: {
@@ -6848,7 +6848,7 @@
              "Joy",
              "Surprise",
              "Anger",
-             "Sadness", 
+             "Sadness",
              "Fear"
         ],
     };
@@ -7034,6 +7034,13 @@
         return this.pick(this.get("emotions"));
     };
 
+    Chance.prototype.mongo_objectid = function() {
+        const timestamp = (new Date().getTime() / 1000 | 0).toString(16);
+        return timestamp + 'xxxxxxxxxxxxxxxx'.replace(/[x]/g, function() {
+            return (Math.random() * 16 | 0).toString(16);
+        }).toLowerCase();
+    }
+
     // -- End Miscellaneous --
 
     Chance.prototype.mersenne_twister = function (seed) {

docs/miscellaneous/mongo_objectid.md

@@ -0,0 +1,13 @@
+# mongo_objectid
+
+```js
+// usage
+chance.mongo_objectid()
+```
+
+Return a random mongo object ID string.
+
+```js
+chance.mongo_objectid();
+=> '507f191e810c19729de860ea'
+```

test/test.misc.js

@@ -296,3 +296,13 @@ test('tv() works as expected', t => {
         t.true(/^[KW][A-Z][A-Z][A-Z]/.test(tv))
     })
 })
+
+// chance.mongo_objectid()
+test('mongo_objectid() returns a proper objectId', t => {
+    _.times(1000, () => {
+        const objectId = chance.mongo_objectid();
+        const hexTimestamp = objectId.substring(0,8);
+        t.true(_.isDate(new Date(parseInt(hexTimestamp, 16) * 1000)));
+        t.is(objectId.length, 24);
+    })
+})