sheet datetime

Signed-off-by: Alex Ivanov <ai@contributor.pw>

Author: contributorpw

snippets/common_js/date-range-iterator/readme.md

@@ -4,7 +4,7 @@ date: '2021-04-19'
 description: 'Gets an iterator of dates for the specified range.'
 tags: ['js', 'common']
 categories: ['snippets']
-images: ['./snippets/sheets/unlink_urls/screenrecord.gif']
+images: ['./snippets/sheets/date-range-iterator/screenshot.png']
 ---
 
 {{< toc >}}

snippets/common_js/sheet_datetime/appsscript.json

@@ -0,0 +1,6 @@
+{
+  "timeZone": "Europe/Moscow",
+  "dependencies": {},
+  "exceptionLogging": "STACKDRIVER",
+  "runtimeVersion": "V8"
+}

snippets/common_js/sheet_datetime/config.json

@@ -0,0 +1,3 @@
+{
+  "type": "standalone"
+}

snippets/common_js/sheet_datetime/index.js

@@ -0,0 +1,13 @@
+/**
+ * Converts date-time to numeric Sheets format
+ *
+ * @param {(number|Date)} date JS Date or time in ms
+ * @param {number} timezoneOffset
+ * @return {number} Google Sheets Date number
+ */
+function toGoogleSheetsDateNumber(date, timezoneOffset) {
+  const _date = new Date(date);
+  timezoneOffset = timezoneOffset || _date.getTimezoneOffset();
+  const _start = new Date(Date.UTC(1899, 11, 30, 0, 0, 0, 0));
+  return ((_date.getTime() - _start.getTime()) / 60000 - timezoneOffset) / 1440;
+}

snippets/common_js/sheet_datetime/readme.md

@@ -0,0 +1,30 @@
+---
+title: 'Sheets datetime converter'
+date: '2021-04-20'
+description: 'Converts date-time to Sheets format.'
+tags: ['js', 'common']
+categories: ['snippets']
+---
+
+{{< toc >}}
+
+## Sheets datetime converter
+
+![Snippet of Sheets datetime converter](./screenshot.png)
+
+### Snippet
+
+- {{< externalLink >}}
+- {{< commentLink >}}
+- {{< scrvizLink >}}
+
+{{< codeFromFile "index.js" >}}
+
+### Run it
+
+{{< codeFromFile "run.js" >}}
+
+### Relations
+
+- [google apps script - How to get a date format string from a sheet cell? - Stack Overflow](https://stackoverflow.com/questions/33809229/how-to-get-a-date-format-string-from-a-sheet-cell/33813783#33813783)
+- [javascript - Converting Google spreadsheet date into a JS Date object? - Stack Overflow](https://stackoverflow.com/questions/14363073/converting-google-spreadsheet-date-into-a-js-date-object)

snippets/common_js/sheet_datetime/run.js

@@ -0,0 +1,9 @@
+/**
+ * Returns Sheets datetime number from date of F5 cell
+ * @customfunction
+ */
+function GETSHEETDATETIMENUMBER() {
+  return toGoogleSheetsDateNumber(
+    SpreadsheetApp.getActiveSheet().getRange('F5').getValue()
+  );
+}