AndroidでLocalDate APIクラスを使ってローカル日付を取得する方法を解説

この記事では、AndroidアプリにおいてLocalDate APIクラス（java.time.LocalDate）を使用して、今日・昨日・明日といったローカル日付を取得する方法をサンプルコードとともに解説します。LocalDateはJava 8（APIレベル26 / Android 8.0 Oreo）以降で利用可能な日付操作クラスで、加減算などの日付計算も直感的に行えます。

手順1：新しいプロジェクトを作成する

Android Studioを開き、メニューから「File」⇒「New Project」を選択して、必要な項目を入力し新しいプロジェクトを作成します。

手順2：レイアウトファイル（activity_main.xml）にコードを追加する

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を1つ配置しています。

手順3：MainActivity.javaにコードを追加する

src/MainActivity.java に以下のコードを記述します。

package com.example.myapplication;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;

import java.time.LocalDate;

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);
        // LocalDateはAPIレベル26（Android 8.0）以降でのみ使用可能
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
            LocalDate date = LocalDate.now();          // 今日の日付を取得
            LocalDate yesterday = date.minusDays(1);   // 昨日の日付を算出
            LocalDate tomorrow = date.plusDays(1);     // 明日の日付を算出
            textView.setText(String.valueOf("Today " + date + " Yesterday " + yesterday + " tomorrow " + tomorrow));
        }
    }
}

コードのポイント

• LocalDate.now()：システムの現在日付（ローカル日付）を取得します。
• minusDays(1) / plusDays(1)：それぞれ指定した日数分だけ前後の日付を簡単に計算できます。
• バージョンチェック：java.timeパッケージはAPIレベル26未満では利用できないため、Build.VERSION.SDK_INTによる条件分岐が必要です。古いOSをサポートする場合は、ThreeTenABPなどの下位互換ライブラリの利用も検討しましょう。

アプリを実行して結果を確認する

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

アプリが起動すると、画面には以下のように今日の日付・昨日の日付・明日の日付が表示されます。

表示された日付が正しいかどうかは、端末のシステム日付設定と比較することで確認できます。

まとめ

LocalDateクラスを使えば、わずか数行のコードでローカル日付の取得や前後の日付計算が実現できます。日付をまたぐ処理やカレンダー機能などを作る際に非常に便利なAPIなので、ぜひ活用してみてください。