AndroidでOffsetDateTime APIクラスを使って月の日付・年間通算日・曜日を取得する方法

このチュートリアルでは、java.timeパッケージのOffsetDateTime APIクラスを使用して、Androidアプリで「月の日（日付）」「年間通算日」「曜日」を取得して画面に表示する方法を解説します。

OffsetDateTimeクラスとは

OffsetDateTimeは、Java 8で導入された新しい日時API（JSR-310）の一部で、UTCからのオフセット情報（例：+09:00）を含んだ日付と時刻を表すクラスです。タイムゾーンのオフセットを考慮した正確な日時処理が必要な場合に便利で、getDayOfWeek()、getDayOfMonth()、getDayOfYear()などのメソッドを使うことで、曜日・月の日・年間通算日を簡単に取得できます。

実装手順

ステップ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を配置しています。

ステップ3：MainActivity.javaの編集

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

package com.example.myapplication;

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

import java.time.OffsetDateTime;
import java.time.OffsetTime;

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) {
            OffsetDateTime offset = OffsetDateTime.now();
            textView.setText(String.valueOf(offset.getDayOfWeek() + " : " + offset.getDayOfMonth() + " : " + offset.getDayOfYear()));
        }
    }
}

コードのポイントは以下の通りです。

• OffsetDateTime.now()：システムデフォルトのオフセット付きで現在の日時を取得します。
• getDayOfWeek()：曜日（MONDAYなど）を返します。
• getDayOfMonth()：月の日（1〜31）を返します。
• getDayOfYear()：年間通算日（1〜365または366）を返します。

なお、java.timeパッケージはAPIレベル26（Android 8.0 Oreo）以降でしか使用できないため、SDK_INTがVERSION_CODES.O以上であるかをチェックしています。それより古いOSバージョンもサポートしたい場合は、Android Gradle PluginのcoreLibraryDesugaring機能を有効化するか、ThreeTenABPなどのバックポートライブラリを利用しましょう。

アプリの実行と結果確認

それではアプリを実行してみましょう。ここでは、実際のAndroid端末がPCに接続されているものとします。Android Studioからアプリを実行するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの[Run]アイコンをクリックします。デバイス選択ダイアログで自分のモバイルデバイスを選択してください。

実行結果の画面には、たとえば「MONDAY : 31 : 90」のように、現在の曜日 ： 月の日 ： 年間通算日がコロン区切りで表示されます。

まとめ

このように、OffsetDateTimeクラスのgetDayOfWeek()、getDayOfMonth()、getDayOfYear()メソッドを組み合わせることで、わずか数行のコードで現在の日付に関する詳細情報を取得できます。オフセット付きの日時処理が必要な場面で、ぜひ活用してみてください。