【Kotlin】AndroidアプリでCalendarViewクラスを使ってカレンダーウィジェットを実装する方法

この記事では、Kotlinを使用したAndroidアプリで、CalendarViewクラスを利用してカレンダーウィジェットを表示し、日付選択イベントを取得する方法をステップごとに解説します。カレンダーUIはスケジュール管理アプリや予約システムなど、さまざまな場面で活用できる基本的なウィジェットです。

実装手順

ステップ1：新規プロジェクトの作成

まず、Android Studioで新しいプロジェクトを作成します。メニューから「File → New Project」を選択し、必要な項目（プロジェクト名、保存先、使用言語など）を入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）の編集

次に、res/layout/activity_main.xml に以下のコードを追加します。日付を表示するTextViewと、CalendarViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/dateView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="20dp"
        android:text="Set the Date"
        android:textColor="@android:color/background_dark"
        android:textStyle="bold" />
    <CalendarView
        android:id="@+id/calender"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_below="@id/dateView"
        android:layout_centerInParent="true"
        android:layout_marginTop="20dp">
    </CalendarView>
</RelativeLayout>

このレイアウトでは、画面上部に選択した日付を表示するTextView（dateView）を配置し、その下にCalendarViewを広げて表示しています。

ステップ3：MainActivity.ktの実装

続いて、src/MainActivity.kt に以下のコードを記述します。CalendarViewにOnDateChangeListenerを設定することで、ユーザーが日付をタップしたタイミングで選択された年・月・日を取得できます。

import android.os.Bundle
import android.widget.CalendarView
import android.widget.CalendarView.OnDateChangeListener
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var calendarView: CalendarView
    lateinit var dateView: TextView
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "Kotlin"
        calendarView = findViewById(R.id.calender)
        dateView = findViewById(R.id.dateView)
        calendarView.setOnDateChangeListener(OnDateChangeListener { _, year, month, dayOfMonth ->
            val date = dayOfMonth.toString() + "-" + (month + 1) + "-" + year
            dateView.text = date
        })
    }
}

ポイント：コールバックで受け取るmonthの値は0始まり（1月=0、12月=11）であるため、表示用には「month + 1」として1を加算しています。ここを見落とすと、実際の月とずれた値が表示されてしまうので注意しましょう。

ステップ4：AndroidManifest.xmlの確認

最後に、androidManifest.xml が以下のようになっていることを確認します。特別なパーミッションは不要ですが、ランチャーアクティビティとしてMainActivityが登録されている必要があります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、アプリを実行してみましょう。実機のAndroidスマートフォンをPCに接続しているものとします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーのRunアイコン（緑色の再生ボタン） をクリックしてください。デバイス選択ダイアログが表示されたら、接続したモバイル端末を選択して実行します。

アプリが起動すると、デフォルト画面としてカレンダーが表示されます。任意の日付をタップすると、画面上部のTextViewに選択した日付が「日-月-年」の形式で反映されることが確認できます。