date-and-time 3.6.0 → 4.0.0

package/dist/plugin.d.ts

@@ -0,0 +1,180 @@
+/** @preserve Copyright (c) KNOWLEDGECODE - MIT License */
+type CompiledObject = string[];
+
+interface DateLike {
+    /**
+     * Returns the year of the date.
+     */
+    getFullYear(): number;
+    /**
+     * Returns the month of the date (0-11).
+     */
+    getMonth(): number;
+    /**
+     * Returns the day of the month (1-31).
+     */
+    getDate(): number;
+    /**
+     * Returns the hours of the date (0-23).
+     */
+    getHours(): number;
+    /**
+     * Returns the minutes of the date (0-59).
+     */
+    getMinutes(): number;
+    /**
+     * Returns the seconds of the date (0-59).
+     */
+    getSeconds(): number;
+    /**
+     * Returns the milliseconds of the date (0-999).
+     */
+    getMilliseconds(): number;
+    /**
+     * Returns the day of the week (0-6, where 0 is Sunday).
+     */
+    getDay(): number;
+    /**
+     * Returns the time value in milliseconds since the Unix epoch (January 1, 1970).
+     */
+    getTime(): number;
+    /**
+     * Returns the timezone offset in minutes from UTC.
+     */
+    getTimezoneOffset(): number;
+}
+
+interface LocaleOptions {
+    compiledObj: CompiledObject;
+    style: 'long' | 'short' | 'narrow';
+    case?: 'uppercase' | 'lowercase';
+}
+interface Locale {
+    getLocale: () => string;
+    getMonthList: (options: LocaleOptions) => string[];
+    getDayOfWeekList: (options: LocaleOptions) => string[];
+    getMeridiemList: (options: LocaleOptions) => string[];
+}
+
+interface Numeral {
+    encode: (str: string) => string;
+    decode: (str: string) => string;
+}
+
+interface TimeZone {
+    zone_name: string;
+    gmt_offset: number[];
+}
+
+interface FormatterPluginOptions {
+    /**
+     * The hour format to use for formatting.
+     * This is used when the hour is in 12-hour format.
+     * It can be 'h11' for 11-hour format or 'h12' for 12-hour format.
+     */
+    hour12: 'h11' | 'h12';
+    /**
+     * The hour format to use for formatting.
+     * This is used when the hour is in 24-hour format.
+     * It can be 'h23' for 23-hour format or 'h24' for 24-hour format.
+     */
+    hour24: 'h23' | 'h24';
+    /**
+     * The numeral system to use for formatting numbers.
+     * This is an object that provides methods to encode and decode numbers in the specified numeral system.
+     */
+    numeral: Numeral;
+    /**
+     * The calendar system to use for formatting dates.
+     * This can be 'buddhist' for Buddhist calendar or 'gregory' for Gregorian calendar.
+     */
+    calendar: 'buddhist' | 'gregory';
+    /**
+     * The time zone to use for formatting dates and times.
+     * This can be a specific time zone object or 'UTC' to use Coordinated Universal Time.
+     * If not specified, it defaults to undefined, which means the local time zone will be used.
+     */
+    timeZone: TimeZone | 'UTC' | undefined;
+    /**
+     * The locale to use for formatting dates and times.
+     * This is an object that provides methods to get localized month names, day names, and meridiems.
+     */
+    locale: Locale;
+}
+declare abstract class FormatterPlugin {
+    [key: string]: (d: DateLike, options: FormatterPluginOptions, compiledObj: CompiledObject) => string;
+}
+
+type ParserToken = 'Y' | 'M' | 'D' | 'H' | 'A' | 'h' | 'm' | 's' | 'S' | 'Z';
+interface ParserPluginOptions {
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 12-hour format.
+     * It can be 'h11' for 11-hour format or 'h12' for 12-hour format.
+     */
+    hour12: 'h11' | 'h12';
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 24-hour format.
+     * It can be 'h23' for 23-hour format or 'h24' for 24-hour format.
+     */
+    hour24: 'h23' | 'h24';
+    /**
+     * The numeral system to use for parsing numbers.
+     * This is an object that provides methods to encode and decode numbers in the specified numeral system.
+     */
+    numeral: Numeral;
+    /**
+     * The calendar system to use for parsing dates.
+     * This can be 'buddhist' for Buddhist calendar or 'gregory' for Gregorian calendar.
+     */
+    calendar: 'buddhist' | 'gregory';
+    /**
+     * Whether to ignore case when matching strings.
+     * This is useful for matching month names, day names, and meridiems in a case-insensitive manner.
+     * If true, the parser will convert both the input string and the strings in the locale to lowercase before matching.
+     */
+    ignoreCase: boolean;
+    /**
+     * The time zone to use for parsing dates and times.
+     * This can be a specific time zone object or 'UTC' to use Coordinated Universal Time.
+     * If not specified, it defaults to undefined, which means the local time zone will be used.
+     */
+    timeZone: TimeZone | 'UTC' | undefined;
+    /**
+     * The locale to use for parsing dates and times.
+     * This is an object that provides methods to get localized month names, day names, and meridiems.
+     */
+    locale: Locale;
+}
+interface ParseResult {
+    value: number;
+    length: number;
+    token?: ParserToken;
+}
+declare abstract class ParserPlugin {
+    [key: string]: (str: string, options: ParserPluginOptions, compiledObj: CompiledObject) => ParseResult;
+}
+/**
+ * Executes a regular expression against a string and returns parsed result.
+ * @param re - The regular expression to execute
+ * @param str - The string to execute the regex against
+ * @param [token] - Optional parser token to associate with the result
+ * @returns ParseResult containing the numeric value, length, and token
+ */
+declare const exec: (re: RegExp, str: string, token?: ParserToken) => {
+    value: number;
+    length: number;
+    token: ParserToken | undefined;
+};
+/**
+ * Finds the best matching string from an array based on length and string position.
+ * @param array - Array of strings to search through
+ * @param str - The string to match against
+ * @param [token] - Optional parser token to associate with the result
+ * @returns ParseResult with the index of the longest matching string at the start position
+ */
+declare const find: (array: string[], str: string, token?: ParserToken) => ParseResult;
+
+export { FormatterPlugin, ParserPlugin, exec, find };
+export type { CompiledObject, DateLike, FormatterPluginOptions, Locale, Numeral, ParseResult, ParserPluginOptions, TimeZone };

package/dist/plugin.js

@@ -0,0 +1 @@
+class e{}class n{}const t=(e,n,t)=>{const l=e.exec(n)?.[0]||"";return{value:+l,length:l.length,token:t}},l=(e,n,t)=>e.reduce((e,l,g)=>l.length>e.length&&!n.indexOf(l)?{value:g,length:l.length,token:t}:e,{value:-1,length:0,token:t});export{e as FormatterPlugin,n as ParserPlugin,t as exec,l as find};

package/dist/plugins/day-of-week.cjs

@@ -0,0 +1 @@
+"use strict";class e{}const o=(e,o,t)=>e.reduce((e,l,a)=>l.length>e.length&&!o.indexOf(l)?{value:a,length:l.length,token:t}:e,{value:-1,length:0,token:t});const t=new class extends e{dddd(e,t,l){const a=t.locale.getDayOfWeekList({style:"long",compiledObj:l}),s=t.locale.getLocale();return t.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(s)),e.toLocaleLowerCase(s)):o(a,e)}ddd(e,t,l){const a=t.locale.getDayOfWeekList({style:"short",compiledObj:l}),s=t.locale.getLocale();return t.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(s)),e.toLocaleLowerCase(s)):o(a,e)}dd(e,t,l){const a=t.locale.getDayOfWeekList({style:"narrow",compiledObj:l}),s=t.locale.getLocale();return t.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(s)),e.toLocaleLowerCase(s)):o(a,e)}};exports.parser=t;

package/dist/plugins/day-of-week.d.ts

@@ -0,0 +1,84 @@
+/** @preserve Copyright (c) KNOWLEDGECODE - MIT License */
+type CompiledObject = string[];
+
+interface LocaleOptions {
+    compiledObj: CompiledObject;
+    style: 'long' | 'short' | 'narrow';
+    case?: 'uppercase' | 'lowercase';
+}
+interface Locale {
+    getLocale: () => string;
+    getMonthList: (options: LocaleOptions) => string[];
+    getDayOfWeekList: (options: LocaleOptions) => string[];
+    getMeridiemList: (options: LocaleOptions) => string[];
+}
+
+interface Numeral {
+    encode: (str: string) => string;
+    decode: (str: string) => string;
+}
+
+interface TimeZone {
+    zone_name: string;
+    gmt_offset: number[];
+}
+
+type ParserToken = 'Y' | 'M' | 'D' | 'H' | 'A' | 'h' | 'm' | 's' | 'S' | 'Z';
+interface ParserPluginOptions {
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 12-hour format.
+     * It can be 'h11' for 11-hour format or 'h12' for 12-hour format.
+     */
+    hour12: 'h11' | 'h12';
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 24-hour format.
+     * It can be 'h23' for 23-hour format or 'h24' for 24-hour format.
+     */
+    hour24: 'h23' | 'h24';
+    /**
+     * The numeral system to use for parsing numbers.
+     * This is an object that provides methods to encode and decode numbers in the specified numeral system.
+     */
+    numeral: Numeral;
+    /**
+     * The calendar system to use for parsing dates.
+     * This can be 'buddhist' for Buddhist calendar or 'gregory' for Gregorian calendar.
+     */
+    calendar: 'buddhist' | 'gregory';
+    /**
+     * Whether to ignore case when matching strings.
+     * This is useful for matching month names, day names, and meridiems in a case-insensitive manner.
+     * If true, the parser will convert both the input string and the strings in the locale to lowercase before matching.
+     */
+    ignoreCase: boolean;
+    /**
+     * The time zone to use for parsing dates and times.
+     * This can be a specific time zone object or 'UTC' to use Coordinated Universal Time.
+     * If not specified, it defaults to undefined, which means the local time zone will be used.
+     */
+    timeZone: TimeZone | 'UTC' | undefined;
+    /**
+     * The locale to use for parsing dates and times.
+     * This is an object that provides methods to get localized month names, day names, and meridiems.
+     */
+    locale: Locale;
+}
+interface ParseResult {
+    value: number;
+    length: number;
+    token?: ParserToken;
+}
+declare abstract class ParserPlugin {
+    [key: string]: (str: string, options: ParserPluginOptions, compiledObj: CompiledObject) => ParseResult;
+}
+
+declare class Parser extends ParserPlugin {
+    dddd(str: string, options: ParserPluginOptions, compiledObj: CompiledObject): ParseResult;
+    ddd(str: string, options: ParserPluginOptions, compiledObj: CompiledObject): ParseResult;
+    dd(str: string, options: ParserPluginOptions, compiledObj: CompiledObject): ParseResult;
+}
+declare const parser: Parser;
+
+export { parser };

package/dist/plugins/day-of-week.js

@@ -0,0 +1 @@
+class e{}const o=(e,o,l)=>e.reduce((e,t,a)=>t.length>e.length&&!o.indexOf(t)?{value:a,length:t.length,token:l}:e,{value:-1,length:0,token:l});const l=new class extends e{dddd(e,l,t){const a=l.locale.getDayOfWeekList({style:"long",compiledObj:t}),c=l.locale.getLocale();return l.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(c)),e.toLocaleLowerCase(c)):o(a,e)}ddd(e,l,t){const a=l.locale.getDayOfWeekList({style:"short",compiledObj:t}),c=l.locale.getLocale();return l.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(c)),e.toLocaleLowerCase(c)):o(a,e)}dd(e,l,t){const a=l.locale.getDayOfWeekList({style:"narrow",compiledObj:t}),c=l.locale.getLocale();return l.ignoreCase?o(a.map(e=>e.toLocaleLowerCase(c)),e.toLocaleLowerCase(c)):o(a,e)}};export{l as parser};

package/dist/plugins/microsecond.cjs

@@ -0,0 +1 @@
+"use strict";class e{}const t=(e,t,n)=>{const r=e.exec(t)?.[0]||"";return{value:+r,length:r.length,token:n}};const n=new class extends e{SSSS(e){const n=t(/^\d{1,4}/,e,"S");return n.value=Math.trunc(n.value/10),n}SSSSS(e){const n=t(/^\d{1,5}/,e,"S");return n.value=Math.trunc(n.value/100),n}SSSSSS(e){const n=t(/^\d{1,6}/,e,"S");return n.value=Math.trunc(n.value/1e3),n}f(e){return t(/^\d/,e)}ff(e){return t(/^\d\d?/,e)}fff(e){return t(/^\d{1,3}/,e)}};exports.parser=n;

package/dist/plugins/microsecond.d.ts

@@ -0,0 +1,111 @@
+/** @preserve Copyright (c) KNOWLEDGECODE - MIT License */
+type CompiledObject = string[];
+
+interface LocaleOptions {
+    compiledObj: CompiledObject;
+    style: 'long' | 'short' | 'narrow';
+    case?: 'uppercase' | 'lowercase';
+}
+interface Locale {
+    getLocale: () => string;
+    getMonthList: (options: LocaleOptions) => string[];
+    getDayOfWeekList: (options: LocaleOptions) => string[];
+    getMeridiemList: (options: LocaleOptions) => string[];
+}
+
+interface Numeral {
+    encode: (str: string) => string;
+    decode: (str: string) => string;
+}
+
+interface TimeZone {
+    zone_name: string;
+    gmt_offset: number[];
+}
+
+type ParserToken = 'Y' | 'M' | 'D' | 'H' | 'A' | 'h' | 'm' | 's' | 'S' | 'Z';
+interface ParserPluginOptions {
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 12-hour format.
+     * It can be 'h11' for 11-hour format or 'h12' for 12-hour format.
+     */
+    hour12: 'h11' | 'h12';
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 24-hour format.
+     * It can be 'h23' for 23-hour format or 'h24' for 24-hour format.
+     */
+    hour24: 'h23' | 'h24';
+    /**
+     * The numeral system to use for parsing numbers.
+     * This is an object that provides methods to encode and decode numbers in the specified numeral system.
+     */
+    numeral: Numeral;
+    /**
+     * The calendar system to use for parsing dates.
+     * This can be 'buddhist' for Buddhist calendar or 'gregory' for Gregorian calendar.
+     */
+    calendar: 'buddhist' | 'gregory';
+    /**
+     * Whether to ignore case when matching strings.
+     * This is useful for matching month names, day names, and meridiems in a case-insensitive manner.
+     * If true, the parser will convert both the input string and the strings in the locale to lowercase before matching.
+     */
+    ignoreCase: boolean;
+    /**
+     * The time zone to use for parsing dates and times.
+     * This can be a specific time zone object or 'UTC' to use Coordinated Universal Time.
+     * If not specified, it defaults to undefined, which means the local time zone will be used.
+     */
+    timeZone: TimeZone | 'UTC' | undefined;
+    /**
+     * The locale to use for parsing dates and times.
+     * This is an object that provides methods to get localized month names, day names, and meridiems.
+     */
+    locale: Locale;
+}
+interface ParseResult {
+    value: number;
+    length: number;
+    token?: ParserToken;
+}
+declare abstract class ParserPlugin {
+    [key: string]: (str: string, options: ParserPluginOptions, compiledObj: CompiledObject) => ParseResult;
+}
+
+declare class Parser extends ParserPlugin {
+    SSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    SSSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    SSSSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    f(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    ff(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    fff(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+}
+declare const parser: Parser;
+
+export { parser };

package/dist/plugins/microsecond.js

@@ -0,0 +1 @@
+class e{}const t=(e,t,n)=>{const r=e.exec(t)?.[0]||"";return{value:+r,length:r.length,token:n}};const n=new class extends e{SSSS(e){const n=t(/^\d{1,4}/,e,"S");return n.value=Math.trunc(n.value/10),n}SSSSS(e){const n=t(/^\d{1,5}/,e,"S");return n.value=Math.trunc(n.value/100),n}SSSSSS(e){const n=t(/^\d{1,6}/,e,"S");return n.value=Math.trunc(n.value/1e3),n}f(e){return t(/^\d/,e)}ff(e){return t(/^\d\d?/,e)}fff(e){return t(/^\d{1,3}/,e)}};export{n as parser};

package/dist/plugins/nanosecond.cjs

@@ -0,0 +1 @@
+"use strict";class e{}const S=(e,S,t)=>{const n=e.exec(S)?.[0]||"";return{value:+n,length:n.length,token:t}};const t=new class extends e{SSSSSSS(e){const t=S(/^\d{1,7}/,e,"S");return t.value=Math.trunc(t.value/1e4),t}SSSSSSSS(e){const t=S(/^\d{1,8}/,e,"S");return t.value=Math.trunc(t.value/1e5),t}SSSSSSSSS(e){const t=S(/^\d{1,9}/,e,"S");return t.value=Math.trunc(t.value/1e6),t}F(e){return S(/^\d/,e)}FF(e){return S(/^\d\d?/,e)}FFF(e){return S(/^\d{1,3}/,e)}};exports.parser=t;

package/dist/plugins/nanosecond.d.ts

@@ -0,0 +1,111 @@
+/** @preserve Copyright (c) KNOWLEDGECODE - MIT License */
+type CompiledObject = string[];
+
+interface LocaleOptions {
+    compiledObj: CompiledObject;
+    style: 'long' | 'short' | 'narrow';
+    case?: 'uppercase' | 'lowercase';
+}
+interface Locale {
+    getLocale: () => string;
+    getMonthList: (options: LocaleOptions) => string[];
+    getDayOfWeekList: (options: LocaleOptions) => string[];
+    getMeridiemList: (options: LocaleOptions) => string[];
+}
+
+interface Numeral {
+    encode: (str: string) => string;
+    decode: (str: string) => string;
+}
+
+interface TimeZone {
+    zone_name: string;
+    gmt_offset: number[];
+}
+
+type ParserToken = 'Y' | 'M' | 'D' | 'H' | 'A' | 'h' | 'm' | 's' | 'S' | 'Z';
+interface ParserPluginOptions {
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 12-hour format.
+     * It can be 'h11' for 11-hour format or 'h12' for 12-hour format.
+     */
+    hour12: 'h11' | 'h12';
+    /**
+     * The hour format to use for parsing.
+     * This is used when the hour is in 24-hour format.
+     * It can be 'h23' for 23-hour format or 'h24' for 24-hour format.
+     */
+    hour24: 'h23' | 'h24';
+    /**
+     * The numeral system to use for parsing numbers.
+     * This is an object that provides methods to encode and decode numbers in the specified numeral system.
+     */
+    numeral: Numeral;
+    /**
+     * The calendar system to use for parsing dates.
+     * This can be 'buddhist' for Buddhist calendar or 'gregory' for Gregorian calendar.
+     */
+    calendar: 'buddhist' | 'gregory';
+    /**
+     * Whether to ignore case when matching strings.
+     * This is useful for matching month names, day names, and meridiems in a case-insensitive manner.
+     * If true, the parser will convert both the input string and the strings in the locale to lowercase before matching.
+     */
+    ignoreCase: boolean;
+    /**
+     * The time zone to use for parsing dates and times.
+     * This can be a specific time zone object or 'UTC' to use Coordinated Universal Time.
+     * If not specified, it defaults to undefined, which means the local time zone will be used.
+     */
+    timeZone: TimeZone | 'UTC' | undefined;
+    /**
+     * The locale to use for parsing dates and times.
+     * This is an object that provides methods to get localized month names, day names, and meridiems.
+     */
+    locale: Locale;
+}
+interface ParseResult {
+    value: number;
+    length: number;
+    token?: ParserToken;
+}
+declare abstract class ParserPlugin {
+    [key: string]: (str: string, options: ParserPluginOptions, compiledObj: CompiledObject) => ParseResult;
+}
+
+declare class Parser extends ParserPlugin {
+    SSSSSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    SSSSSSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    SSSSSSSSS(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    F(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    FF(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+    FFF(str: string): {
+        value: number;
+        length: number;
+        token: ("Y" | "M" | "D" | "H" | "A" | "h" | "m" | "s" | "S" | "Z") | undefined;
+    };
+}
+declare const parser: Parser;
+
+export { parser };

package/dist/plugins/nanosecond.js

@@ -0,0 +1 @@
+class S{}const e=(S,e,t)=>{const n=S.exec(e)?.[0]||"";return{value:+n,length:n.length,token:t}};const t=new class extends S{SSSSSSS(S){const t=e(/^\d{1,7}/,S,"S");return t.value=Math.trunc(t.value/1e4),t}SSSSSSSS(S){const t=e(/^\d{1,8}/,S,"S");return t.value=Math.trunc(t.value/1e5),t}SSSSSSSSS(S){const t=e(/^\d{1,9}/,S,"S");return t.value=Math.trunc(t.value/1e6),t}F(S){return e(/^\d/,S)}FF(S){return e(/^\d\d?/,S)}FFF(S){return e(/^\d{1,3}/,S)}};export{t as parser};

package/dist/plugins/ordinal.cjs

@@ -0,0 +1 @@
+"use strict";class e{}class t{}const s=new class extends e{DDD(e){const t=e.getDate();switch(t){case 1:case 21:case 31:return`${t}st`;case 2:case 22:return`${t}nd`;case 3:case 23:return`${t}rd`;default:return`${t}th`}}},r=new class extends t{DDD(e,t){const s=((e,t,s)=>{const r=e.exec(t)?.[0]||"";return{value:+r,length:r.length,token:s}})(/^\d\d?(?=st|nd|rd|th)/,t.ignoreCase?e.toLowerCase():e,"D");return s.length>0&&(s.length+=2),s}};exports.formatter=s,exports.parser=r;