LocalDateFormatter.java

/*

 * Copyright 2004 the original author or authors.

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *     http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */

package com.ancientprogramming.fixedformat4j.format.impl;

import com.ancientprogramming.fixedformat4j.exception.FixedFormatException;

import com.ancientprogramming.fixedformat4j.format.FormatInstructions;

import java.time.LocalDate;

import java.time.format.DateTimeFormatter;

import java.time.format.DateTimeParseException;

/**

 * Formatter for {@link java.time.LocalDate} data.

 * The formatting and parsing is performed using {@link DateTimeFormatter}.

 * The pattern is configured via {@link com.ancientprogramming.fixedformat4j.annotation.FixedFormatPattern}.

 * The default pattern is {@code yyyyMMdd}.

 *

 * @author Jacob von Eyben - <a href="https://eybenconsult.com">https://eybenconsult.com</a>

 * @since 1.4.0

 */

public class LocalDateFormatter extends AbstractPatternFormatter<LocalDate> {

  @Override

  protected int computeFormattedLengthForPattern(String pattern) {

    return formatterForPattern(pattern).format(LocalDate.of(1970, 1, 1)).length();

  }

  /** {@inheritDoc} */

  public LocalDate asObject(String string, FormatInstructions instructions) throws FixedFormatException {

    if (string == null || string.isEmpty()) {

      return null;

    }

    String pattern = instructions.getFixedFormatPatternData().getPattern();

    try {

      return LocalDate.parse(string, formatterForPattern(pattern));

    } catch (DateTimeParseException e) {

      throw new FixedFormatException(String.format("Could not parse value[%s] by pattern[%s] to %s", string, pattern, LocalDate.class.getName()), e);

    }

  }

  /** {@inheritDoc} */

  public String asString(LocalDate date, FormatInstructions instructions) {

    if (date == null) {

      return null;

    }

    return formatterForPattern(instructions.getFixedFormatPatternData().getPattern()).format(date);

  }

}

Active mutators

• CONDITIONALS_BOUNDARY
• CONSTRUCTOR_CALLS
• EMPTY_RETURNS
• EXPERIMENTAL_ARGUMENT_PROPAGATION
• EXPERIMENTAL_BIG_DECIMAL
• EXPERIMENTAL_BIG_INTEGER
• EXPERIMENTAL_MEMBER_VARIABLE
• EXPERIMENTAL_NAKED_RECEIVER
• EXPERIMENTAL_REMOVE_SWITCH_MUTATOR_[0-99]
• EXPERIMENTAL_SWITCH
• FALSE_RETURNS
• INCREMENTS
• INLINE_CONSTS
• INVERT_NEGS
• MATH
• NEGATE_CONDITIONALS
• NON_VOID_METHOD_CALLS
• NULL_RETURNS
• PRIMITIVE_RETURNS
• REMOVE_CONDITIONALS_EQUAL_ELSE
• REMOVE_CONDITIONALS_EQUAL_IF
• REMOVE_CONDITIONALS_ORDER_ELSE
• REMOVE_CONDITIONALS_ORDER_IF
• REMOVE_INCREMENTS
• TRUE_RETURNS
• VOID_METHOD_CALLS

Tests examined

• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:computeFormattedLengthForPattern_dashPattern_returnsTen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:computeFormattedLengthForPattern_compactPattern_returnsEight()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:computeFormattedLengthForPattern_yearOnly_returnsFour()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#2] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#5] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#4] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:localDateFormatTruncatesAndParseTooShortThrowsException(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#3] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#6] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestByTypeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestByTypeFormatter]/[method:testDispatchesToLocalDateFormatter()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testAllSpaceInputParsesToNull()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:allZeroFieldWithZeroPaddingParsesToNull()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidDateStringExceptionChainsDateTimeParseExceptionCause()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testParseDefaultPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:rightAlignedZeroPaddingRestoresLeadingZerosInDateComponents()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testLeapDay()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidDateStringThrowsFixedFormatException()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidDateStringExceptionContainsPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testParseAlternativePattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidDateStringExceptionContainsBadInput()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testParseWithDashSeparator()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testRightAlignedPaddingStrippedBeforeParse()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testEndOfYear()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:leftAlignedZeroPaddingDoesNotStripZeroValuedMonthOrDay()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testFirstDayOfYear()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testStarPaddingChar_rightAlign_roundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:zeroPaddingRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidMonthThrowsFixedFormatException()] (2 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testStarPaddingChar_leftAlign_roundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testInvalidDateStringExceptionContainsTypeName()] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:zeroPaddingRoundTrip_dateEndsInPaddingChar_dayTwenty()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:zeroPaddingRoundTrip_dateEndsInPaddingChar_dayTen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:parseIsThreadSafe()] (19 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#3] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#4] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#2] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#5] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#6] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#3] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#7] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#8] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:localDateFormatTruncatesAndParseTooShortThrowsException(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#2] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:localDateFormatTruncatesAndParseTooShortThrowsException(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#1] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDate(java.lang.String, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#1] (3 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDate, java.lang.String)]/[test-template-invocation:#1] (4 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl]/[method:testLocalDateNullRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration]/[method:roundTripPreservesAllFields()] (0 ms)
• com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration]/[method:loadsDateFieldsCorrectly()] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl]/[method:testLocalDateNoPatternAnnotationUsesIsoLocalDateDefault()] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl]/[method:testLocalDateRoundTrip()] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testNullFormatReturnsSpaces()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testFormatAlternativePattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testFormatDefaultPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testFormatYearOnlyPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateFormatter]/[method:testFormatWithDashSeparator()] (2 ms)
• com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration]/[method:exportedStringMatchesOriginal()] (0 ms)