Apex で日付を扱う方法【初心者向け】

Apex で日付を扱う方法は、初心者にとってはなかなか困難に感じることでしょう。日付型である Datetime を使って、システム上での日付処理を行うためには、複雑なルールや設定を把握しなければなりません。そんな中、Apex の日付処理機能を一歩ずつ理解し、業務効率化や自動化を進めるための基本を身に付けていきましょう。この記事では、Apex で日付を扱うための基本的な知識を解説し、初心者でもわかりやすく日付処理を実現する方法を整えています。

Apex で日付を扱う方法【初心者向け】

Apexで日付を扱う場合、複数の方法があります。本稿では、初心者向けに Apex で日付を扱う方法を解説します。

1. Date クラスの使用

Apex では、Date クラスを使用して日付を扱うことができます。Date クラスは、年、月、日を保持するクラスです。以下は、Date クラスを使用して日付を扱う例です。 Date today = Date.today(); System.debug(today); この例では、 today 変数に現在日付を代入しています。

メソッド	説明
today()	現在日付を取得する
yearsFrom()	指定された日付から年を取得する
monthsFrom()	指定された日付から月を取得する
daysFrom()	指定された日付から日を取得する

2. DateTime クラスの使用

Apex では、DateTime クラスを使用して日付と時刻を扱うことができます。DateTime クラスは、年、月、日、時、分、秒を保持するクラスです。以下は、DateTime クラスを使用して日付と時刻を扱う例です。 DateTime now = DateTime.now(); System.debug(now); この例では、 now 変数に現在日付と時刻を代入しています。

メソッド	説明
now()	現在日付と時刻を取得する
yearsFrom()	指定された日付から年を取得する
monthsFrom()	指定された日付から月を取得する
daysFrom()	指定された日付から日を取得する
hoursFrom()	指定された日付から時を取得する
minutesFrom()	指定された日付から分を取得する
secondsFrom()	指定された日付から秒を取得する

3. ソースのフォーマット

Apex では、日付を文字列に変換する必要があります。このため、ソースのフォーマットを指定する必要があります。以下は、日付を文字列に変換する例です。 Date today = Date.today(); String formattedDate = today.format('yyyy/MM/dd'); System.debug(formattedDate); この例では、 today 変数に現在日付を代入し、formattedDate 変数にフォーマット済みの日付を代入しています。

フォーマット	説明
yyyy	年（4桁）
MM	月（2桁）
dd	日（2桁）

4. 日付のカスタマイズ

Apex では、日付をカスタマイズする必要があります。このため、日付のフォーマットや、曜日を取得する必要があります。以下は、日付をカスタマイズする例です。 Date today = Date.today(); String formattedDate = today.format('EEEE, MMMM d, yyyy'); System.debug(formattedDate); この例では、 today 変数に現在日付を代入し、formattedDate 変数にフォーマット済みの日付を代入しています。

フォーマット	説明
EEEE	曜日（日本語）
MMMM	月（日本語）
d	日（1桁または2桁）

5. 日付の演算

Apex では、日付の演算を行う必要があります。このため、日付の加算や減算を行う必要があります。以下は、日付の演算を行う例です。 Date today = Date.today(); Date tomorrow = today.addDays(1); System.debug(tomorrow); この例では、 today 変数に現在日付を代入し、tomorrow 変数に翌日の日付を代入しています。

よくある質問

Q1: Apex で日付を扱うための基本的なクラスは何ですか？

Apex では、日付を扱うために Datetime クラスと Date クラスの 2 つがあります。Datetime クラスは、日付と時刻を合わせて表現するクラスで、Date クラスは、日付のみを表現するクラスです。両クラスは、日付に関する計算や操作を行うためのメソッドを提供しています。

Q2: Apex で日付のフォーマットを指定する方法は何ですか？

Apex では、日付のフォーマットを指定するために DateTime.Format メソッドや DateFormat クラスを使用します。DateTime.Format メソッドでは、パターン文字列を指定することで、日付を任意のフォーマットに変換することができます。一方、DateFormat クラスでは、固定のフォーマットに基づいて日付を文字列に変換することができます。