이 튜토리얼에서는 Java의 YearMonth API 클래스(java.time 패키지)를 사용해 Android 앱에서 현재 연도와 월 정보를 가져와 화면에 표시하는 방법을 알아봅니다. YearMonth 클래스는 API 26(Android 8.0 Oreo) 이상에서 사용할 수 있으므로, 하위 버전 호환성을 위해 버전 체크 코드가 필요합니다.
1단계 — 새 프로젝트 생성
Android Studio에서 File ⇒ New Project 메뉴로 이동한 후, 새 프로젝트 생성에 필요한 모든 세부 정보를 입력하여 새 프로젝트를 만듭니다.
2단계 — 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:app="https://schemas.android.com/apk/res-auto"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:id="@+id/date"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Local Date"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</android.support.constraint.ConstraintLayout>위 코드에서는 현재 연도와 월을 화면에 보여주기 위해 TextView 하나를 배치했습니다. ConstraintLayout의 중앙에 위치하도록 제약 조건을 설정했습니다.
3단계 — MainActivity 작성
src/MainActivity.java 파일에 아래 코드를 추가합니다.
package com.example.myapplication;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;
import java.time.YearMonth;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
TextView textView = findViewById(R.id.date);
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
YearMonth year = YearMonth.now();
textView.setText(String.valueOf(year));
}
}
}코드의 핵심은 YearMonth.now()입니다. 이 메서드는 시스템 기본 시간대를 기준으로 현재 연도와 월 정보를 담은 YearMonth 객체를 반환합니다. 반환된 객체를 문자열로 변환하면 "2025-06"과 같은 형식(yyyy-MM)으로 출력됩니다.
또한 YearMonth 클래스는 API 26부터 도입되었기 때문에, Build.VERSION.SDK_INT >= Build.VERSION_CODES.O 조건문으로 기기의 Android 버전을 확인한 후 호출하도록 처리했습니다. 이렇게 하면 하위 버전 기기에서 앱이 비정상 종료되는 것을 방지할 수 있습니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 Android 스마트폰을 컴퓨터에 연결했다고 가정하고, Android Studio에서 프로젝트의 액티비티 파일 중 하나를 열고 상단 툴바의 Run(실행) 아이콘을 클릭합니다. 옵션 목록에서 연결된 모바일 기기를 선택하면, 기기 화면에 아래와 같은 결과가 표시됩니다.

위 실행 결과에서 볼 수 있듯이, 화면에는 기기의 현재 로컬 연도와 월이 정상적으로 출력됩니다.
추가 팁
연도와 월을 각각 분리해서 사용하고 싶다면 다음과 같은 메서드를 활용할 수 있습니다.
year.getYear()— 연도만 정수형으로 반환 (예: 2025)year.getMonthValue()— 월을 숫자로 반환 (예: 6)year.getMonth()— 월 이름을 열거형으로 반환 (예: JUNE)year.lengthOfMonth()— 해당 월의 총 일수 반환 (예: 30)
API 26 미만을 지원해야 한다면, ThreeTen-ABP 백포트 라이브러리나 Joda-Time 라이브러리를 사용하는 것도 좋은 대안입니다.