@hkdigital/lib-sveltekit 0.1.59 → 0.1.60

package/dist/util/time/index.d.ts

@@ -10,9 +10,9 @@
  *   resolves. If this parameter is set, the delay will be chosen randomly
  *   between the values [delayOrMinDelayMs, maxDelayMs]
  *
- * @returns {Promise} promise that resolves after a specified timeout
+ * @returns {HkPromise} promise that resolves after a specified timeout
  */
-export function delay(delayOrMinDelayMs: number, maxDelayMs?: number): Promise<any>;
+export function delay(delayOrMinDelayMs: number, maxDelayMs?: number): HkPromise;
 /**
  * Get the number of milliseconds since the specified time stamp of the default
  * reference time stamp TIME_2025_01_01
@@ -53,61 +53,56 @@ export function toDate(dateOrTimestamp: Date | number): Date;
 export function getWeekNumber(dateOrTimestamp: Date | number): number;
 /**
  * Get the name of the month
- * - Returns the English name of the month
+ * - Returns the month name using Intl.DateTimeFormat
+ * - By default uses English locale, but locale can be specified
  *
- * - Use the output as label in combination with the functions
- *   text() and translate() for international month names
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
+ * @param {string} [locale='nl-NL'] - The locale to use for the month name
  *
- * e.g.
+ * @param {Object} [options]
+ * @param {'numeric'|'2-digit'|'narrow'|'short'|'long'} [options.month='long']
+ * @param {string} [options.timeZone] - Optional timezone
  *
- * setTranslations()
- * ...
- *
- * text( getMonthName( new Date() ) );
- *
- * --
- *
- * @param {Date|number} dateOrTimestamp
- *
- * @returns {string} name of the month (English)
+ * @returns {string} name of the month in the specified locale
  */
-export function getMonthName(dateOrTimestamp: Date | number): string;
+export function getMonthName(dateOrTimestamp: Date | number, locale?: string, options?: {
+    month?: "numeric" | "2-digit" | "narrow" | "short" | "long";
+    timeZone?: string;
+}): string;
 /**
- * Get the name of the day
- * - Returns the English name of the day
- *
- * - Use the output as label in combination with the functions
- *   text() and translate() for international day names
+ * Get the name of the day of the week
+ * - Returns the day name using Intl.DateTimeFormat
+ * - By default uses English locale, but locale can be specified
  *
- * e.g.
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
+ * @param {string} [locale='nl-NL'] - The locale to use for the day name
  *
- * setTranslations()
- * ...
+ * @param {Object} [options]
+ * @param {'narrow'|'short'|'long'} [options.weekday='long']
+ * @param {string} [options.timeZone] - Optional timezone
  *
- * text( getDayName( new Date() ) );
- *
- * --
- *
- * @param {Date|number} dateOrTimestamp
- *
- * @returns {string} name of the day (English)
+ * @returns {string} name of the day in the specified locale
  */
-export function getDayName(dateOrTimestamp: Date | number): string;
+export function getDayName(dateOrTimestamp: Date | number, locale?: string, options?: {
+    weekday?: "narrow" | "short" | "long";
+    timeZone?: string;
+}): string;
 /**
  * Return the timestamp of the start of the day
  * - Midnight
  *
- * @param {Date|number} dateOrTimestamp
+ * @param {Date|number} [dateOrTimestamp]
  *
  * @returns {number} timestamp of start of the day (00:00:00:0000)
  */
-export function getTimeAtStartOfDay(dateOrTimestamp: Date | number): number;
+export function getTimeAtStartOfDay(dateOrTimestamp?: Date | number): number;
 /**
  * Return the timestamp of the end of the day
  * - Midnight - 1 millisecond
  *
- * @param {Date|number} dateOrTimestamp
+ * @param {Date|number} [dateOrTimestamp]
  *
  * @returns {number} timestamp of start of the day
  */
-export function getTimeAtEndOfDay(dateOrTimestamp: Date | number): number;
+export function getTimeAtEndOfDay(dateOrTimestamp?: Date | number): number;
+import { HkPromise } from '../../classes/promise/index.js';

package/dist/util/time/index.js

@@ -50,7 +50,7 @@ import { HkPromise } from '../../classes/promise/index.js';
  *   resolves. If this parameter is set, the delay will be chosen randomly
  *   between the values [delayOrMinDelayMs, maxDelayMs]
  *
- * @returns {Promise} promise that resolves after a specified timeout
+ * @returns {HkPromise} promise that resolves after a specified timeout
  */
 export function delay(delayOrMinDelayMs, maxDelayMs) {
 	expect.number(delayOrMinDelayMs);
@@ -132,7 +132,7 @@ export function timeToString(timeMs) {
 
 	str += `${minutes.toString().padStart(2, '0')}:`;
 	str += `${seconds.toString().padStart(2, '0')}.`;
-	str += `${restMs.toString().padEnd(3, '0')}`;
+	str += `${restMs.toString().padStart(3, '0')}`;
 
 	return str;
 }
@@ -209,64 +209,72 @@ export function getWeekNumber(dateOrTimestamp) {
 	// of the year and the Thursday in the target week
 	// (604800000 = 7 * 24 * 3600 * 1000)
 	//
-	return 1 + Math.ceil((firstThursday - target) / 604800000);
+	return 1 + Math.ceil((firstThursday - target.getTime()) / 604800000);
 }
 
 /**
  * Get the name of the month
- * - Returns the English name of the month
+ * - Returns the month name using Intl.DateTimeFormat
+ * - By default uses English locale, but locale can be specified
  *
- * - Use the output as label in combination with the functions
- *   text() and translate() for international month names
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
+ * @param {string} [locale='nl-NL'] - The locale to use for the month name
  *
- * e.g.
+ * @param {Object} [options]
+ * @param {'numeric'|'2-digit'|'narrow'|'short'|'long'} [options.month='long']
+ * @param {string} [options.timeZone] - Optional timezone
  *
- * setTranslations()
- * ...
- *
- * text( getMonthName( new Date() ) );
- *
- * --
- *
- * @param {Date|number} dateOrTimestamp
- *
- * @returns {string} name of the month (English)
+ * @returns {string} name of the month in the specified locale
  */
-export function getMonthName(dateOrTimestamp) {
-	throw new Error('Not implemented yet');
-	// return MONTH_NAME_LABELS_EN[toDate(dateOrTimestamp).getMonth()];
+export function getMonthName(dateOrTimestamp, locale = 'nl-NL',
+    options = { month: 'long' }) {
+
+  const date = toDate(dateOrTimestamp);
+
+  // Create formatter with provided locale and options
+  // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
+  const formatter = new Intl.DateTimeFormat(locale, {
+    month: options?.month || 'long',
+    ...(options?.timeZone ? { timeZone: options.timeZone } : {})
+  });
+
+  return formatter.format(date);
 }
 
 /**
- * Get the name of the day
- * - Returns the English name of the day
- *
- * - Use the output as label in combination with the functions
- *   text() and translate() for international day names
+ * Get the name of the day of the week
+ * - Returns the day name using Intl.DateTimeFormat
+ * - By default uses English locale, but locale can be specified
  *
- * e.g.
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
+ * @param {string} [locale='nl-NL'] - The locale to use for the day name
  *
- * setTranslations()
- * ...
+ * @param {Object} [options]
+ * @param {'narrow'|'short'|'long'} [options.weekday='long']
+ * @param {string} [options.timeZone] - Optional timezone
  *
- * text( getDayName( new Date() ) );
- *
- * --
- *
- * @param {Date|number} dateOrTimestamp
- *
- * @returns {string} name of the day (English)
+ * @returns {string} name of the day in the specified locale
  */
-export function getDayName(dateOrTimestamp) {
-	throw new Error('Not implemented yet');
-	// return DAY_NAME_LABELS_EN[toDate(dateOrTimestamp).getDay()];
+export function getDayName(dateOrTimestamp, locale = 'nl-NL',
+    options = { weekday: 'long' }) {
+
+  const date = toDate(dateOrTimestamp);
+
+  // Create formatter with provided locale and options
+  // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
+  const formatter = new Intl.DateTimeFormat(locale, {
+    weekday: options?.weekday || 'long',
+    ...(options?.timeZone ? { timeZone: options.timeZone } : {})
+  });
+
+  return formatter.format(date);
 }
 
 /**
  * Return the timestamp of the start of the day
  * - Midnight
  *
- * @param {Date|number} dateOrTimestamp
+ * @param {Date|number} [dateOrTimestamp]
  *
  * @returns {number} timestamp of start of the day (00:00:00:0000)
  */
@@ -292,7 +300,7 @@ export function getTimeAtStartOfDay(dateOrTimestamp) {
  * Return the timestamp of the end of the day
  * - Midnight - 1 millisecond
  *
- * @param {Date|number} dateOrTimestamp
+ * @param {Date|number} [dateOrTimestamp]
  *
  * @returns {number} timestamp of start of the day
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hkdigital/lib-sveltekit",
-	"version": "0.1.59",
+	"version": "0.1.60",
 	"author": {
 		"name": "HKdigital",
 		"url": "https://hkdigital.nl"