Configuration

java-time-extensions 라이브러리는 String 인스턴스에서 java.time.* 패키지의 타입으로 변환할 때 매개변수가 없는 기본 함수는 라이브러리에서 지정한 기본 패턴을 사용합니다. 라이브러리에서 지정한 패턴을 사용자가 변경하고자 하면 외부에서 src/main/resources 디렉토리 위치에 java-time-extensions.properties 파일을 생성하고 정해진 키에 값을 할당하면 변경됩니다.

java-time-extensions.properties

이 파일은 java-time-extensions에서 시간 관련 확장을 구성하는 데 사용됩니다. 여기에는 날짜, 시간, UTC 시간대 등의 형식 설정이 포함될 수 있습니다.

key	desc	ex	default
pattern.local-date	LocalDate 타입으로 변환할 때 사용할 패턴	pattern.local-date=yyyyMMdd	yyyy-MM-dd
pattern.local-date-time	LocalDateTime 타입으로 변환할 때 사용할 패턴	pattern.local-date-time=yyyyMMddHHmmss	yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]
pattern.local-time	LocalTime 타입으로 변환할 때 사용할 패턴	pattern.local-time=HHmmss	HH:mm[:ss][.SSS]
pattern.month-day	MonthDay 타입으로 변환할 때 사용할 패턴	pattern.month-day=MMdd	MM-dd
pattern.offset-date-time	OffsetDateTime 타입으로 변환할 때 사용할 패턴	pattern.offset-date-time=yyyyMMddHHmmssZ	yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]XXX
pattern.offset-time	OffsetTime 타입으로 변환할 때 사용할 패턴	pattern.offset-time=HHmmssZ	HH:mm[:ss][.SSS]XXX
pattern.year	Year 타입으로 변환할 때 사용할 패턴	pattern.year=yy	yyyy
pattern.year-month	YearMonth 타입으로 변환할 때 사용할 패턴	pattern.year-month=yyMM	yyyy-MM
pattern.zoned-date-time	ZonedDateTime 타입으로 변환할 때 사용할 패턴	pattern.zoned-date-time=yyyyMMddHHmmssZ	yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]XXX'['VV']

pattern.local-date

LocalDate 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy-MM-dd을 사용합니다.

pattern.local-date=yyyyMMdd

이 속성은 String.toLocalDate(): LocalDate, String.toLocalDateOrNull(): LocalDate? 함수에 적용됩니다.

pattern.local-date-time

LocalDateTime 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]을 사용합니다.

pattern.local-date-time=yyyyMMddHHmmss

이 속성은 String.toLocalDateTime(): LocalDateTime, String.toLocalDateTimeOrNull(): LocalDateTime? 함수에 적용됩니다.

pattern.local-time

LocalTime 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 HH:mm[:ss][.SSS]을 사용합니다.

pattern.local-time=HHmmss

이 속성은 String.toLocalTime(): LocalTime, String.toLocalTimeOrNull(): LocalTime? 함수에 적용됩니다.

pattern.month-day

MonthDay 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 [--]MM-dd을 사용합니다.

pattern.month-day=MMdd

이 속성은 String.toMonthDay(): MonthDay, String.toMonthDayOrNull(): MonthDay? 함수에 적용됩니다.

pattern.offset-date-time

OffsetDateTime 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]XXX을 사용합니다.

pattern.offset-date-time=yyyyMMddHHmmssZ

이 속성은 String.toOffsetDateTime(): OffsetDateTime, String.toOffsetDateTimeOrNull(): OffsetDateTime? 함수에 적용됩니다.

pattern.offset-time

OffsetTime 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 HH:mm[:ss][.SSS]XXX을 사용합니다.

pattern.offset-time=HHmmssZ

이 속성은 String.toOffsetTime(): OffsetTime, String.toOffsetTimeOrNull(): OffsetTime? 함수에 적용됩니다.

pattern.year

Year 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy을 사용합니다.

pattern.year=yy

이 속성은 String.toYear(): Year, String.toYearOrNull(): Year? 함수에 적용됩니다.

pattern.year-month

YearMonth 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy-MM을 사용합니다.

pattern.year-month=yyMM

이 속성은 String.toYearMonth(): YearMonth, String.toYearMonthOrNull(): YearMonth? 함수에 적용됩니다.

pattern.zoned-date-time

ZonedDateTime 타입으로 변환할 때 사용할 패턴을 지정합니다. 지정하지 않으면 기본값 yyyy-MM-dd['T'][ ]HH:mm[:ss][.SSS]XXX'['VV']을 사용합니다.

pattern.zoned-date-time=yyyyMMddHHmmssZ

이 속성은 String.toZonedDateTime(): ZonedDateTime, String.toZonedDateTimeOrNull(): ZonedDateTime? 함수에 적용됩니다.

최종 설정

java-time-extensions.properties 파일을 생성하고 아래와 같이 설정하면 변경된 패턴이 적용됩니다.

src/main/resources/java-time-extensions.properties:

pattern.local-date=yyyyMMdd
pattern.local-date-time=yyyyMMddHHmmss
pattern.local-time=HHmmss
pattern.month-day=MMdd
pattern.offset-date-time=yyyyMMddHHmmssZ
pattern.offset-time=HHmmssZ
pattern.year=yy
pattern.year-month=yyMM
pattern.zoned-date-time=yyyyMMddHHmmssZ