この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Date クラス

Date プリミティブデータ型のメソッドが含まれます。

名前空間

System

使用方法

Date についての詳細は、「Date データ型」を参照してください。

Date のメソッド

Date のメソッドは次のとおりです。

addDays(additionalDays)

指定した追加日数を date に加算します。

署名

public Date addDays(Integer additionalDays)

パラメータ

additionalDays
型: Integer

戻り値

型: Date

addMonths(additionalMonths)

指定した追加月数を date に加算します。

署名

public Date addMonths(Integer additionalMonths)

パラメータ

additionalMonths
型: Integer

戻り値

型: Date

addYears(additionalYears)

指定した追加年数を date に加算します。

署名

public Date addYears(Integer additionalYears)

パラメータ

additionalYears
型: Integer

戻り値

型: Date

day()

date の day-of-month コンポーネントを返します。

署名

public Integer day()

戻り値

型: Integer

dayOfYear()

date の day-of-year コンポーネントを返します。

署名

public Integer dayOfYear()

戻り値

型: Integer

daysBetween(secondDate)

メソッドをコールした日付と指定された日付の間の日数を返します。

署名

public Integer daysBetween(Date secondDate)

パラメータ

secondDate
型: Date

戻り値

型: Integer

使用方法

メソッドをコールする日付が secondDate の後に発生する場合、戻り値は負になります。

daysInMonth(year, month)

指定された yearmonth の月の日数を返します (1 = 1 月)。

署名

public static Integer daysInMonth(Integer year, Integer month)

パラメータ

year
型: Integer
month
型: Integer

戻り値

型: Integer

次の例は、1960 年の 2 月の日数を検索します。

format()

コンテキストユーザのロケールを使用して、date を文字列として返します。

署名

public String format()

戻り値

型: String

isLeapYear(year)

指定した年がうるう年の場合、true を返します。

署名

public static Boolean isLeapYear(Integer year)

パラメータ

year
型: Integer

戻り値

型: Boolean

isSameDay(dateToCompare)

メソッドをコールした日付が指定された日付と同じ場合、true を返します。

署名

public Boolean isSameDay(Date dateToCompare)

パラメータ

dateToCompare
型: Date

戻り値

型: Boolean

month()

date の month コンポーネントを返します (1 =1 月)。

署名

public Integer month()

戻り値

型: Integer

monthsBetween(secondDate)

メソッドをコールした日付と指定された日付の間の月数を返します。日数の差異は無視されます。

署名

public Integer monthsBetween(Date secondDate)

パラメータ

secondDate
型: Date

戻り値

型: Integer

newInstance(year, month, day)

yearmonth (1= 1 月)、day の integer 表現から date を構築します。

署名

public static Date newInstance(Integer year, Integer month, Integer day)

パラメータ

year
型: Integer
month
型: Integer
day
型: Integer

戻り値

型: Date

次の例では、1960 年 2 月 17 日を作成します。

parse(stringDate)

string から date を構築します。string の形式は、ローカルの日付形式によって異なります。

署名

public static Date parse(String stringDate)

パラメータ

stringDate
型: String

戻り値

型: Date

次の例は、いくつかのロケールで機能します。

today()

現在の日付を現在のユーザのタイムゾーンで返します。

署名

public static Date today()

戻り値

型: Date

toStartOfMonth()

メソッドをコールした日付の月の最初の日を返します。

署名

public Date toStartOfMonth()

戻り値

型: Date

toStartOfWeek()

コンテキストユーザのロケールに応じて、メソッドをコールした日付の週の開始日を返します。

署名

public Date toStartOfWeek()

戻り値

型: Date

たとえば、アメリカのロケールでは週は日曜日に始まり、ヨーロッパでは月曜日に始まります。次に例を示します。

valueOf(stringDate)

指定した string の値を含む date を返します。

署名

public static Date valueOf(String stringDate)

パラメータ

stringDate
型: String

戻り値

型: Date

使用方法

指定した文字列は、ローカルタイムゾーンの標準の日付形式「yyyy-MM-dd HH:mm:ss」を使用する必要があります。

valueOf(fieldValue)

指定されたオブジェクトを Date に変換します。このメソッドを使用して、履歴管理項目の値または Date 値を表すオブジェクトを変換します。

署名

public static Date valueOf(Object fieldValue)

パラメータ

fieldValue
型: Object

戻り値

型: Date

使用方法

項目が date 項目の場合は、AccountHistory など、履歴 sObject の OldValue 項目または NewValue 項目でこのメソッドを使用します。

次の例では、履歴管理項目を Date 値に変換します。

バージョン管理動作の変更

Date.valueOf は、次のリリースでバージョン管理されています。
API バージョン 33.0 以前
Datetime オブジェクトを指定して Date.valueOf をコールすると、メソッドは時、分、秒、ミリ秒のセットを含む Date 値を返します。
API バージョン 34.0 ~ API バージョン 53.0
Datetime オブジェクトを指定して Date.valueOf をコールすると、メソッドは Datetime を時間の情報がない有効な Date に変換します。ただし、結果は、Datetime オブジェクトを初期化した方法によって変化します。たとえば、Datetime オブジェクトを初期化するときに Datetime.valueOf(stringDate) を使用した場合、返される Date 値には、時間 (時) の情報が含まれます。Datetime オブジェクトを初期化するときに Datetime.newInstance(year, month, day, hour, minute, second) を使用した場合、返される Date 値には、時間の情報は含まれません。
API バージョン 54.0 以降
Datetime オブジェクトを指定して Date.valueOf をコールすると、メソッドはオブジェクトを時間の情報がない有効な Date に変換します。

year()

date の year コンポーネントを返します。

署名

public Integer year()

戻り値

型: Integer