feat: add support for datetime faker

This is a slightly cleverer version of faker.js'
datetime faker - it lets you pick two dates
between which you're generating a datetime

Author: swist

package-lock.json

@@ -11,6 +11,8 @@
 #
 # Developed with ❤️ by APIs.guru | https://github.com/APIs-guru/graphql-faker
 
+scalar DateTime
+
 type Company {
   id: ID
   name: String @fake(type: companyName)
@@ -26,6 +28,7 @@ type Employee {
   address: String @fake(type: streetAddress, options: { useFullAddress: true })
   subordinates: [Employee!] @listLength(min: 0, max: 3)
   company: Company
+  hiredAt: DateTime @fake(type: dateTime, options: {dateFrom: "2022-01-01", dateTo: "2022-02-28"})
 }
 
 type Query {

src/default-schema.graphql

@@ -94,6 +94,19 @@ const fakeFunctions = {
     args: ['dateFormat'],
     func: (dateFormat) => moment(faker.date.recent()).format(dateFormat),
   },
+  // DateTime section
+  dateTime: {
+    args: ['dateFormat', 'dateFrom', 'dateTo'],
+    func: (dateFormat, dateFrom, dateTo) => {
+      const date = moment(faker.date.between(dateFrom, dateTo));
+      const datetime = moment(faker.datatype.datetime());
+      return datetime.dayOfYear(date.dayOfYear())
+        .year(date.year())
+        .format(dateFormat)
+        .toString()
+      
+    }
+  },
 
   // Finance section
   financeAccountName: () => faker.finance.accountName(),

src/fake.ts

@@ -113,6 +113,13 @@ const fakeDefinitionAST = parse(/* GraphQL */ `
 
     hackerAbbreviation
     hackerPhrase
+    
+    """
+    datetime
+    by default ISO8601
+    """
+    dateTime
+    
 
     "An image url. Configure image with options: \`imageCategory\`, \`imageWidth\`, \`imageHeight\` and \`randomizeImageUrl\`"
     imageUrl
@@ -196,6 +203,9 @@ const fakeDefinitionAST = parse(/* GraphQL */ `
     loremSize: fake__loremSize
     "Only for types \`*Date\`. Example value: \`YYYY MM DD\`. [Full Specification](http://momentjs.com/docs/#/displaying/format/)"
     dateFormat: String = "YYYY-MM-DDTHH:mm:ss[Z]"
+    
+    "Only for types \`*datetime\`. Example value: \`YYYY MM DD\`. [Full Specification](http://momentjs.com/docs/#/displaying/format/)"
+    dateTimeFormat: String = "YYYY-MM-DDTHH:mm:ss[Z]"
     "Only for types \`betweenDate\`. Example value: \`1986-11-02\`."
     dateFrom: String = "2010-01-01"
     "Only for types \`betweenDate\`. Example value: \`2038-01-19\`."