java.time 패키지

참고
자바의 정석

java.time 패키지

Date와 Calendar 클래스의 단점들을 해소하기 위해 JDK1.8부터 java.time 패키지가 추가되었다.

패키지	설명
java.time	날짜와 시간을 다루는데 필요한 핵심 클래스들을 제공
java.time.chrono	표준(ISO)이 아닌 달력 시스템을 위한 클래스들을 제공
java.time.format	날짜와 시간을 파싱하고, 형식화하기 위한 클래스들을 제공
java.time.temporal	날짜와 시간의 필드와 단위를 위한 클래스들을 제공
java.time.zone	시간대와 관련된 클래스들을 제공

위의 패키지들에 속한 클래스들의 가장 큰 특징은 String 클래스처럼 불변이라는 것이다. 그래서 날짜와 시간을 변경하는 메서드들은 기존의 객체를 변경하는 것이 아니라 변경된 새로운 객체를 반환한다. 그런데 이 점에서 의문점이 들 수 있다. 새로운 객체를 반환하면 메모리 낭비가 심하지 않을까라는 생각을 할 수 있는데 기존의 객체를 변경하면 멀티쓰레드 환경이 안전하지 못한다는 점에서 이점이 있다.
멀티쓰레드 환경에서는 동시에 여러 쓰레드가 같은 객체에 접근할 수 있기 때문에 변경 가능한 객체는 데이터가 잘못될 가능성이 있으며, 이를 쓰레드에 안전하지 않다고 한다.

java.time 패키지의 핵심 클래스

날짜와 시간을 하나로 표현하는 Calendar 클래스와 달리 java.time 패키지에서는 날짜와 시간을 별도의 클래스로 분리해 놓았다. 시간을 표현할 때는 LocalTime 클래스를 사용하고 날짜를 표현할 때는 LocalDate 클래스를 사용하며, 둘 다 사용할 때는 LocalDateTime 클래스를 사용한다. 여기에 시간대까지 다뤄야 한다면 ZonedDateTime 클래스를 사용하면 된다.

ZonedDateTime 클래스는 우리가 이전에 배운 Calendar 클래스와 유사하며 Date와 유사한 클래스로는 Instant 클래스가 있는데 이 클래스는 날짜와 시간을 초로 표현한다. 주로 이 클래스는 DB와 연동할 때 많이 사용된다.

Period와 Duration

날짜와 시간의 간격을 표현하기 위한 클래스도 있는데, Period 클래스는 두 날짜간의 차이를 표현하기 위한 것이고, Duration은 시간의 차이를 표현하기 위한 것이다.

객체 생성하기 - now(), of()

java.time 패키지에 속한 클래스의 객체를 생성하는 가장 기본적인 방법은 now()와 of()를 사용하는 것이다.

• now()는 현재 날짜와 시간을 저장하는 객체를 생성한다.

  LocalDateTime date = LocalDateTime.now();

• of()는 단순히 해당 필드의 값을 순서대로 지정해주기만 하면 된다.

  LocalDateTime date = LocalDateTime.of(2015, 11, 23, 23, 59, 59);

Temporal과 TemporalAmount

LocalDate, LocalTime, LocalDateTime, ZonedDateTime등 날짜와 시간을 표현하기 위한 클래스들은 모두 Temporal, TemporalAccessor, TemporalAdjuster 인터페이스를 구현했고, Duration과 Period는 TemporalAmount 인터페이스를 구현하였다.

Temporal, TemporalAccessor, TemporalAdjuster를 구현한 클래스
- LcoalDate, LocalTime, LocalDateTime, ZonedDateTime, instant등
TemporalAmount를 구현한 클래스
- Period, Duration

TemporalUnit과 TemporalField

날짜와 시간의 단위를 정의해 놓은 것이 TemporalUnit 인터페이스이고 이 인터페이스를 구현한 것이 enum형인 ChronoUnit이다. 그리고 TemporalField는 년, 월, 일등 날짜와 시간의 필드를 정의해 놓은 것으로, enum형인 ChronoField가 이 인터페이스를 구현하였다.

날짜와 시간에서 특정 필드 값을 얻을 때는 get() 메서드를 사용하면 되고, 특정 날짜나 시간을 더하거나 뺄때는 plus(), minus()를 사용하면 된다.

LocalDate tomorrow = LocalDate.now().plus(1, ChronoUnit.DAYS);
LocalDate tomorrow = LocalDate.now().plusDays(1);

또한 TemporalField나 TemporalUnit을 사용할 수 있는 지 확인 하는 메서드는 isSupported()를 사용하면 된다.

LocalDate와 LocalTime

LocalDate와 LocalTime은 java.time 패키지의 가장 기본이 되는 클래스이고 나머지 클래스들은 이들의 확장이다.
객체를 생성하는 방법은 현재 날짜와 시간을 LocalDate와 LocalTime으로 반환하는 now() 메서드와 지정된 날짜와 시간으로 LocalDate와 LocalTime 객체를 생성하는 of() 메서드가 있으며 둘다 static 메서드다.

LocalDate와 LocalTime 클래스들은 일단위나 초단위로도 지정이 가능하다.

LocalDate birthDate = LocalDate.ofYearDay(1999, 365); // 1999년 12월 31일
LcoalTime birthTime = LocalTime.ofSecondDay(86399); // 23시 59분 59초

또는 parse() 메서드를 통하여 문자열을 날짜와 시간으로 변환이 가능하다.

LocalDate birthDate = LocalDate.parse("1999-12-31");
LocalTime birthTime = LocalTime.parse("23:59:59");

특정 필드의 값 가져오기 - get(), getXXX()

클래스	메서드	설명
LocalDate	int getYear()	년도(2022)
LocalDate	int getMonthValue()	월(12)
LocalDate	Month getMonth()	월(DECEMBER)
LocalDate	int getDayOfMonth()	일(31)
LocalDate	int getDayOfYear()	같은 해의 1월 1일부터 몇번째 일
LocalDate	DayOfWeek getDayOfWeek()	요일(SUNDAY)
LocalDate	int lengthOfMonth()	같은 달의 총 일수(31)
LocalDate	int lengthOfYear()	같은 해의 총 일수(365), 윤년이면 366
LocalDate	boolean isLeapYear()	윤년여부 확인
LocalTime	int getHour()	시
LocalTime	int getMinute()	분
LocalTime	int getSecond()	초
LocalTime	int getNano()	나노초

위의 표의 메서들의 매개변수로 사용할 수 있는 목록은 아래와 같다.

TemporalField(ChronoField)	성명
ERA	시대
YEAR_OF_ERA, YEAR	년
MONTH_OF_YEAR	월
DAY_OF_WEEK	요일
DAY_OF_MONTH	일
AMPM_OF_DAY	오전/오후
HOUR_OF_DAY	시간(0~23)
CLOCK_HOUR_OF_DAY	시간(1~24)
HOUR_OF_AMPM	시간(0~11)
CLOCK_HOUR_OF_AMPM	시간(1~12)
MINUTE_OF_HOUR	분
SECOND_OF_MINUTE	초
MILLI_OF_SECOND	천분의 일초
MICRO_OF_SECOND	백만분의 일초
NANO_OF_SECOND	10억분의 일초
DAY_OF_YEAR	그 해의 몇번째 날
EPOCH_DAY	EPOCH(1970.1.1)부터 몇번째 날
MINUTE_OF_DAY	그 날의 몇번째 분 (시간을 분으로 확산)
SECOND_OF_DAY	그 날의 몇번째 초 (시간을 초로 환산)
MILLI_OF_DAY	그 날의 몇번째 밀리초
MICRO_OF_DAY	그 날의 몇번째 마이크로초
NANO_OF_DAY	그 날의 몇번째 나노초
ALIGNED_WEEK_OF_MONTH	그 달의 n번째 주
ALIGNED_WEEK_OF_YEAR	그 해의 n번째 주
ALIGNED_DAY_OF_WEEK_IN_MONTH	요일 (그 달의 1일을 월요일로 간주하여 계산)
ALIGNED_DAY_OF_WEEK_IN_YEAR	요일 (그 해의 1월 2일을 월요일로 간주하여 계산)
INSTANT_SECONDS	년월일을 초단위로 환산 Instant에만 사용
OFFSET_SECONDS	UTC와의 시차. ZoneOffset에만 사용가능
PROLEPTIC_MONTH	년월을 월단위로 환산

이 목록은 ChronoField에 정의된 모든 상수를 표현한것이고 클래스마다 사용가능한 상수가 다르다.

만일 해당 클래스가 지원하지 않는 필드를 사용하면 UnsupportedTemporalTypeException이 발생한다.

필드 값 변경하기 - with(), plus(), minus()

날짜와 시간에서 특정 필드 값을 변경하려면 with으로 시작하는 메서드를 사용하면 된다. with으로 시작하는 메서드는 다음과 같다.

LocalDate withYear(int year);
LocalDate withMonth(int month);
LocalDate withDayOfMonth(int dayOfMonth);
LocalDate withDayOfYear(int dayOfYear);

LocalTime withHour(int hour);
LocalTime withMinute(int minute);
LocalTime withSecond(int second);
LocalTime withNano(int nanoSecond);

또한 with() 메서드를 통하여 직접 필드를 지정이 가능하다. 여기서 주의할 점은 필드를 변경하는 메서드들은 항상 새로운 객체를 생성해서 반환하므로 대입 연산자를 같이 사용해야한다.

이 외에도 특정 필드에 값을 더하거나 빼는 plus()와 minus()가 있다.

그리고 LocalTime의 truncatedTo() 메서드는 지정된 것보다 작은 단위의 필드를 0으로 만든다.

그런데 LocalTime과 달리 LocalDate에는 truncatedTo()가 없는데, 그 이유는 LocalDate의 필드인 년, 월, 일은 0이 될 수 없기 때문이다. 그리고 이 메서드의 매개변수로 아래의 표중에 시간과 관련된 필드만 사용가능하다.

TemporalUnit(ChronoUnit)	설명
FOREVER	Long.MAX_VALUE초(약 3천억년)
ERAS	1,000,000,000년
MILLENNIA	1,000년
CENTURIES	100년
DECADES	10년
YEARS	년
MONTHS	월
WEEKS	주
DAYS	일
HALF_DAYS	반나절
HOURS	시
MINUTES	분
SECONDS	초
MILLIS	천분의 일초
MICROS	백만분의 일초
NANOS	10억분의 일초

날짜와 시간의 비교 - isAfter(), isBefore(), isEqual()

LocalDate와 LocalTime 클래스도 compareTo()가 적절히 오버라이딩되어 있어서 쉽게 비교가 가능하지만 더 편라힌 메서드들도 추가되었다.

boolean isAfter(ChronoLocalDate other)
boolean isBefore(ChronoLocalDate other)
boolean isEqual(ChronoLocalDate other)

물론 LocalDate와 LocalTime에는 equal() 메서드가 있지만 isEqual()을 제공하는 이유는 연표가 다른 두 날짜를 비교하기 위해서이다. 모든 필드를 일치하는지 알고 싶을때는 equal() 메서드를 사용하고 오직 날짜만 비교하고 싶을 때는 isEqual() 메서드를 사용한다.

Instant

Instant 클래스는 에포크 타임부터 경과된 시간을 나노초 단위로 표현한다.

Instant를 생성할 때는 now()와 ofEpochSecond()를 사용한다.

long epochSec = Instant.now().getEpochSecond();
int nano = Instant.now().getNano();

Instant는 항상 UTC를 기준으로 하기 때문에 LocalTime과 차이가 있을 수 있다. 시간대를 고려할 때는 OffsetDateTime을 사용하는 것이 좋은 선택이다.

Instant와 Date간의 변환

Instant는 기존의 java.util.Date를 대체하기 위한것으로 JDK1.8부터 Date에 Instant로 변환할 수 있는 새로운 메서드가 추가되었다.

static Date from(Instant instant) // Instant -> Date
Instant toInstant() // Date -> Instant

LocalDateTime과 ZonedDateTime

LocalDate와 LocalTime을 합쳐 놓은 것이 LocalDateTime이고, LocalDateTime에 시간대를 추가하는 것이 ZonedDateTime이다.

LocalDate와 LocalTime으로 LocalDateTime 만들기

LocalDate와 LocalTime으로 합쳐서 하나의 LocalDateTime을 만들 수 있다. 대표적인 방법을 아래의 코드를 통해 살펴보자.

LocalDate date = LocalDate.of(2022, 7, 30);
LocalTime time = LocalTime.of(12,34,56);

LocalDateTime dt = LocalDateTime.of(date, time);

물론 LocalDateTime에도 날짜와 시간을 직접 지정할 수 있는 다양한 버전의 of()와 now()가 정의되어 있다.

LocalDateTime dateTime = LocalDateTime.of(2022, 7, 12, 12, 34, 56);
LocalDateTime today = LocalDateTime.now();

LocalDateTime의 변환

반대로 LocalDateTime을 LocalDate 또는 LocalTime으로 변환할 수 있다.

LocalDateTime dateTime = LocalDateTime.of(2022, 7, 12, 12, 34, 56);

LocalDate date = dt.toLocalDate();
LocalTime time = dt.toLocalTime();

LocalDateTime으로 ZonedDateTime 만들기

LocalDateTime에 시간대를 추가하면 ZonedDateTime이 된다. 기존에는 TimeZone 클래스로 시간대를 다뤘지만 새로운 패키지에서는 ZoneId라는 클래스를 사용한다. ZoneId는 일정 절약시간을 자동적으로 처리해줌으로 더 편리하다.
LocalDate에 시간정보를 추가하는 atTime()을 쓰면 LocalDateTime을 얻을 수 있는 것처럼 LocalDateTime에 atZone()으로 시간대 정보를 추가하면 ZonedDateTime을 얻을 수 있다.

LocalDate에 atStartOfDay()라는 메서드가 있는데 이 메서드에 매개변수로 ZoneId를 지정해도 ZonedDateTime을 얻을 수 있다.

ZoneOffset

UTC부로부터 얼마만큼 떨어져 있는지를 ZoneOffset으로 표현한다.

OffsetDateTime

ZonedDateTime은 ZoneId로 구역을 표현하는데 ZoneId가 아닌 ZoneOffset을 사용하는 것이 OffsetDateTime이다. ZoneId는 일광절역시간처럼 시간대와 관련된 규칙들을 포함하고 있는데, ZoneOffset은 단지 시간대를 시간의 차이로만 구분한다. 같은 지역 내의 컴퓨터 간에 데이터를 주고받을 때는 전송시간을 표현하기엔 LocalDateTime이며, 충분하지만, 서로 다른 시간대에 존재하는 컴퓨터간의 통신에는 OffsetDateTime이 필요하다.

ZonedDateTime zdt = ZonedDateTime.of(date, time, zid);
OffsetDateTime odt = OffsetDateTime.of(date, time, krOffset);

// ZonedDateTime -> OffsetDateTime
OffsetDateTime odt = zdt.toOffsetDateTime();

OffsetDateTime은 ZonedDateTime처럼, LocalDate와 LocalTime에 ZoneOffset을 더하거나, ZonedDateTime에 toOffsetDateTime()을 호출해서 얻을 수 있다.

ZonedDateTime 변환

ZoneDateTime도 LocalDateTime처럼 날짜와 시간에 관련된 다른 클래스로 변환하는 메서들을 가지고 있다.

LocalDate toLocalDate()
LocalTime toLocalTime()
LocalDateTime toLocalDateTime()
OffsetDateTime toOffsetDateTime()
long toEpochSecond()
Instant toInstant()

TemporalAdjusters

앞서 plus(), minus()와 같은 메서드로 날짜와 시간을 계산할 수 있다는 것을 배웠다. 하지만, 지난주 토요일이 몇일인지 이 달의 3째주 금요일이 몇일인지등 날짜계산을 하기엔 불편하다. 그래서 자주 쓰일만한 날짜 계산들을 대신 해주는 메서드를 정의해놓은 것이 TemporalAdjusters 클래스이다.

메서드	설명
firstDayOfNextYear()	다음 해의 첫 날
firstDayIfNextMonth()	다음 달의 첫 날
firstDayOfYear()	올 해의 첫 날
firstDayOfMonth()	이번 달의 첫 날
lastDayOfYear()	올 해의 마지막 날
lastDayOfMonth()	이번 달의 마지막 날
firstInMonth(DayOfWeek dayOfWeek)	이번 달의 첫 번째 ?요일
lastInMonth(DayOfWeek dayOfWeek)	이번 달의 마지막 ?요일
previous(DayOfWeek dayOfWeek)	지난 ?요일(당일 미포함)
previousOrSame(DayOfWeek dayOfWeek)	지난 ?요일(당일 포함)
next(DayOfWeek dayOfWeek)	다음 ?요일(당일 미포함)
nextOrSame(DayOfWeek dayOfWeek)	다음 ?요일(당일 포함)
dayOfWeekInMonth(int ordinal, DayOfWeek dayOfWeek)	이번 달의 n번째 ?요일

TemporalAdjuster 직접 구현하기

보통은 TemporalAdjusters에 정의된 메서드로 충분하겠지만, 필요하면 자주 사용되는 날짜 계산을 해주는 메서드를 직접 만들 수 있다.

LocalDate의 with()는 TemporalAdjuster 인터페이스를 구현한 클래스의 객체를 매개변수로 제공해야한다.

LocalDate with(TemporalAdjuster adjutster)

그러면 좀 더 구체적으로 TemporalAdjuster 인터페이스 구현이 어떻게 되었는지 살펴보자.

@FunctionalInterface
public interface TemporalAdjuster {
	Temporal adjustInto(Temporal temporal);
}

실제로 TemporalAdjuster를 구현하면 구현해야하는 것은 adjustInto()지만, 우리가 TemporalAdjuster와 같이 사용하는 메서드는 with()이다. 이 중에 어느것을 사용해도 되지만, adjustInto()는 내부적으로만 사용할 의도로 작성된 것이기 때문에 with()를 사용하면 된다.

Period와 Duration

Period는 날짜의 차이를, Duration은 시간의 차이를 계산하기 위한 것이다.

between()

두 날짜의 차이를 나타내는 Period는 between() 메서드를 통해 구할 수 있다.

LocalDate date1 = LocalDate.of(2022, 1, 1);
LocalDate date2 = LocalDate.of(2023, 12, 31);

Period pe = Period.between(date1, date2);

date1이 date2보다 날짜 상으로 이전이면 양수로, 이후면 음수로 Period에 저장한다.
그리고 시간 차이를 구할 때는 Duration을 사용한다는 것을 제외하고 Period와 같다.

LocalTime time1 = LocalTime.of(0, 0, 0);
LocalTime time2 = LocalTime.of(12,34,56);

Duration du = Duration.between(time1, time2);

Period, Duration에서 특정 필드 값을 얻을 때는 get()을 사용한다.

long year = pe.get(ChronoUnit.YEARS); // int getYears()
long month = pe.get(ChronoUnit.MONTHS); // int getMonths()
long day = pe.get(ChronoUnit.DAYS) // int getDays()

long sec = du.get(ChronoUnit.SECONDS) // long getSeconds()
int nano = du.get(ChronoUnit.NANOS) // int getNano()

여기서 알아둬야 할 사실은 Period와 달리 Duration에는 getHours(), getMinutes() 메서드가 존재하지 않는다.

그러면 여기서 불편한 것들이 나온다. Duration에는 getHours(), getMinutes() 메서드가 존재하지 않기 때문에 상수를 통하여 직접 명시를 해야한다. 이 방법은 개발자에 따라 오타가 날 수도 있고 실수에 여지가 있을 수도 있기 때문에 Duration을 LocalTime으로 변환 후, LocalTime의 get() 메서드를 사용함으로 비교적 쉽게 풀 수가 있다.

LocalTime tmpTime = LocalTime.of(0, 0).plusSeconds(du.getSeconds());

int hour = tmpTime.getHour();
int min = tmpTime.getMinute();
int sec = tmpTime.getSecond();
int nano = du.getNano();

between()과 until()

between()과 until() 메서드는 거의 같은 기능을 하고 유일한 차이라면 between() 메서드는 static 메서드이고 until() 메서드는 인스턴스 메서드라는 것이다.

Period는 년월일을 분리해서 저장하기 때문에 D-day를 구하려는 경우 같은 경우 두 개의 매개변수를 받는 until()을 사용하는 것이 낫다.

of(), with()

Period에는 of(), ofYear(), ofMonths(), ofWeeks(), ofDays()가 있고, Duration에는 of(), ofDays(), ofHours(), ofMinutes(), ofSeconds()등이 있다.

또한 특정 필드의 값을 변경하는 with()도 존재한다.

사용방법은 LocalDate, LocalTime에서 쓰는 것과 동일하다.

사칙연산, 비교연산, 기타 메서드

plus(), minus()외에 곱셈과 나눗셈을 위한 메서드도 있다.

pe = pe.minusYear(1).multipliedBy(2); // 1년을 빼고 2배를 곱한다.
du = du.plusHours(1).dividedBy(60); // 1시간을 더하고 60으로 나눈다.

Period에 나눗셈을 위한 메서드는 따로 존재하지 않는다.

그리고 음수인지 아닌지 확인하는 isNegative()와 0인지 확인하는 isZero()가 있다.

또한 부호를 반대로 변경하는 negate()와 부호를 없애는 abs()가 있다.

또한 Period에 normalized()라는 메서드가 존재하는데 이 메서드는 월의 값이 12를 넘지 않게 조정을 해준다. 만약 넘는다면 연수를 증가시켜서 변환해준다. 단, 일수는 월마다 다르므로 조절하지 않는다.

pe = Period.of(1, 13, 32).normalized(); // 2년 1개월 32일 

다른 단위로 변환 - toTotalMonths(), toDays(), toHours(), toMinutes()

이 메서드들은 Period와 Duration을 다른 단위의 값으로 변환하는데 사용한다. get()은 특정 필드의 값을 그대로 가져오는 것이지만, 아래의 메서드들은 특정 단위로 결과를 반환한다는 차이가 있다.

클래스	메서드	설명
Period	long toTotalMonths()	년월일을 월단위로 변환해서 반환 (일 단위는 무시)
Duration	long toDays()	일단위로 변환해서 반환
Duration	long toHours()	시간단위로 변환해서 반환
Duration	long toMinutes()	분단위로 변환해서 반환
Duration	long toMillis()	천분의 일초 단위로 변환해서 반환
Duration	long toNanos()	나노초 단위로 변환해서 반환

파싱과 포맷

날짜와 시간을 원하는 형식으로 출력하고 파싱하는 방법을 알아보자.
형식화와 관련된 클래스들은 java.time.format 패키지에 들어있는데 이 중에 DateTimeFormatter가 핵심이다.

LocalDate date = LocalDate.of(2016, 1, 12);
String year = DateTimeFormatter.ISO_LOCAL_DATE.format(date);
String year = date.format(DateTimeFormatter.ISO_LOCAL_DATE);

날짜와 시간을 형식화하기위해서 format이라는 메서드가 사용되는데 DateTimeFormatter에만 해당되는게 아니라 LocalDate나 LocalTime같은 클래스에도 해당이 된다. 그럼 format 메서드에 사용되는 상수를 알아보자.

DateTimeFormatter	설명
ISO_DATE_TIME	Date and time with ZoneId
ISO_LOCAL_DATE	ISO Local Date
ISO_LOCAL_TIME	Time without offset
ISO_LOCAL_DATE_TIME	ISO Local Date and Time
ISO_OFFSET_DATE	ISO Date with offset
ISO_OFFSET_TIME	Time with offset
ISO_OFFSET_DATE_TIME	Date Time with Offset
ISO_ZONED_DATE_TIME	Zoned Date Time
ISO_INSTANT	Date and Time of an Instant
BASIC_ISO_DATE	Basic ISO date
ISO_DATE	ISO Date with or without offset
ISO_TIME	Time with or without offset
ISO_ORDINAL_DATE	Year and day of year
ISO_WEEK_DATE	Year and Week
RFC_1123_DATE_TIME	RFC 1123 / RFC 822

로케일에 종속된 형식화

DateTimeFormatter의 static 메서드 ofLocalizedDate(), ofLocalizedTime(), ofLocalizedDateTime()은 로케일에 종속적인 포맷터를 생성한다.

DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDate(FormatStyle.SHORT);

String shortFormat = formatter.format(LocalDate.now());

FormatStyle의 종류에 따른 출력 형태는 다음과 같다.

FormatStyle	날짜	시간
FULL	2015년 11월 28일 토요일	N/A
LONG	2015년 11월 28일(토)	오후 9시 15분 31초
MEDIUM	2015.11.28	오후 9:15:13
SHORT	15.11.28	오후 9:15

출력형식 직접 정의하기

DateTimeFormatter의 ofPattern()으로 원하는 출력형식을 직접 작성이 가능하다.

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd");

출력 형식에 사용되는 기호의 목록은 다음과 같다.

기호	의미
G	연대 (BC, AD)
y 또는 u	년도
M 또는 L	월 (1~12 또는 1월~12월)
Q 또는 q	분기
w	년의 몇번째 주
W	월의 몇번째 주
D	년의 몇번째 일
d	월의 몇번째 일
F	월의 몇번째 요일
E 또는 e	요일
a	오전/오후(AM, PM)
H	시간(0~23)
k	시간(1~24)
K	시간(0~11)
h	시간(1~12)
m	분(0~59)
s	초(0~59)
S	천분의 일초(0~999)
A	천분의 일초(그 날의 0시 0분 0초 부터의 시간)
n	나노초(0~999999999)
N	나노초(그 날의 0시 0분 0초 부터의 시간)
V	시간대 ID(VV)
z	시간대 이름
O	지역화된 zone-offset
Z	zone-offset
X 또는 x	zone-offset(Z는 +00:00를 의미)
'	escape문자

문자열을 날짜와 시간으로 파싱하기

문자열을 날짜 또는 시간으로 변환하려면 static 메서드 parse()를 사용하면 된다.

static LocalDateTime parse(CharSequence text)
static LocaldateTime parse(CharSequence text, DateTimeFormatter formatter)

자주 사용되는 기본적인 형식의 문자열은 ISO_LOCAL_DATE와 같은 형식화 상수를 사용하지 않고도 파싱이 가능하다.