@naturalcycles/js-lib 14.228.0 → 14.229.0

package/dist/datetime/localDate.d.ts

@@ -145,3 +145,7 @@ export declare function localDateOrUndefined(d?: LocalDateInput | null): LocalDa
  * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
  */
 export declare function localDateOrToday(d?: LocalDateInput | null): LocalDate;
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export declare function todayIsoDateString(): IsoDateString;

package/dist/datetime/localDate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.localDateRangeIterable = exports.localDateRange = exports.LocalDate = void 0;
+exports.todayIsoDateString = exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.localDateRangeIterable = exports.localDateRange = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
 const iterable2_1 = require("../iter/iterable2");
 const localTime_1 = require("./localTime");
@@ -496,3 +496,11 @@ function localDateOrToday(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
 exports.localDateOrToday = localDateOrToday;
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+function todayIsoDateString() {
+    // It was benchmarked to be faster than by concatenating individual Date components
+    return new Date().toISOString().slice(0, 10);
+}
+exports.todayIsoDateString = todayIsoDateString;

package/dist/datetime/localTime.js

@@ -443,25 +443,8 @@ class LocalTime {
         return localDate_1.LocalDate.fromDate(this.$date);
     }
     toPretty(seconds = true) {
-        const { year, month, day, hour, minute, second } = this.components();
-        return ([
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-') +
-            ' ' +
-            [
-                String(hour).padStart(2, '0'),
-                String(minute).padStart(2, '0'),
-                seconds && String(second).padStart(2, '0'),
-            ]
-                .filter(Boolean)
-                .join(':'));
-        // return this.$date
-        //   .toISOString()
-        //   .slice(0, seconds ? 19 : 16)
-        //   .split('T')
-        //   .join(' ')
+        const s = this.$date.toISOString();
+        return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`
@@ -473,27 +456,13 @@ class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        const { year, month, day } = this.components();
-        return [
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-');
-        // return this.$date.toISOString().slice(0, 10)
+        return this.$date.toISOString().slice(0, 10);
     }
     /**
      * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
      */
     toISOTime(seconds = true) {
-        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-        const { hour, minute, second } = this.components();
-        return [
-            String(hour).padStart(2, '0'),
-            String(minute).padStart(2, '0'),
-            seconds && String(second).padStart(2, '0'),
-        ]
-            .filter(Boolean)
-            .join(':');
+        return this.$date.toISOString().slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `19840621_1705`

package/dist-esm/datetime/localDate.js

@@ -486,3 +486,10 @@ export function localDateOrUndefined(d) {
 export function localDateOrToday(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export function todayIsoDateString() {
+    // It was benchmarked to be faster than by concatenating individual Date components
+    return new Date().toISOString().slice(0, 10);
+}

package/dist-esm/datetime/localTime.js

@@ -441,25 +441,8 @@ export class LocalTime {
         return LocalDate.fromDate(this.$date);
     }
     toPretty(seconds = true) {
-        const { year, month, day, hour, minute, second } = this.components();
-        return ([
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-') +
-            ' ' +
-            [
-                String(hour).padStart(2, '0'),
-                String(minute).padStart(2, '0'),
-                seconds && String(second).padStart(2, '0'),
-            ]
-                .filter(Boolean)
-                .join(':'));
-        // return this.$date
-        //   .toISOString()
-        //   .slice(0, seconds ? 19 : 16)
-        //   .split('T')
-        //   .join(' ')
+        const s = this.$date.toISOString();
+        return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`
@@ -471,27 +454,13 @@ export class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        const { year, month, day } = this.components();
-        return [
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-');
-        // return this.$date.toISOString().slice(0, 10)
+        return this.$date.toISOString().slice(0, 10);
     }
     /**
      * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
      */
     toISOTime(seconds = true) {
-        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-        const { hour, minute, second } = this.components();
-        return [
-            String(hour).padStart(2, '0'),
-            String(minute).padStart(2, '0'),
-            seconds && String(second).padStart(2, '0'),
-        ]
-            .filter(Boolean)
-            .join(':');
+        return this.$date.toISOString().slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `19840621_1705`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.228.0",
+  "version": "14.229.0",
   "scripts": {
     "prepare": "husky",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/localDate.ts

@@ -602,3 +602,11 @@ export function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | und
 export function localDateOrToday(d?: LocalDateInput | null): LocalDate {
   return d ? LocalDate.of(d) : LocalDate.today()
 }
+
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export function todayIsoDateString(): IsoDateString {
+  // It was benchmarked to be faster than by concatenating individual Date components
+  return new Date().toISOString().slice(0, 10)
+}

package/src/datetime/localTime.ts

@@ -541,29 +541,8 @@ export class LocalTime {
   }
 
   toPretty(seconds = true): IsoDateTimeString {
-    const { year, month, day, hour, minute, second } = this.components()
-
-    return (
-      [
-        String(year).padStart(4, '0'),
-        String(month).padStart(2, '0'),
-        String(day).padStart(2, '0'),
-      ].join('-') +
-      ' ' +
-      [
-        String(hour).padStart(2, '0'),
-        String(minute).padStart(2, '0'),
-        seconds && String(second).padStart(2, '0'),
-      ]
-        .filter(Boolean)
-        .join(':')
-    )
-
-    // return this.$date
-    //   .toISOString()
-    //   .slice(0, seconds ? 19 : 16)
-    //   .split('T')
-    //   .join(' ')
+    const s = this.$date.toISOString()
+    return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16)
   }
 
   /**
@@ -577,31 +556,14 @@ export class LocalTime {
    * Returns e.g: `1984-06-21`, only the date part of DateTime
    */
   toISODate(): IsoDateString {
-    const { year, month, day } = this.components()
-
-    return [
-      String(year).padStart(4, '0'),
-      String(month).padStart(2, '0'),
-      String(day).padStart(2, '0'),
-    ].join('-')
-
-    // return this.$date.toISOString().slice(0, 10)
+    return this.$date.toISOString().slice(0, 10)
   }
 
   /**
    * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
    */
   toISOTime(seconds = true): string {
-    // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-    const { hour, minute, second } = this.components()
-
-    return [
-      String(hour).padStart(2, '0'),
-      String(minute).padStart(2, '0'),
-      seconds && String(second).padStart(2, '0'),
-    ]
-      .filter(Boolean)
-      .join(':')
+    return this.$date.toISOString().slice(11, seconds ? 19 : 16)
   }
 
   /**