LocalDateTimeFormatter.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.LocalDateTime;

import java.time.format.DateTimeParseException;

/**

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

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

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

 * The default pattern is {@code yyyy-MM-dd'T'HH:mm:ss} (ISO-8601 local date-time).

 *

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

 * @since 1.6.0

 */

public class LocalDateTimeFormatter extends AbstractPatternFormatter<LocalDateTime> {

  @Override

  protected int computeFormattedLengthForPattern(String pattern) {

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

  }

  /** {@inheritDoc} */

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

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

      return null;

    }

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

    try {

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

    } catch (DateTimeParseException e) {

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

    }

  }

  /** {@inheritDoc} */

  public String asString(LocalDateTime dateTime, FormatInstructions instructions) {

    if (dateTime == null) {

      return null;

    }

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

  }

}

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.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testFormatIsoPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testFormatCompactPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testFormatWithSpaceSeparator()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testStarPaddingChar_rightAlign_roundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testStarPaddingChar_leftAlign_roundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:zeroPaddingRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:zeroPaddingRoundTrip_datetimeEndsInPaddingChar_secondsTen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:zeroPaddingRoundTrip_datetimeEndsInPaddingChar_minutesThirty()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateTimeWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTimeWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, 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:localDateTimeFormatTruncatesAndParseTooShortThrowsException(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:formatsAndParsesLocalDateTimeWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, java.lang.String)]/[test-template-invocation:#3] (1 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateTimeWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, java.lang.String)]/[test-template-invocation:#1] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateTimeWithAlignment(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, java.lang.String)]/[test-template-invocation:#4] (3 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestDatePatternFormatting]/[test-template:formatsAndParsesLocalDateTime(java.lang.String, java.time.LocalDateTime, 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:localDateTimeFormatTruncatesAndParseTooShortThrowsException(com.ancientprogramming.fixedformat4j.annotation.Align, char, java.lang.String, int, java.time.LocalDateTime, java.lang.String)]/[test-template-invocation:#1] (2 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestByTypeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestByTypeFormatter]/[method:testDispatchesToLocalDateTimeFormatter()] (13 ms)
• com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration]/[method:exportedStringMatchesOriginal()] (0 ms)
• com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.issues.TestDateTypesIntegration]/[method:roundTripPreservesAllFields()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl]/[method:testLocalDateTimeNoPatternAnnotationUsesIsoDefault()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestFixedFormatManagerImpl]/[method:testLocalDateTimeRoundTrip()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidDateTimeStringExceptionContainsBadInput()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidDateTimeStringExceptionChainsDateTimeParseExceptionCause()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidDateStringThrowsFixedFormatException()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidMonthThrowsFixedFormatException()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidDateTimeStringExceptionContainsPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testInvalidDateTimeStringExceptionContainsTypeName()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:computeFormattedLengthForPattern_compactPattern_returnsFourteen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:computeFormattedLengthForPattern_spaceSeparated_returnsNineteen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:computeFormattedLengthForPattern_isoPattern_returnsNineteen()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testLeapDayDateTime()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testEndOfDay()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testMidnight()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testParseCompactPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testRightAlignedPaddingStrippedBeforeParse()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:rightAlignedZeroPaddingRestoresLeadingZerosInDateComponents()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testParseIsoPattern()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testParseWithSpaceSeparator()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:leftAlignedZeroPaddingDoesNotStripZeroValuedTimeComponents()] (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.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testNullFormatReturnsSpaces()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:testAllSpaceInputParsesToNull()] (0 ms)
• com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter.[engine:junit-jupiter]/[class:com.ancientprogramming.fixedformat4j.format.impl.TestLocalDateTimeFormatter]/[method:allZeroFieldWithZeroPaddingParsesToNull()] (0 ms)