chore(curriculum): add timestamp microservice lab to cert (#56358)

Co-authored-by: Dario-DC <105294544+Dario-DC@users.noreply.github.com>
2026-10-13 08:32:54 +08:00 · 2024-09-30 19:39:28 +00:00
parent 843830359f
commit 6cbd72743d
4 changed files with 167 additions and 1 deletions
@@ -2717,7 +2717,10 @@
          "In this course, you'll learn the basics of Node and Express including how to create a server, serve different files, and handle different requests from the browser."
        ]
      },
-      "zzhp": { "title": "372", "intro": [] },
+      "lab-timestamp-microservice": {
+        "title": "Build a Timestamp Microservice",
+        "intro": ["In this lab you will build a timestamp microservice"]
+      },
      "lab-request-header-parser-microservice": {
        "title": "Build a Request Header Parser Microservice",
        "intro": [
@@ -0,0 +1,9 @@
+---
+title: Introduction to the Build a Timestamp Microservice
+block: lab-timestamp-microservice
+superBlock: front-end-development
+---
+
+## Introduction to the Build a Timestamp Microservice
+
+In this lab you will build a timestamp microservice
@@ -0,0 +1,10 @@
+{
+  "name": "Build a Timestamp Microservice",
+  "isUpcomingChange": true,
+  "dashedName": "lab-timestamp-microservice",
+  "order": 372,
+  "superBlock": "front-end-development",
+  "challengeOrder": [{ "id": "bd7158d8c443edefaeb5bdef", "title": "Build a Timestamp Microservice" }],
+  "helpCategory": "Backend Development",
+  "blockType": "lab"
+}
@@ -0,0 +1,144 @@
+---
+id: bd7158d8c443edefaeb5bdef
+title: Build a Timestamp Microservice
+challengeType: 4
+dashedName: lab-timestamp-microservice
+---
+
+# --description--
+
+Build a full stack JavaScript app that is functionally similar to this: <a href="https://timestamp-microservice.freecodecamp.rocks" target="_blank" rel="noopener noreferrer nofollow">https://timestamp-microservice.freecodecamp.rocks</a>. Working on this lab will involve you writing your code using one of the following methods:
+
+-   Clone <a href="https://github.com/freeCodeCamp/boilerplate-project-timestamp/"  target="_blank" rel="noopener noreferrer nofollow">this GitHub repo</a> and complete your project locally.
+-   Use <a href="https://gitpod.io/?autostart=true#https://github.com/freeCodeCamp/boilerplate-project-timestamp/"  target="_blank" rel="noopener noreferrer nofollow">our Gitpod starter project</a> to complete your project.
+-   Use a site builder of your choice to complete the project. Be sure to incorporate all the files from our GitHub repo.
+
+**Note:** Time zones conversion is not a purpose of this project, so assume all sent valid dates will be parsed with `new Date()` as GMT dates. 
+
+# --hints--
+
+You should provide your own project, not the example URL.
+
+```js
+(getUserInput) => {
+  assert(
+    !/.*\/timestamp-microservice\.freecodecamp\.rocks/.test(getUserInput('url'))
+  );
+};
+```
+
+A request to `/api/:date?` with a valid date should return a JSON object with a `unix` key that is a Unix timestamp of the input date in milliseconds (as type Number)
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api/2016-12-25').then(
+    (data) => {
+      assert.equal(
+        data.unix,
+        1482624000000,
+        'Should be a valid unix timestamp'
+      );
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+
+A request to `/api/:date?` with a valid date should return a JSON object with a `utc` key that is a string of the input date in the format: `Thu, 01 Jan 1970 00:00:00 GMT`
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api/2016-12-25').then(
+    (data) => {
+      assert.equal(
+        data.utc,
+        'Sun, 25 Dec 2016 00:00:00 GMT',
+        'Should be a valid UTC date string'
+      );
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+
+A request to `/api/1451001600000` should return `{ unix: 1451001600000, utc: "Fri, 25 Dec 2015 00:00:00 GMT" }`
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api/1451001600000').then(
+    (data) => {
+      assert(
+        data.unix === 1451001600000 &&
+          data.utc === 'Fri, 25 Dec 2015 00:00:00 GMT'
+      );
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+
+Your project can handle dates that can be successfully parsed by `new Date(date_string)`
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api/05 October 2011, GMT').then(
+    (data) => {
+      assert(
+        data.unix === 1317772800000 &&
+          data.utc === 'Wed, 05 Oct 2011 00:00:00 GMT'
+      );
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+
+If the input date string is invalid, the API returns an object having the structure `{ error : "Invalid Date" }`
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api/this-is-not-a-date').then(
+    (data) => {
+      assert.equal(data.error.toLowerCase(), 'invalid date');
+    },
+    (xhr) => {
+      assert(xhr.responseJSON.error.toLowerCase() === 'invalid date');
+    }
+  );
+```
+
+An empty date parameter should return the current time in a JSON object with a `unix` key
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api').then(
+    (data) => {
+      var now = Date.now();
+      assert.approximately(data.unix, now, 20000);
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+
+An empty date parameter should return the current time in a JSON object with a `utc` key
+
+```js
+(getUserInput) =>
+  $.get(getUserInput('url') + '/api').then(
+    (data) => {
+      var now = Date.now();
+      var serverTime = new Date(data.utc).getTime();
+      assert.approximately(serverTime, now, 20000);
+    },
+    (xhr) => {
+      throw new Error(xhr.responseText);
+    }
+  );
+```
+