@js-joda/core 5.5.2 → 5.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@js-joda/core",
-  "version": "5.5.2",
+  "version": "5.6.0",
   "description": "a date and time library for javascript",
   "repository": {
     "type": "git",
@@ -48,5 +48,5 @@
     "sourceMap": false,
     "instrument": false
   },
-  "gitHead": "8d78c174b570252ae707da314a444e2a9bd1f3fa"
+  "gitHead": "e78db48870eddc16cc35f81cee07f99918d7bf8f"
 }

package/src/format/DateTimeFormatterBuilder.js

@@ -174,6 +174,39 @@ export class DateTimeFormatterBuilder {
         return this;
     }
 
+    /**
+     * Appends a default value for a field to the formatter for use in parsing.
+     * <p>
+     * This appends an instruction to the builder to inject a default value
+     * into the parsed result. This is especially useful in conjunction with
+     * optional parts of the formatter.
+     * <p>
+     * For example, consider a formatter that parses the year, followed by
+     * an optional month, with a further optional day-of-month. Using such a
+     * formatter would require the calling code to check whether a full date,
+     * year-month or just a year had been parsed. This method can be used to
+     * default the month and day-of-month to a sensible value, such as the
+     * first of the month, allowing the calling code to always get a date.
+     * <p>
+     * During formatting, this method has no effect.
+     * <p>
+     * During parsing, the current state of the parse is inspected.
+     * If the specified field has no associated value, because it has not been
+     * parsed successfully at that point, then the specified value is injected
+     * into the parse result. Injection is immediate, thus the field-value pair
+     * will be visible to any subsequent elements in the formatter.
+     * As such, this method is normally called at the end of the builder.
+     *
+     * @param {TemporalField} field  the field to default the value of, not null
+     * @param {number} value  the value to default the field to
+     * @return {DateTimeFormatterBuilder} this, for chaining, not null
+     */
+    parseDefaulting(field, value) {
+        requireNonNull(field);
+        this._appendInternal(new DefaultingParser(field, value));
+        return this;
+    }
+
     /**
      * appendValue function overloading
      */
@@ -1527,6 +1560,44 @@ class InstantPrinterParser  {
     }
 }
 
+/**
+ * Used by parseDefaulting().
+ * @implements {DateTimePrinterParser}
+ * @private
+ */
+class DefaultingParser {
+    /**
+     * @param {TemporalField} field 
+     * @param {number} value 
+     */
+    constructor(field, value) {
+        this._field = field;
+        this._value = value;
+    }
+
+    /**
+     * @param {DateTimePrintContext} context
+     * @param {StringBuilder} buf
+     * @return {boolean}
+     */
+    print() {
+        return true;
+    }
+
+
+    /** 
+     * @param {DateTimeParseContext} context 
+     * @param {string} text
+     * @param {number} position 
+     * @returns {number}
+     */
+    parse(context, text, position) {
+        if (context.getParsed(this._field) == null) {
+            context.setParsedField(this._field, this._value, position, position);
+        }
+        return position;
+    }
+}
 
 export function _init() {
     ReducedPrinterParser.BASE_DATE = LocalDate.of(2000, 1, 1);

package/typings/js-joda.d.ts

@@ -2162,6 +2162,14 @@ export class DateTimeFormatter {
     static ISO_OFFSET_DATE_TIME: DateTimeFormatter;
     static ISO_OFFSET_TIME: DateTimeFormatter;
     static ISO_ZONED_DATE_TIME: DateTimeFormatter;
+    static BASIC_ISO_DATE: DateTimeFormatter;
+    static ISO_OFFSET_DATE: DateTimeFormatter;
+    static ISO_OFFSET_TIME: DateTimeFormatter;
+    static ISO_ORDINAL_DATE: DateTimeFormatter;
+    static ISO_WEEK_DATE: DateTimeFormatter;
+    static ISO_DATE: DateTimeFormatter;
+    static ISO_TIME: DateTimeFormatter;
+    static ISO_DATE_TIME: DateTimeFormatter;
 
     static ofPattern(pattern: string): DateTimeFormatter;
     static parsedExcessDays(): TemporalQuery<Period>;
@@ -2185,7 +2193,7 @@ export class DateTimeFormatterBuilder {
 
     append(formatter: DateTimeFormatter): DateTimeFormatterBuilder;
     appendFraction(field: TemporalField, minWidth: number, maxWidth: number, decimalPoint: boolean): DateTimeFormatterBuilder;
-    appendInstant(fractionalDigits: number): DateTimeFormatterBuilder;
+    appendInstant(fractionalDigits?: number): DateTimeFormatterBuilder;
     appendLiteral(literal: any): DateTimeFormatterBuilder;
     appendOffset(pattern: string, noOffsetText: string): DateTimeFormatterBuilder;
     appendOffsetId(): DateTimeFormatterBuilder;
@@ -2198,6 +2206,7 @@ export class DateTimeFormatterBuilder {
     padNext(): DateTimeFormatterBuilder;
     parseCaseInsensitive(): DateTimeFormatterBuilder;
     parseCaseSensitive(): DateTimeFormatterBuilder;
+    parseDefaulting(field: TemporalField, value: number): DateTimeFormatterBuilder;
     parseLenient(): DateTimeFormatterBuilder;
     parseStrict(): DateTimeFormatterBuilder;
     toFormatter(resolverStyle?: ResolverStyle): DateTimeFormatter;

package/typings/js-joda.flow.js

@@ -211,6 +211,7 @@ declare module "js-joda" {
         padNext(): DateTimeFormatterBuilder;
         parseCaseInsensitive(): DateTimeFormatterBuilder;
         parseCaseSensitive(): DateTimeFormatterBuilder;
+        parseDefaulting(field: TemporalField, value: number): DateTimeFormatterBuilder;
         parseLenient(): DateTimeFormatterBuilder;
         parseStrict(): DateTimeFormatterBuilder;
         toFormatter(resolverStyle: ResolverStyle): DateTimeFormatter