@libchrono/time 1.0.0 → 1.1.0

package/README.md

@@ -77,6 +77,13 @@ console.log(getMeridiemComponents('11:45 PM')); // Output: { hour: 11, minute: 4
 console.log(getMilitaryComponents('23:45')); // Output: { hour: 23, minute: 45 }
 ```
 
+### Get times labels in military format
+
+```ts
+console.log(getMilitaryTimes('00:00', '23:59', 10)) // Output: ['00:00', '00:10', '00:20', ... '23:50']
+console.log(getMeridiemTimes('08:30 AM', '12:00 PM', 30)) // Output: ['08:30 AM', '09:00 AM', '09:30 AM', ..., '12:00 PM']
+```
+
 [Full documentation](./docs/globals.md)
 
 ## 🛠️ Why Use @libchrono/time

package/dist/generators.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generates a list of times using **24-hour (military) format**.
+ *
+ * Example:
+ * ```ts
+ * getMilitaryTimes('08:00', '12:00', 30);
+ * // → ['08:00', '08:30', '09:00', ...]
+ * ```
+ *
+ * @param startStr - Start time in `HH:mm` format
+ * @param endStr - End time in `HH:mm` format
+ * @param interval - Minute interval (default: 30)
+ * @returns An array of formatted time strings
+ */
+export declare const getMilitaryTimes: (startStr: string, endStr: string, interval?: number) => string[];
+/**
+ * Generates a list of times using **12-hour (meridiem) format** input.
+ *
+ * Example:
+ * ```ts
+ * getMeridiemTimes('8:00 AM', '12:00 PM', 15);
+ * // → ['08:00 AM', '08:30 AM', '09:00 AM', ..., '12:00 PM']
+ * ```
+ *
+ * Internally, times are converted to military components before processing.
+ *
+ * @param startStr - Start time in meridiem format (e.g. `8:00 AM`)
+ * @param endStr - End time in meridiem format (e.g. `12:00 PM`)
+ * @param interval - Minute interval (default: 30)
+ * @returns An array of formatted time strings in `HH:mm`
+ */
+export declare const getMeridiemTimes: (startStr: string, endStr: string, interval?: number) => string[];

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from "./type/military-time-components";
 export * from "./checkers";
 export * from "./converters";
 export * from "./extractors";
+export * from "./generators";

package/dist/index.js

@@ -1 +1 @@
-!function(e,i){"object"===typeof exports&&"object"===typeof module?module.exports=i():"function"===typeof define&&define.amd?define([],i):"object"===typeof exports?exports["libchrono-time"]=i():e["libchrono-time"]=i()}(this,(()=>(()=>{"use strict";var e={721:(e,i,r)=>{Object.defineProperty(i,"__esModule",{value:!0}),i.isPMPeriodStr=i.isPostNoonPeriodStr=i.isAMPeriodStr=i.isPreNoonPeriodStr=i.isMeridiemFormat=i.isMilitaryFormat=void 0;const o=r(239);i.isMilitaryFormat=e=>o.MilitaryTimeRegex.test(e);i.isMeridiemFormat=e=>o.MeridiemTimeRegex.test(e);i.isPreNoonPeriodStr=e=>o.AMPeriodRegex.test(e),i.isAMPeriodStr=i.isPreNoonPeriodStr;i.isPostNoonPeriodStr=e=>o.PMPeriodRegex.test(e),i.isPMPeriodStr=i.isPostNoonPeriodStr},704:(e,i,r)=>{Object.defineProperty(i,"__esModule",{value:!0}),i.toMeridiem=i.convert24To12=i.convertMilitaryToCivil=i.convertMilitaryToMeridiem=i.toMilitary=i.convert12To24=i.convertCivilToMilitary=i.convertMeridiemToMilitary=void 0;const o=r(721),t=r(492),n=r(552),d=r(550);i.convertMeridiemToMilitary=e=>{if(!(0,o.isMeridiemFormat)(e))throw new Error(`Provided invalid format to convert: ${e}`);const i=(0,t.getMeridiemComponents)(e),r=(e=>e.hour%12+(e.period===d.Meridiem.PM?12:0))(i);return m=r,M=i.minute,`${(0,n.padTimeNumber)(m)}:${(0,n.padTimeNumber)(M)}`;var m,M},i.convertCivilToMilitary=i.convertMeridiemToMilitary,i.convert12To24=i.convertMeridiemToMilitary,i.toMilitary=i.convertMeridiemToMilitary;i.convertMilitaryToMeridiem=e=>{if(!(0,o.isMilitaryFormat)(e))throw new Error(`Provided invalid format to convert: ${e}`);const i=(0,t.getMilitaryComponents)(e),r=i.hour%12||12,m=i.hour>=12?d.Meridiem.PM:d.Meridiem.AM;return((e,i,r)=>`${(0,n.padTimeNumber)(e)}:${(0,n.padTimeNumber)(i)} ${r}`)(r,i.minute,m)},i.convertMilitaryToCivil=i.convertMilitaryToMeridiem,i.convert24To12=i.convertMilitaryToMeridiem,i.toMeridiem=i.convertMilitaryToMeridiem},492:(e,i,r)=>{Object.defineProperty(i,"__esModule",{value:!0}),i.getMeridiemComponents=i.getMilitaryComponents=void 0;const o=r(721),t=r(239),n=r(550),d=r(707),m=e=>(0,o.isPreNoonPeriodStr)(e)?n.Meridiem.AM:n.Meridiem.PM;i.getMilitaryComponents=e=>{const i=e.match(t.MilitaryTimeRegex);if(null===i)throw new Error(`Provided invalid time value: ${e}`);return{[d.TimeComponent.Hour]:parseInt(i[1],10),[d.TimeComponent.Minute]:parseInt(i[2],10)}};i.getMeridiemComponents=e=>{const i=e.match(t.MeridiemTimeRegex);if(null===i)throw new Error(`Provided invalid time value: ${e}`);return{[d.TimeComponent.Hour]:parseInt(i[1],10),[d.TimeComponent.Minute]:parseInt(i[2],10),[d.TimeComponent.Period]:m(i[3])}}},729:function(e,i,r){var o=this&&this.__createBinding||(Object.create?function(e,i,r,o){void 0===o&&(o=r);var t=Object.getOwnPropertyDescriptor(i,r);t&&!("get"in t?!i.__esModule:t.writable||t.configurable)||(t={enumerable:!0,get:function(){return i[r]}}),Object.defineProperty(e,o,t)}:function(e,i,r,o){void 0===o&&(o=r),e[o]=i[r]}),t=this&&this.__exportStar||function(e,i){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(i,r)||o(i,e,r)};Object.defineProperty(i,"__esModule",{value:!0}),t(r(550),i),t(r(707),i),t(r(51),i),t(r(542),i),t(r(721),i),t(r(704),i),t(r(492),i)},239:(e,i)=>{Object.defineProperty(i,"__esModule",{value:!0}),i.PMPeriodRegex=i.AMPeriodRegex=i.MeridiemTimeRegex=i.MilitaryTimeRegex=void 0,i.MilitaryTimeRegex=/^([01]?\d|2[0-3])\D?([0-5][0-9])$/,i.MeridiemTimeRegex=/^(0?[1-9]|1[0-2]):([0-5][0-9])\s?(am|pm|a\.m\.|p\.m\.|a\.m|p\.m|a m|p m)$/i,i.AMPeriodRegex=/\bam|\ba\.m\.|\ba\.m\b/i,i.PMPeriodRegex=/\bpm|\bp\.m\.|\bp\.m\b/i},550:(e,i)=>{var r,o,t,n;Object.defineProperty(i,"__esModule",{value:!0}),i.CivilianTimePeriod=i.TimeOfDay=i.DayPeriod=i.Meridiem=void 0,function(e){e.AM="AM",e.PM="PM"}(r||(i.Meridiem=r={})),function(e){e.AM="AM",e.PM="PM"}(o||(i.DayPeriod=o={})),function(e){e.AM="AM",e.PM="PM"}(t||(i.TimeOfDay=t={})),function(e){e.AM="AM",e.PM="PM"}(n||(i.CivilianTimePeriod=n={}));o.AM},707:(e,i)=>{var r;Object.defineProperty(i,"__esModule",{value:!0}),i.TimeComponent=void 0,function(e){e.Hour="hour",e.Minute="minute",e.Period="period"}(r||(i.TimeComponent=r={}))},51:(e,i,r)=>{Object.defineProperty(i,"__esModule",{value:!0});r(707)},542:(e,i,r)=>{Object.defineProperty(i,"__esModule",{value:!0});r(707)},552:(e,i)=>{Object.defineProperty(i,"__esModule",{value:!0}),i.padTimeNumber=void 0;i.padTimeNumber=e=>{if(e<0)throw new Error("Time number cant be negative");if(e>59)throw new Error("Time number cant be higher then 59");return e<10?`0${e}`:`${e}`}}},i={};var r=function r(o){var t=i[o];if(void 0!==t)return t.exports;var n=i[o]={exports:{}};return e[o].call(n.exports,n,n.exports,r),n.exports}(729);return r})()));
+!function(e,i){"object"===typeof exports&&"object"===typeof module?module.exports=i():"function"===typeof define&&define.amd?define([],i):"object"===typeof exports?exports["libchrono-time"]=i():e["libchrono-time"]=i()}(this,()=>(()=>{"use strict";var e={51(e,i,r){Object.defineProperty(i,"__esModule",{value:!0});r(707)},63(e,i,r){Object.defineProperty(i,"__esModule",{value:!0}),i.getMeridiemTimes=i.getMilitaryTimes=void 0;const o=r(707),t=r(492),n=r(704),m=r(552),d=(e,i)=>{let r=e[o.TimeComponent.Minute];return i<e[o.TimeComponent.Hour]&&(r=60),0===r&&(r=1),r},M=(e,i)=>{let r=e[o.TimeComponent.Minute];return i!==e[o.TimeComponent.Hour]&&(r=0),r};i.getMilitaryTimes=(e,i,r=30)=>((e,i,r)=>{const t=[];for(let n=e[o.TimeComponent.Hour];n<=i[o.TimeComponent.Hour];n++){const o=(0,m.padTimeNumber)(n),a=M(e,n),l=d(i,n);for(let e=a;e<l;e+=r){const i=`${o}:${(0,m.padTimeNumber)(e)}`;t.push(i)}}return t})((0,t.getMilitaryComponents)(e),(0,t.getMilitaryComponents)(i),r);i.getMeridiemTimes=(e,r,o=30)=>{const t=(0,n.convertMeridiemToMilitary)(e),m=(0,n.convertMeridiemToMilitary)(r);return(0,i.getMilitaryTimes)(t,m,o).map(n.convertMilitaryToMeridiem)}},239(e,i){Object.defineProperty(i,"__esModule",{value:!0}),i.PMPeriodRegex=i.AMPeriodRegex=i.MeridiemTimeRegex=i.MilitaryTimeRegex=void 0,i.MilitaryTimeRegex=/^([01]?\d|2[0-3])\D?([0-5][0-9])$/,i.MeridiemTimeRegex=/^(0?[1-9]|1[0-2]):([0-5][0-9])\s?(am|pm|a\.m\.|p\.m\.|a\.m|p\.m|a m|p m)$/i,i.AMPeriodRegex=/\bam|\ba\.m\.|\ba\.m\b/i,i.PMPeriodRegex=/\bpm|\bp\.m\.|\bp\.m\b/i},492(e,i,r){Object.defineProperty(i,"__esModule",{value:!0}),i.getMeridiemComponents=i.getMilitaryComponents=void 0;const o=r(721),t=r(239),n=r(550),m=r(707),d=e=>(0,o.isPreNoonPeriodStr)(e)?n.Meridiem.AM:n.Meridiem.PM;i.getMilitaryComponents=e=>{const i=e.match(t.MilitaryTimeRegex);if(null===i)throw new Error(`Provided invalid time value: ${e}`);return{[m.TimeComponent.Hour]:parseInt(i[1],10),[m.TimeComponent.Minute]:parseInt(i[2],10)}};i.getMeridiemComponents=e=>{const i=e.match(t.MeridiemTimeRegex);if(null===i)throw new Error(`Provided invalid time value: ${e}`);return{[m.TimeComponent.Hour]:parseInt(i[1],10),[m.TimeComponent.Minute]:parseInt(i[2],10),[m.TimeComponent.Period]:d(i[3])}}},542(e,i,r){Object.defineProperty(i,"__esModule",{value:!0});r(707)},550(e,i){var r,o,t,n;Object.defineProperty(i,"__esModule",{value:!0}),i.CivilianTimePeriod=i.TimeOfDay=i.DayPeriod=i.Meridiem=void 0,function(e){e.AM="AM",e.PM="PM"}(r||(i.Meridiem=r={})),function(e){e.AM="AM",e.PM="PM"}(o||(i.DayPeriod=o={})),function(e){e.AM="AM",e.PM="PM"}(t||(i.TimeOfDay=t={})),function(e){e.AM="AM",e.PM="PM"}(n||(i.CivilianTimePeriod=n={}));o.AM},552(e,i){Object.defineProperty(i,"__esModule",{value:!0}),i.padTimeNumber=void 0;i.padTimeNumber=e=>{if(e<0)throw new Error("Time number cant be negative");if(e>59)throw new Error("Time number cant be higher then 59");return e<10?`0${e}`:`${e}`}},704(e,i,r){Object.defineProperty(i,"__esModule",{value:!0}),i.toMeridiem=i.convert24To12=i.convertMilitaryToCivil=i.convertMilitaryToMeridiem=i.toMilitary=i.convert12To24=i.convertCivilToMilitary=i.convertMeridiemToMilitary=void 0;const o=r(721),t=r(492),n=r(552),m=r(550);i.convertMeridiemToMilitary=e=>{if(!(0,o.isMeridiemFormat)(e))throw new Error(`Provided invalid format to convert: ${e}`);const i=(0,t.getMeridiemComponents)(e),r=(e=>e.hour%12+(e.period===m.Meridiem.PM?12:0))(i);return d=r,M=i.minute,`${(0,n.padTimeNumber)(d)}:${(0,n.padTimeNumber)(M)}`;var d,M},i.convertCivilToMilitary=i.convertMeridiemToMilitary,i.convert12To24=i.convertMeridiemToMilitary,i.toMilitary=i.convertMeridiemToMilitary;i.convertMilitaryToMeridiem=e=>{if(!(0,o.isMilitaryFormat)(e))throw new Error(`Provided invalid format to convert: ${e}`);const i=(0,t.getMilitaryComponents)(e),r=i.hour%12||12,d=i.hour>=12?m.Meridiem.PM:m.Meridiem.AM;return((e,i,r)=>`${(0,n.padTimeNumber)(e)}:${(0,n.padTimeNumber)(i)} ${r}`)(r,i.minute,d)},i.convertMilitaryToCivil=i.convertMilitaryToMeridiem,i.convert24To12=i.convertMilitaryToMeridiem,i.toMeridiem=i.convertMilitaryToMeridiem},707(e,i){var r;Object.defineProperty(i,"__esModule",{value:!0}),i.TimeComponent=void 0,function(e){e.Hour="hour",e.Minute="minute",e.Period="period"}(r||(i.TimeComponent=r={}))},721(e,i,r){Object.defineProperty(i,"__esModule",{value:!0}),i.isPMPeriodStr=i.isPostNoonPeriodStr=i.isAMPeriodStr=i.isPreNoonPeriodStr=i.isMeridiemFormat=i.isMilitaryFormat=void 0;const o=r(239);i.isMilitaryFormat=e=>o.MilitaryTimeRegex.test(e);i.isMeridiemFormat=e=>o.MeridiemTimeRegex.test(e);i.isPreNoonPeriodStr=e=>o.AMPeriodRegex.test(e),i.isAMPeriodStr=i.isPreNoonPeriodStr;i.isPostNoonPeriodStr=e=>o.PMPeriodRegex.test(e),i.isPMPeriodStr=i.isPostNoonPeriodStr},729(e,i,r){var o=this&&this.__createBinding||(Object.create?function(e,i,r,o){void 0===o&&(o=r);var t=Object.getOwnPropertyDescriptor(i,r);t&&!("get"in t?!i.__esModule:t.writable||t.configurable)||(t={enumerable:!0,get:function(){return i[r]}}),Object.defineProperty(e,o,t)}:function(e,i,r,o){void 0===o&&(o=r),e[o]=i[r]}),t=this&&this.__exportStar||function(e,i){for(var r in e)"default"===r||Object.prototype.hasOwnProperty.call(i,r)||o(i,e,r)};Object.defineProperty(i,"__esModule",{value:!0}),t(r(550),i),t(r(707),i),t(r(51),i),t(r(542),i),t(r(721),i),t(r(704),i),t(r(492),i),t(r(63),i)}},i={};var r=function r(o){var t=i[o];if(void 0!==t)return t.exports;var n=i[o]={exports:{}};return e[o].call(n.exports,n,n.exports,r),n.exports}(729);return r})());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libchrono/time",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Small library to handle time format conversion.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,38 +37,38 @@
   "scripts": {
     "build:lib": "webpack && tsc-alias -p tsconfig.json",
     "build:types": "tsc -p tsconfig.type.json && tsc-alias -p tsconfig.type.json",
-    "build:all": "yarn build:lib && yarn build:types",
+    "build:all": "bun run build:lib && bun run build:types",
     "test": "jest",
-    "coverage": "yarn test --coverage && make-coverage-badge",
-    "deploy": "yarn test && yarn build:all && npm publish",
-    "docs": "typedoc"
+    "coverage": "bun run test --coverage && bunx make-coverage-badge",
+    "deploy": "bun run test && bun run build:all && npm publish",
+    "docs": "typedoc ./src/index.ts"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.12.0",
-    "@typescript-eslint/eslint-plugin": "^8.22.0",
-    "@typescript-eslint/parser": "^8.22.0",
-    "eslint": "^9.19.0",
-    "eslint-config-love": "^118.0.0",
-    "eslint-config-prettier": "^10.0.1",
-    "eslint-import-resolver-typescript": "^3.7.0",
-    "eslint-plugin-check-file": "^2.8.0",
-    "eslint-plugin-import": "^2.31.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.4",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "eslint": "^9.39.2",
+    "eslint-config-love": "^144.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-check-file": "^3.3.1",
+    "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-max-params-no-constructor": "^0.0.4",
-    "eslint-webpack-plugin": "^4.2.0",
-    "jest": "^29.7.0",
+    "eslint-webpack-plugin": "^5.0.2",
+    "jest": "^30.2.0",
     "make-coverage-badge": "^1.2.0",
-    "prettier": "^3.4.2",
-    "terser-webpack-plugin": "^5.3.11",
-    "ts-jest": "^29.2.5",
-    "ts-loader": "^9.5.2",
+    "prettier": "^3.7.4",
+    "terser-webpack-plugin": "^5.3.16",
+    "ts-jest": "^29.4.6",
+    "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.10",
+    "tsc-alias": "^1.8.16",
     "tsconfig-paths-webpack-plugin": "^4.2.0",
-    "typedoc": "^0.27.6",
-    "typedoc-plugin-markdown": "^4.4.1",
-    "typescript": "^5.7.3",
-    "webpack": "^5.97.1",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.3",
+    "webpack": "^5.104.1",
     "webpack-cli": "^6.0.1"
   }
 }