@naturalcycles/js-lib 14.180.0 → 14.181.1

package/dist/datetime/localDate.d.ts

@@ -96,4 +96,10 @@ export declare class LocalDate {
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
-export declare function localDate(d?: LocalDateInput): LocalDate;
+export declare function localDate(d?: LocalDateInput | null): LocalDate;
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
+ *
+ * `localDate` function will instead return LocalDate of today for falsy input.
+ */
+export declare function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | undefined;

package/dist/datetime/localDate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localDate = exports.LocalDate = void 0;
+exports.localDateOrUndefined = exports.localDate = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
 const localTime_1 = require("./localTime");
 const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -418,3 +418,12 @@ function localDate(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
 exports.localDate = localDate;
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
+ *
+ * `localDate` function will instead return LocalDate of today for falsy input.
+ */
+function localDateOrUndefined(d) {
+    return d ? LocalDate.of(d) : undefined;
+}
+exports.localDateOrUndefined = localDateOrUndefined;

package/dist/datetime/localTime.d.ts

@@ -125,4 +125,10 @@ export declare class LocalTime {
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
-export declare function localTime(d?: LocalTimeInput): LocalTime;
+export declare function localTime(d?: LocalTimeInput | null): LocalTime;
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
+ *
+ * `localTime` function will instead return LocalTime of `now` for falsy input.
+ */
+export declare function localTimeOrUndefined(d?: LocalTimeInput | null): LocalTime | undefined;

package/dist/datetime/localTime.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
+exports.localTimeOrUndefined = exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
 const assert_1 = require("../error/assert");
 const time_util_1 = require("../time/time.util");
 const localDate_1 = require("./localDate");
@@ -495,6 +495,15 @@ function localTime(d) {
     return d ? LocalTime.of(d) : LocalTime.now();
 }
 exports.localTime = localTime;
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
+ *
+ * `localTime` function will instead return LocalTime of `now` for falsy input.
+ */
+function localTimeOrUndefined(d) {
+    return d ? LocalTime.of(d) : undefined;
+}
+exports.localTimeOrUndefined = localTimeOrUndefined;
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date) {
     const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime();

package/dist-esm/datetime/localDate.js

@@ -413,3 +413,11 @@ export class LocalDate {
 export function localDate(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
+ *
+ * `localDate` function will instead return LocalDate of today for falsy input.
+ */
+export function localDateOrUndefined(d) {
+    return d ? LocalDate.of(d) : undefined;
+}

package/dist-esm/datetime/localTime.js

@@ -491,6 +491,14 @@ export class LocalTime {
 export function localTime(d) {
     return d ? LocalTime.of(d) : LocalTime.now();
 }
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
+ *
+ * `localTime` function will instead return LocalTime of `now` for falsy input.
+ */
+export function localTimeOrUndefined(d) {
+    return d ? LocalTime.of(d) : undefined;
+}
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date) {
     const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime();

package/package.json

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

package/src/datetime/localDate.ts

@@ -507,6 +507,15 @@ export class LocalDate {
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
-export function localDate(d?: LocalDateInput): LocalDate {
+export function localDate(d?: LocalDateInput | null): LocalDate {
   return d ? LocalDate.of(d) : LocalDate.today()
 }
+
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
+ *
+ * `localDate` function will instead return LocalDate of today for falsy input.
+ */
+export function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | undefined {
+  return d ? LocalDate.of(d) : undefined
+}

package/src/datetime/localTime.ts

@@ -599,10 +599,19 @@ export class LocalTime {
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
-export function localTime(d?: LocalTimeInput): LocalTime {
+export function localTime(d?: LocalTimeInput | null): LocalTime {
   return d ? LocalTime.of(d) : LocalTime.now()
 }
 
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
+ *
+ * `localTime` function will instead return LocalTime of `now` for falsy input.
+ */
+export function localTimeOrUndefined(d?: LocalTimeInput | null): LocalTime | undefined {
+  return d ? LocalTime.of(d) : undefined
+}
+
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date: Date): number {
   const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime()